@markjaquith/agency 2.31.0 → 2.32.0

package/README.md

@@ -183,7 +183,8 @@ OpenCode and Claude Code are built-in runner presets. Select either preset or a
 configured runner with `agency work --runner <name>`. A launch is fresh unless
 `AGENCY_SESSION_ID` is already set; resumed launches use the runner's
 `resumeCommand` when configured. The built-in presets use `--continue` only for
-resumed launches.
+resumed launches. By default Agency opens the runner without a prompt. `--auto`
+uses its autonomous command and sends the generated task, phase, or epic prompt.
 
 Custom runners are direct argv commands, never shell snippets:
 
@@ -192,8 +193,10 @@ Custom runners are direct argv commands, never shell snippets:
 	"version": 2,
 	"runners": {
 		"custom": {
-			"command": ["my-agent", "--prompt", "{prompt}"],
-			"resumeCommand": ["my-agent", "resume", "{sessionId}", "{prompt}"],
+			"command": ["my-agent"],
+			"autoCommand": ["my-agent", "--prompt", "{prompt}"],
+			"resumeCommand": ["my-agent", "resume", "{sessionId}"],
+			"autoResumeCommand": ["my-agent", "resume", "{sessionId}", "{prompt}"],
 			"environment": { "MY_AGENT_TARGET": "{target}" }
 		}
 	}
@@ -202,24 +205,32 @@ Custom runners are direct argv commands, never shell snippets:
 
 Available placeholders are `{prompt}`, `{workbase}`, `{target}`, `{task}`,
 `{phase}`, `{claimant}`, `{sessionId}`, and `{claimRevision}`. Task and phase
-placeholders are empty when they do not apply. If `resumeCommand` is omitted,
-the fresh command is also used for resumed sessions.
+placeholders are empty when they do not apply. `{prompt}` is empty unless
+`--auto` is set. If `resumeCommand` is omitted, the fresh command is also used
+for resumed sessions. If `autoResumeCommand` is omitted, `autoCommand` is used;
+configured runners without `autoCommand` reject `--auto`.
 
 Every runner receives the same `AGENCY_RUNNER`, `AGENCY_CLAIMANT`,
 `AGENCY_SESSION_ID`, `AGENCY_CLAIM_REVISION`, `AGENCY_WORKBASE`, `AGENCY_TARGET`,
 `AGENCY_TASK_ID`, `AGENCY_PHASE_ID`, and `AGENCY_PROMPT` environment. Configured
 environment is added without overriding these normalized values.
+`AGENCY_CLAIM_REVISION` is empty for local `agency work` launches.
+`AGENCY_PROMPT` is empty unless `--auto` is set.
 The `opencode` runner additionally receives `OPENCODE_CONFIG` for the workbase's
 managed integration and `OPENCODE_CONFIG_CONTENT` with runtime-only,
 workbase-scoped access and edit rules. These values keep the Git-synced config
 portable while providing whole-workbase read access at every launch location.
+`AGENCY_CLAIM_REVISION` is empty for local `agency work` launches.
+`AGENCY_PROMPT` is empty unless `--auto` is set.
 `--print-command` prints the exact cwd and argv plus non-secret environment keys
 without launching the runner.
 
 ### Custom Chooser Command
 
