> ## Documentation Index
> Fetch the complete documentation index at: https://checkfu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Coding orchestrator

> Many concurrent workspaces over one repository, with no app-side git.

A conductor-shaped orchestrator: one repository, many concurrent workspaces, each from its own base ref and each ending in its own pull request — and an app that never runs `git`, never talks to a forge directly, and never reconstructs a file.

Source: `examples/coding-orchestrator` in the repository. The index at `examples/README.md` compares all eight side by side.

## Golden journeys

* Connect a repository and spin up workspaces from chosen base refs
* Watch and steer a running workspace
* Ship a pull request, then keep answering review comments on it
* Share a workspace with a teammate whose writes are attributed to them

## Platform surfaces exercised

Projects and branches, Connections and `use_connection` PermissionAssignments, Sessions, coordinator threads and attribution, capability support.

## Before it can run

The example's README carries the five-minute path. Two prerequisites are not the app's to satisfy and are stated there rather than assumed:

* **A `use_connection` PermissionAssignment.** A Git Project resolves through its Connection, and the acting Principal must both own it and hold `use_connection` — see [Projects](/concepts/projects). The example mints the PermissionAssignment when a repository is connected.
* **A repository webhook at the provider**, pointing at Checkfu's signature-verifying Watch ingress and registered by whoever operates the deployment. The example receives no webhook and relays no webhook content: the wake carries identifiers only and re-reads the provider fresh.

## From the source

The whole orchestration surface the app is allowed to have — note that nothing here exposes a file, a diff, or a git command:

```ts path=examples/coding-orchestrator/server/src/checkfu-runtime.ts theme={"theme":{"light":"github-light","dark":"github-dark"}}
interface PendingConnection {
	readonly connectionId: string
	readonly connectUrl: string
}

export interface OrchestratorRuntime {
	readonly beginRepositoryConnect: (draft: RepositoryDraft) => Promise<PendingConnection>
	readonly completeRepositoryConnect: (connectionId: string) => Promise<RepositoryCard>
	readonly createWorkspace: (draft: WorkspaceDraft) => Promise<WorkspaceCard>
	readonly listBaseRefs: (projectId: string) => Promise<ReadonlyArray<string>>
	readonly projectBoard: () => Promise<ReadonlyArray<WorkspaceCard>>
	readonly archiveWorkspace: (environmentId: string) => Promise<WorkspaceCard | null>
	readonly steerWorkspace: (
		environmentId: string,
		message: string,
		actingPrincipalId?: string,
	) => Promise<void>
	readonly mintObservePermissionAssignment: (
```

This block is quoted from the file, not retyped: `pnpm agent-docs:check` fails if it drifts.

## Honest gaps

Recorded in `examples/coding-orchestrator/README.md`. Counts are deliberately not repeated here — they differ per tree, and `examples/README.md` carries them with the sha they were measured at.