spacedock

Spacedock

Spacedock runs agent work through defined stages, so you can delegate in batches and make only the calls that need your judgment.

The first officer coordinates the flow: it dispatches workers to advance each work item and surfaces approval-worthy decisions to you, the captain, so batches move forward without pulling you into every session.

You want Spacedock if:

• You're a human tired of context-switching between agent sessions to make approval decisions. Spacedock batches the decisions an agent wants to hand back to you and presents each with evidence, so you approve or redirect without re-loading context.
• You're an agent delegating repeatable work and want a structured place to queue up approval-worthy decisions for your human without interrupting them for every tiny step.

What's Different

• Approval gates with structured evidence. Every gate comes with a stage report: findings, verdicts, artifacts, anomalies. You approve, redirect, or bounce back faster than sifting through raw output or a sprawling log.
• Adversarial review gates. Review stages can be configured to push back rather than rubber-stamp. They target sycophancy, thin evidence, and work that looks busy without proving its claim. Work clears the gate when it survives the challenge.
• Plan in batches, decide as work flows back. Queue multiple work items at once; agents advance each through its stages independently while you handle approvals as they surface.
• The workflow learns with you. The first officer helps you adjust it when patterns emerge: a stage that never fires, a gate that keeps bouncing the same issue back, a schema field that always ends up empty.
• Isolation when needed. Stages that touch shared state run in their own git worktree; lightweight stages run inline. You declare which is which, and the first officer enforces it.
• Work doesn't die at the context limit. When an agent runs out of context, Spacedock swaps in a successor that carries forward what's in flight. Nothing gets lost in the handoff.

Quick Start

Prerequisites: Claude Code or Codex CLI.

Claude Code

1. Install the plugin:

   claude plugin marketplace add clkao/spacedock && claude plugin install spacedock
   

2. Commission a workflow with your own mission prompt:

   claude --agent spacedock:first-officer "/commission <your mission prompt>"
   

3. Or start from one of these example workflows — copy and run:

   Email triage:

   claude --agent spacedock:first-officer "/commission Email triage: fetch, categorize, and act on Gmail inbox. Entity: a batch of up to 50 emails. Stages: intake (use gws-cli, triage in:inbox and read email body if necessary, categorize, propose action per email, output as table) → approval (Captain reviews proposal) -> execute (carry out approved actions, do not mark as read). Use gws-cli (https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail), GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws/<account> for different accounts. Walk me through gws-cli setup if not already done."
   

   Superpowers-style dev task workflow:

   claude --agent spacedock:first-officer "/commission Dev task workflow: superpowers-style design → plan → implement → review with ## Design and ## Implementation Plan inlined in the entity body (no separate spec/plan files), implement on isolated worktrees with strict TDD, design and review gated for approval."
   

Codex CLI

1. Clone Spacedock and start Codex from the repo root:

   git clone https://github.com/clkao/spacedock.git /path/to/spacedock
   cd /path/to/spacedock
   codex --enable multi_agent
   

2. Restart Codex if it was already open, then open /plugins and install Spacedock from the repo-local marketplace entry.

   The authoritative Codex plugin manifest is .codex-plugin/plugin.json, and the authoritative local catalog is .agents/plugins/marketplace.json. That catalog points to ./plugins/spacedock, which is a checked-in symlink to the repository root so Codex loads the real plugin package directly.

3. Prompt Codex to use the first-officer skill and commission your workflow:

   Use the spacedock:first-officer skill to run /commission <your mission prompt> in this directory.
   

   Legacy compatibility: older Codex setups can still expose ~/.agents/skills/spacedock directly:

   mkdir -p ~/.agents/skills
   ln -s /path/to/spacedock/skills ~/.agents/skills/spacedock
   

   The .claude-plugin/plugin.json and .claude-plugin/marketplace.json files remain synchronized legacy mirrors of the Codex-first metadata for migration compatibility.

Codex multi-agent is experimental. The Claude Code path is the primary supported surface.

Supported models