-Interactive selection uses a native numbered chooser by default. To use an
-external chooser, configure an argv command in `agency.json`:
+Interactive selection uses an OpenTUI Solid split footer by default. Type to
+fuzzy-filter choices, use arrow keys or Ctrl-N/Ctrl-P to move, press Enter to
+select, and press Escape or Ctrl-C to cancel. To use an external chooser
+instead, configure an argv command in `agency.json`:
 
 ```json
 {
@@ -231,13 +242,14 @@ external chooser, configure an argv command in `agency.json`:
 Agency writes one `key<TAB>label` record per choice to the command's stdin. The
 command must write the selected opaque key or selected record to stdout; commands
 such as `["gum", "filter"]` therefore work without wrappers. Exit codes 1 and
-130, empty stdout, native `q`, and an empty native response cancel selection.
-Other nonzero exits, unknown keys, and invalid native numbers are errors.
+130 or empty stdout cancel external selection. Other nonzero exits and unknown
+keys are errors.
 
-Selectors are opened only when stdin and stderr are terminals and neither
-`--no-input` nor JSON output is active. Labels use color only when stderr is a
-terminal, `TERM` is not `dumb`, and `NO_COLOR` is unset; otherwise selectors use
-plain labels without ANSI styling or icon-font dependencies.
+Selectors are opened only when stdin and stdout are terminals and neither
+`--no-input` nor JSON output is active. External chooser labels use color only
+when stdout is a terminal, `TERM` is not `dumb`, and `NO_COLOR` is unset. The
+native OpenTUI selector uses plain labels without ANSI styling or icon-font
+dependencies.
 
 ## Frontmatter
 
@@ -500,8 +512,9 @@ back-reference.
 
 ### Tasks
 
-Create a task interactively. Text prompts identify optional values, and known
-choices use fzf. This command requires a TTY and fails with `--no-input`:
+Create a task interactively with the OpenTUI Solid footer. When exactly one
+repository is available, Agency selects it without presenting a redundant
+choice. This command requires a TTY and fails with `--no-input`:
 
 ```text
 agency task new [id]
@@ -606,12 +619,13 @@ writing anything.
 
 Single-phase tasks and phases store status in YAML. New execution units start
 `open`, and `agency work` marks the selected execution unit `working` immediately
-before launch. Use claims for coordinated ownership and the status subcommands
-for manual lifecycle overrides. The interactive work selector displays status
-markers before execution units. Existing working and delegated work may be
-released to `open` or assigned a terminal outcome. Done and dropped work are
-terminal and may only remain unchanged or transition to open; reopen terminal
-work before changing its outcome.
+before launch. Running `agency work` again can relaunch unclaimed `working` work.
+Use explicit claims only when an external orchestrator needs coordinated
+ownership. The interactive work selector displays status markers before
+execution units. Existing working and delegated work may be released to `open`
+or assigned a terminal outcome. Done and dropped work are terminal and may only
+remain unchanged or transition to open; reopen terminal work before changing its
+outcome.
 
 `delegated` remains readable for existing workbases but cannot be newly assigned.
 Delegation is now explicit: the claimant identifies the orchestrator and the
@@ -645,11 +659,10 @@ frontmatter. Conflicts return the current revision and complete ownership record
 in the machine error envelope rather than overwriting it. Expired claims may be
 replaced with a revision-guarded claim.
 
-`agency work` claims an execution unit before launching its agent. Set
-`AGENCY_CLAIMANT`, `AGENCY_RUNNER`, or `AGENCY_SESSION_ID` to supply orchestrator
-identities; otherwise Agency derives them from the user and process. The selected
-runner name is recorded on the claim. The launched agent receives the normalized
-runner environment documented above for a later release or finish operation.
+`agency work` does not claim execution units. It refuses active explicit claims,
+marks open execution work `working`, and launches the runner. External
+orchestrators use `agency claim`, launch and monitor their runner separately, and
+later call `agency release` or `agency finish`.
 
 ### Archive
 
@@ -676,21 +689,21 @@ for restoration. Archived IDs are reserved until restored.
 ### Work and Pull Requests
 
 ```text
-agency work [<directory> | --epic <epic-id>] [--runner <name>] [--print-command]
+agency work [<directory> | --epic <epic-id>] [--runner <name>] [--auto] [--print-command]
 agency work prepare [target] [--dry-run] [--json]
 agency worktree <list|inspect|prepare|remove|rebuild|repair>
 agency pr create <task-id> [phase-id] [--draft] [--json]
 ```
 
-`agency work` presents the full hierarchy in `fzf`. Pass a directory, including
-`.` for the current directory, to infer its epic, task, or phase. Outside a
-workbase, Agency first presents the registered workbases, then the selected
-workbase's hierarchy. If `fzf` is not installed, Agency prints the available
-choices and asks for an explicit directory.
+`agency work` presents the full hierarchy in the native OpenTUI selector or the
+configured external chooser. Pass a directory, including `.` for the current
+directory, to infer its epic, task, or phase. Outside a workbase, Agency first
+presents the registered workbases, then the selected workbase's hierarchy.
 
 OpenCode is the default runner, with automatic Claude fallback when neither is
 explicitly selected. `--opencode` and `--claude` remain aliases for requiring
