setup

/volley:setup

One-time installation of the Volley workflow.

Steps for Claude

1. Verify Codex is installed.

   • Run: codex --version — must succeed and print a version >= 0.129.
   • We do NOT run an explicit codex login probe here; the exact auth-status subcommand varies by Codex CLI version and a missing/wrong subcommand could falsely report "not logged in." Instead, the MCP smoke test in step 4 will surface auth errors clearly when the bridge tries to call Codex. If the smoke test fails with an auth error, instruct the user to run codex login and retry.

2. Confirm the bundled Codex MCP server is reachable.

   • Volley bundles the Codex MCP server (see the plugin's .mcp.json); you do NOT write a project .mcp.json.
   • Check whether the mcp__codex__codex tool is available in this session.
   • If it is NOT available, the plugin was just installed and its MCP server has not loaded yet. Tell the user: "Run /reload-plugins (or restart Claude Code) so Volley's bundled Codex server loads, then re-run /volley:setup." (Confirm the exact reload command against this Claude Code version if /reload-plugins is not recognized.) Then STOP - do not continue until the tool is reachable.
   • If it IS available, continue.

3. Scaffold .volley/.

   • Create directory: mkdir -p .volley
   • Copy template: cp "${CLAUDE_PLUGIN_ROOT}/scripts/templates/HANDOFF.md" .volley/HANDOFF.md (only if .volley/HANDOFF.md doesn't already exist - never overwrite)
   • Copy the managed checkpoint: cp "${CLAUDE_PLUGIN_ROOT}/scripts/templates/CHECKPOINT.md" .volley/CHECKPOINT.md (only if it doesn't already exist - never overwrite; this is the Volley-managed cross-agent state file, distinct from the user-owned HANDOFF.md).
   • Copy the project config only if absent (never overwrite - the user may have customized it): cp "${CLAUDE_PLUGIN_ROOT}/scripts/templates/config.json" .volley/config.json. An absent config.json means "today's default behavior"; the scaffolded defaults (model: inherit, no required context files) reproduce that.
   • Copy gitignore: cp "${CLAUDE_PLUGIN_ROOT}/scripts/templates/gitignore" .volley/.gitignore (overwrite OK; this is internal).
   • Initialize STATE:

     . "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh" && volley_state_write .volley/STATE claude idle 0
     

   • Write machine-local state .volley/local.json with this repo's identity (gitignored - never committed). Derive identity with the lib helpers and write the JSON yourself (host-parsed - no jq):

     . "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh"
     ROOT=$(volley_repo_root); REMOTE=$(volley_repo_remote)
     echo "root=$ROOT remote=$REMOTE"
     

     Then create .volley/local.json (only if absent) as:

     { "version": 1,
       "repository": { "canonicalRoot": "<ROOT>", "remote": "<REMOTE>" },
       "modelOverrides": { "review": null, "implementation": null },
       "roles": {} }