Codex Symphony

Use this skill when the user wants to install or operate a local OpenAI Symphony setup for a repository.

When to Use

Use this skill when the user asks to:

• install Symphony into a repo
• restart Symphony after reopening Codex
• add a reusable codex-symphony command
• bootstrap Linear-driven agent orchestration
• create a portable Symphony package for another machine or repo
• diagnose why Symphony is not starting
• initialize repo-local Symphony env files safely

Core Rule

Do not assume a fixed repository path.

Always resolve the target repo by:

1. explicit argument, if the user gave one
2. git rev-parse --show-toplevel, if running inside a repo
3. otherwise ask for the repo path

Install

Run the bundled installer:

bash scripts/install.sh [optional-repo-path]

The installer will:

• copy WORKFLOW.symphony.md
• copy scripts/symphony/*
• copy .env.symphony.example
• enable ./scripts/symphony/init.sh for .env.symphony.local
• enable ./scripts/symphony/doctor.sh for readiness checks
• append .symphony/ to .gitignore if missing
• install ~/.local/bin/codex-symphony
• link this skill into ~/.codex/skills/codex-symphony

Operate

After install, the normal commands are:

./scripts/symphony/init.sh
./scripts/symphony/doctor.sh
codex-symphony
./scripts/symphony/logs.sh
./scripts/symphony/restart.sh
./scripts/symphony/start-background.sh
./scripts/symphony/status.sh
./scripts/symphony/stop.sh

Required Env

The target repo must provide:

• LINEAR_API_KEY
• LINEAR_PROJECT_SLUG
• SOURCE_REPO_URL
• SYMPHONY_WORKSPACE_ROOT

Optional:

• GH_TOKEN
• SYMPHONY_PORT

Expected Help Pattern

When helping the user:

1. run the installer if the repo is not bootstrapped yet
2. prefer ./scripts/symphony/init.sh over manual env editing
3. run ./scripts/symphony/doctor.sh before starting if setup looks incomplete
4. tell the user which env vars or tools are still missing
5. start Symphony only after the repo is configured
6. report dashboard URL and log path only