-their built-in presets.
+their built-in presets. Launches are interactive and promptless by default; use
+`--auto` to send Agency's generated context prompt.
 
 `agency work prepare` resolves an execution unit and creates or reuses its
 writable and reference worktrees without launching an agent or changing status.
@@ -707,11 +720,10 @@ conflicting worktrees. Repair is deliberately conservative: it repairs safe Git
 registration issues and materializes missing checkouts, but never switches a
 branch, resets a commit, or discards uncommitted work.
 
-Epic and multi-phase task targets launch orchestration agents beside their
-documents. Single-phase tasks and phases fetch repositories, create or reuse
-worktrees under `code/`, and launch an execution agent in the writable checkout
-with absolute context paths. An explicit directory or `--epic` target bypasses
-the hierarchy chooser.
+Agency launches every agent beside its epic or task document. Single-phase tasks
+and phases first fetch repositories and create or reuse worktrees under `code/`,
+then launch the execution agent from the task directory with absolute context
+paths. An explicit directory or `--epic` target bypasses the hierarchy chooser.
 
 Each writable `(repo, branch)` pair may belong to only one task or phase. Agency
 validation reports duplicate ownership, and `agency work` checks Git's worktree

package/cli.ts

@@ -478,6 +478,7 @@ const commands: Record<string, Command> = {
 					opencode: options.opencode,
 					claude: options.claude,
 					runner: options.runner,
+					auto: options.auto,
 					printCommand: options["print-command"],
 					force: options.force,
 					inputAllowed: options.inputAllowed,
@@ -720,7 +721,7 @@ try {
 	const inputAllowed =
 		!values.json &&
 		!values["no-input"] &&
-		Boolean(process.stdin.isTTY && process.stderr.isTTY)
+		Boolean(process.stdin.isTTY && process.stdout.isTTY)
 	const cwd = await resolveInvocationCwd(commandName, values)
 	if (values.json || (values.jsonl && values.help)) {
 		const result = await collectCommandResult(() =>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "2.31.0",
+  "version": "2.32.0",
   "description": "Manage agentic work across repositories with durable workbases",
   "keywords": [
     "agents",
@@ -58,7 +58,7 @@
     "tag": "latest"
   },
   "scripts": {
-    "test": "find src -name '*.test.ts' -print0 | xargs -0 -n 1 -P 4 bun test",
+    "test": "find src \\( -name '*.test.ts' -o -name '*.test.tsx' \\) -print0 | xargs -0 -n 1 -P 4 bun test",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
     "knip": "knip --production",
@@ -68,7 +68,10 @@
   },
   "dependencies": {
     "@effect/schema": "^0.75.5",
+    "@opentui/core": "0.4.5",
+    "@opentui/solid": "0.4.5",
     "effect": "^3.19.15",
+    "solid-js": "1.9.12",
     "yaml": "^2.9.0"
   },
   "devDependencies": {

package/skills/agency/SKILL.md

@@ -102,8 +102,8 @@ independently meaningful tasks need coordination.
 2. Confirm `target`, `graph.readiness`, `authority`, `workspace`, and `validation`.
 3. Read the returned task and phase document paths for prose requirements.
 4. Stop on validation errors, dependency blockers, an unexpected writable
-   repository, or a conflicting active owner. For an active agent, a `working`
-   status blocker is expected only when the current session owns the claim.
+   repository, or a conflicting active owner. A local `agency work` launch has
+   no claim; an externally assigned agent must own the active claim.
 
 ### Work
 
@@ -129,9 +129,10 @@ independently meaningful tasks need coordination.
 
 `agency work` is a human/orchestrator launch flow. It first reconciles managed
 integration files, then selects work and checks readiness. For an execution unit,
-it materializes managed checkouts, claims the unit, marks it working, and starts
+it materializes managed checkouts, marks it working without a claim, and starts
 the selected built-in or configured runner. Epic and multi-phase task launches
-start in orchestration context without materializing or claiming execution work.
+start in orchestration context without materializing execution work. The runner
+opens without a prompt unless the human explicitly selects `--auto`.
 OpenCode launches expose the managed config file and inject runtime-only access
 rules scoped to the workbase. These grant visibility from orchestration
 directories and nested execution checkouts while denying direct edits outside
@@ -140,8 +141,8 @@ or replace write authority from `agency context`.
 
 An agent already running in an Agency checkout must not call `agency work` to
 start itself again. It should inspect context, perform the assigned work, and
-finish or release its existing claim. Launch a nested or replacement agent only
-when the user explicitly asks.
+finish its claim or update unclaimed status directly. Launch a nested or
+replacement agent only when the user explicitly asks.
 
 Use [`references/recipes.md`](references/recipes.md) for human setup, agent
 execution, claim, PR, conversion, and recovery workflows. Use

package/skills/agency/references/commands.md

@@ -109,8 +109,9 @@ agency phase dependency <add|remove> <task-id> <phase-id> <dependency-id>
   [--if-revision <hash>] [--json]
 ```
 
-`task new` is interactive and requires a TTY. Agents and scripts use
-noninteractive `task create`. Mutation commands that accept `--if-revision`
+`task new` uses the OpenTUI Solid footer and requires a TTY. A sole repository is
+selected automatically. Agents and scripts use noninteractive `task create`.
+Mutation commands that accept `--if-revision`
 return a revision conflict instead of overwriting changed documents.
 
 ## Ownership And Lifecycle
@@ -143,7 +144,7 @@ worktrees when needed, preserve branches, and retain lifecycle provenance.
 
 ```text
 agency work [<directory-or-task-id> | --epic <id> | --task <id> [--phase <id>]]
-  [--runner <name> | --opencode | --claude] [--print-command] [--force]
+  [--runner <name> | --opencode | --claude] [--auto] [--print-command] [--force]
 agency work prepare [target] [--dry-run] [--json]
 agency worktree list [--json]
 agency worktree inspect <task-id> [phase-id] [--json]
@@ -154,17 +155,19 @@ agency worktree repair <task-id> [phase-id] [--dry-run] [--json]
 agency pr create <task-id> [phase-id] [--draft] [--force] [--json]
 ```
 
-`work` is a launch flow, not an active-agent step. It synchronizes managed
-integration files before launch. Execution targets are materialized and claimed;
-epics and multi-phase tasks launch in orchestration context without those steps.
+`work` is a local launch flow, not an active-agent step. It synchronizes managed
+integration files before launch. Execution targets are materialized and marked
+working without a claim; epics and multi-phase tasks launch in orchestration
+context without those steps. Unclaimed working targets can be launched again.
+The runner opens without a generated prompt unless `--auto` is set.
 The OpenCode runner receives a runtime managed-config path plus absolute access
 and edit rules scoped to the workbase; none are persisted, and `context` still
 defines write authority.
-`--print-command` suppresses only the final launch, so execution targets are still
-materialized and claimed before the command is printed. `work prepare`
-materializes without launching or changing status. Destructive remove and
-rebuild operations refuse dirty or conflicting state. Conservative repair may
-correct registration while preserving dirty files, but never discards changes.
+`--print-command` materializes execution targets but does not launch or change
+status. `work prepare` materializes without launching or changing status.
+Destructive remove and rebuild operations refuse dirty or conflicting state.
+Conservative repair may correct registration while preserving dirty files, but
+never discards changes.
 `pr create` materializes a missing workspace, requires the resulting writable
 checkout to be clean, pushes the declared branch, invokes the configured delivery
 provider or falls back to `gh pr create --fill`, and records the returned pull
@@ -178,6 +181,6 @@ perform cwd inference elsewhere. Targeted commands accept `--epic`, `--task`,
 and, with a task, `--phase`. `--json`, `--no-input`, or non-TTY execution disables
 prompts; provide all selectors and required inputs explicitly.
 
-Selectors are only a resolution mechanism; they do not make discovery and claim
-atomic. There is no `assign` command. Use `work` for a local human launch, or use
-`claim` and manage an external runner separately.
+Selectors are only a resolution mechanism. There is no `assign` command. Use
+`work` for a local human launch, or use `claim` and manage an external runner
+separately.

package/skills/agency/references/contracts.md

@@ -299,11 +299,10 @@ node set.
   and `claim` does not enforce dependency readiness. Inspect readiness, then
   claim with the observed revision and handle conflicts.
 - There is no `assign` command, remote queue, scheduler, heartbeat, claim renewal,
-  runner monitor, or cancellation API. For an execution unit, `work` can claim
-  and launch one local built-in or configured runner, but it is a
-  process-launching, non-JSON flow rather than a machine assignment API. External
-  orchestrators claim with claimant and runner IDs, then manage their runner
-  themselves.
+  runner monitor, or cancellation API. `work` launches one local built-in or
+  configured runner without a claim; it is a process-launching, non-JSON flow
+  rather than a machine assignment API. External orchestrators claim with
+  claimant and runner IDs, then manage their runner themselves.
 - Agency does not edit code, create commits, run repository checks, wait for PR
   checks, merge PRs, or verify that a requested completion condition is true.
   `finish` records the caller's asserted outcome after ownership checks.

package/skills/agency/references/recipes.md

@@ -88,10 +88,13 @@ agency work tasks/checkout/phases/api
 ```
 
 `agency work` is intentionally last: it synchronizes managed integration files,
-checks readiness, materializes worktrees, creates a claim, marks this execution
-unit working, and launches the runner. OpenCode receives whole-workbase read
-visibility through runtime-only config and permission values; this does not
-expand the writable checkout reported by `agency context`.
+checks readiness, materializes worktrees, marks this execution unit working
+without a claim, and launches the runner. Run it again to relaunch unclaimed
+working work. The runner opens without a prompt by default; add `--auto` only
+when the generated context prompt should start autonomous execution.
+OpenCode receives whole-workbase read visibility through runtime-only config and
+permission values; this does not expand the writable checkout reported by
+`agency context`.
 
 ## Active Agent: Execute Assigned Work
 
@@ -99,10 +102,9 @@ expand the writable checkout reported by `agency context`.
 agency context . --json
 ```
 
-1. Verify context reports the expected execution target, valid structure, the
-   current checkout as `authority.writable.checkoutPath`, and a claim owned by
-   the current session. Reject dependency or validation blockers and conflicting
-   claims; the owned unit's `working` status blocker is expected.
+1. Verify context reports the expected execution target, valid structure, and
+   the current checkout as `authority.writable.checkoutPath`. Reject dependency
+   or validation blockers and conflicting active claims.
 2. Read `TASK.md`, and `PHASE.md` for phase work.
 3. Implement only in the writable checkout; treat all reference checkouts as
    read-only.
@@ -110,7 +112,8 @@ agency context . --json
 5. Review and commit the diff.
 6. If requested, run `agency validate`, then
    `agency pr create <task-id> [phase-id]`.
-7. Finish the current claim only after its completion condition is true.
+7. Finish an active claim after its completion condition is true; otherwise set
+   the task or phase status directly.
 
 Never invoke `agency work` merely because an execution checkout already exists;
 that would start another agent rather than continue the current assignment.
@@ -145,7 +148,7 @@ worktrees manually.
 ## Assign A Runner
 
 For a human-operated local launch, Agency combines readiness checks, prepare,
-claim, status mutation, and runner launch:
+status mutation, and runner launch without creating a claim:
 
 ```bash
 agency work tasks/checkout/phases/ui --runner opencode

package/src/cli-parser.test.ts

@@ -453,11 +453,18 @@ describe("strict CLI parsing", () => {
 
 	test("accepts runner selection and command inspection for work", () => {
 		expect(
-			parseCli(["work", "example", "--runner", "custom", "--print-command"]),
+			parseCli([
+				"work",
+				"example",
+				"--runner",
+				"custom",
+				"--auto",
+				"--print-command",
+			]),
 		).toMatchObject({
 			commandName: "work",
 			args: ["example"],
-			values: { runner: "custom", "print-command": true },
+			values: { runner: "custom", auto: true, "print-command": true },
 		})
 		expect(() =>
 			parseCli(["work", "example", "--runner", "custom", "--claude"]),
@@ -465,6 +472,9 @@ describe("strict CLI parsing", () => {
 		expect(() => parseCli(["work", "prepare", "--print-command"])).toThrow(
 			"cannot be combined",
 		)
+		expect(() => parseCli(["work", "prepare", "--auto"])).toThrow(
+			"cannot be combined",
+		)
 	})
 
 	test("accepts repeatable graph filters and rejects output conflicts", () => {

package/src/cli-parser.ts

@@ -740,13 +740,14 @@ const commands = {
 	},
 	work: {
 		usage:
-			"agency work [<directory-or-task-id> | --epic <epic-id>] [--runner <name>] | agency work prepare [target] [--dry-run] [--json]",
+			"agency work [<directory-or-task-id> | --epic <epic-id>] [--runner <name>] [--auto] | agency work prepare [target] [--dry-run] [--json]",
 		options: {
 			...commonOptions,
 			...entitySelectorOptions,
 			json: { type: "boolean" },
 			"dry-run": { type: "boolean" },
 			runner: { type: "string" },
+			auto: { type: "boolean" },
 			"print-command": { type: "boolean" },
 			opencode: { type: "boolean" },
 			claude: { type: "boolean" },
@@ -754,7 +755,7 @@ const commands = {
 		},
 		command: {
 			usage:
-				"agency work [<directory-or-task-id> | --epic <epic-id>] [--runner <name>] | agency work prepare [target] [--dry-run] [--json]",
+				"agency work [<directory-or-task-id> | --epic <epic-id>] [--runner <name>] [--auto] | agency work prepare [target] [--dry-run] [--json]",
 			minArgs: 0,
 			maxArgs: 2,
 			options: [
@@ -764,6 +765,7 @@ const commands = {
 				"task",
 				"phase",
 				"runner",
+				"auto",
 				"print-command",
 				"opencode",
 				"claude",
@@ -1361,6 +1363,7 @@ export function parseCli(args: readonly string[]): ParsedCli {
 					parsed.values.opencode ||
 					parsed.values.claude ||
 					parsed.values.runner ||
+					parsed.values.auto ||
 					parsed.values["print-command"] ||
 					parsed.values.force))
 		) {

package/src/cli.test.ts

@@ -1,6 +1,6 @@
 import { afterAll, afterEach, describe, expect, test } from "bun:test"
 import { access, mkdir, realpath } from "node:fs/promises"
-import { join } from "node:path"
+import { join, relative } from "node:path"
 import errorFixture from "../fixtures/protocol/error.json"
 import successFixture from "../fixtures/protocol/success.json"
 import { cleanupTempDir, createTempDir } from "./test-utils"
@@ -92,8 +92,15 @@ async function startGitDaemon(basePath: string) {
 
 describe("CLI", () => {
 	const tempDirs: string[] = []
+	const daemons: Bun.Subprocess[] = []
 
 	afterEach(async () => {
+		await Promise.all(
+			daemons.splice(0).map(async (daemon) => {
+				daemon.kill()
+				await daemon.exited
+			}),
+		)
 		await Promise.all(tempDirs.splice(0).map(cleanupTempDir))
 	})
 
@@ -445,7 +452,7 @@ describe("CLI", () => {
 
 		const after = await runCli(["status", "--silent"], root)
 		expect(after).toEqual({ exitCode: 0, stdout: "", stderr: "" })
-	}, 10_000)
+	}, 30_000)
 
 	test("lists ready work and exposes excluded blockers through one result", async () => {
 		const root = await createTempDir()
@@ -632,7 +639,7 @@ describe("CLI", () => {
 		expect(JSON.parse(explicitOutside.stdout).error.message).toContain(
 			"No Agency workbase found from",
 		)
-	})
+	}, 20_000)
 
 	test("exports equivalent JSON and JSONL graph contracts", async () => {
 		const root = await createTempDir()
@@ -849,6 +856,10 @@ status: open
 			]) {
 				expect(Bun.spawnSync(["git", "-C", source, ...args]).exitCode).toBe(0)
 			}
+			await runGit(["clone", "--bare", source, join(parent, "source.git")])
+			const daemon = await startGitDaemon(parent)
+			daemons.push(daemon.process)
+			await runGit(["-C", source, "remote", "add", "origin", daemon.remote])
 
 			parseJson(await runCli(["init", root, "--json"], parent))
 			parseJson(
@@ -959,23 +970,23 @@ status: open
 			const launches = [
 				{
 					args: ["--task", "example"],
-					cwd: taskWorkspace.writablePath,
-					writable: true,
+					cwd: join(workbaseRoot, "tasks/example"),
+					writable: taskWorkspace.writablePath,
 				},
 				{
 					args: ["--task", "pipeline", "--phase", "build"],
-					cwd: phaseWorkspace.writablePath,
-					writable: true,
+					cwd: join(workbaseRoot, "tasks/pipeline"),
+					writable: phaseWorkspace.writablePath,
 				},
 				{
 					args: ["--epic", "delivery"],
 					cwd: join(workbaseRoot, "epics/delivery"),
-					writable: false,
+					writable: null,
 				},
 				{
 					args: ["--task", "pipeline"],
 					cwd: join(workbaseRoot, "tasks/pipeline"),
-					writable: false,
+					writable: null,
 				},
 			]
 			for (const launch of launches) {
@@ -1015,11 +1026,24 @@ status: open
 					expect.arrayContaining([
 						expect.objectContaining({
 							permission: "edit",
-							pattern: launch.writable ? "../**" : "*",
+							pattern: "*",
 							action: "deny",
 						}),
 					]),
 				)
+				if (launch.writable) {
+					expect(agent.permission).toEqual(
+						expect.arrayContaining(
+							[workbaseRoot, launch.cwd].map((base) =>
+								expect.objectContaining({
+									permission: "edit",
+									pattern: join(relative(base, launch.writable!), "**"),
+									action: "allow",
+								}),
+							),
+						),
+					)
+				}
 
 				if (launch === launches[0]) {
 					for (const document of documents) {

package/src/commands/doctor.test.ts

@@ -39,7 +39,12 @@ describe("doctor command", () => {
 			"agency.json",
 			JSON.stringify({
 				version: 2,
-				runners: { missing: { command: ["definitely-not-installed"] } },
+				runners: {
+					missing: {
+						command: ["definitely-not-installed"],
+						autoCommand: ["also-not-installed", "{prompt}"],
+					},
+				},
 			}),
 		)
 		await mkdir(join(root, "repos"), { recursive: true })
@@ -86,6 +91,11 @@ status: open
 					level: "error",
 					status: "fail",
 				}),
+				expect.objectContaining({
+					id: "integration.runner.missing.auto",
+					level: "error",
+					status: "fail",
+				}),
 				expect.objectContaining({
 					id: "ref.agency.main",
 					status: "pass",

package/src/commands/phase.ts

@@ -259,7 +259,7 @@ Subcommands:
   list <task>           List task phases
   show <task> <phase>   Show a phase
   status <task> <phase> <status>
-                        Set open, done, or dropped
+                        Set open, working, done, or dropped
   update <task> <phase> Update phase metadata
   rename <task> <phase> <new-id>
                         Rename a phase and update dependencies

package/src/commands/task.test.ts

@@ -61,10 +61,43 @@ describe("task creation input", () => {
 			"Description (optional): ",
 			"Parent epic: (none),delivery",
 			"Task type: single-phase,multi-phase",
-			"Writable repository: agency",
 		])
 	})
 
+	test("asks for a repository only when more than one is available", async () => {
+		await mkdir(join(root, "repos/web"), { recursive: true })
+		const prompts: string[] = []
+		const interaction: TaskInteraction = {
+			text: () => Effect.fail(new Error("unexpected text prompt")),
+			select: (prompt, choices) => {
+				prompts.push(`${prompt}: ${choices.join(",")}`)
+				return Effect.succeed(prompt === "Task type" ? "single-phase" : "web")
+			},
+		}
+
+		await runTestEffect(
+			task(
+				{
+					subcommand: "new",
+					args: ["multi-repo"],
+					ticketUrl: "",
+					description: "",
+					cwd: root,
+					silent: true,
+				},
+				interaction,
+			),
+		)
+
+		expect(prompts).toEqual([
+			"Task type: single-phase,multi-phase",
+			"Writable repository: agency,web",
+		])
+		expect(
+			await Bun.file(join(root, "tasks/multi-repo/TASK.md")).text(),
+		).toContain("repo: web")
+	})
+
 	test("keeps scripted creation non-interactive and permits no ticket URL", async () => {
 		const interaction: TaskInteraction = {
 			text: () => Effect.fail(new Error("unexpected text prompt")),