About

Imported from citedy/codex-symphony (SKILL.md). Install upstream with npx skills add citedy/codex-symphony. Copyright stays with the author.

Codex Symphony

Name: codex-symphony
Author: citedy

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:

explicit argument, if the user gave one
git rev-parse --show-toplevel, if running inside a repo
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:

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/citedy-codex-symphony-codex-symphony/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

citedy-codex-symphony-codex-symphony.ocm.jsonjson

{
  "ocm": "1",
  "id": "citedy-codex-symphony-codex-symphony",
  "kind": "skill",
  "name": "codex-symphony",
  "description": "Install and operate a portable OpenAI Symphony + Linear orchestration setup in any Git repository. Use when the user wants a one-command local Symphony runner, a reusable WORKFLOW template, background launch scripts, or a Codex wrapper that restarts Symphony automatically when reopening the CLI.",
  "publisher": "citedy",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "symphony",
      "codex",
      "linear",
      "orchestration",
      "automation",
      "developer-tools",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Install and operate a portable OpenAI Symphony + Linear orchestration setup in any Git repository. Use when the user wants a one-command local Symphony runner, a reusable WORKFLOW template, background launch scripts, or a Codex wrapper that restarts Symphony automatically when reopening the CLI."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/citedy/codex-symphony",
      "path": "SKILL.md",
      "ref": "b2738de786c17066c3902c65819f8054ce3a28a8",
      "url": "https://github.com/citedy/codex-symphony/blob/b2738de786c17066c3902c65819f8054ce3a28a8/SKILL.md",
      "key": "citedy/codex-symphony/SKILL.md"
    }
  },
  "instructions": "# Codex Symphony\n\nUse this skill when the user wants to install or operate a local OpenAI Symphony setup for a repository.\n\n## When to Use\n\nUse this skill when the user asks to:\n\n- install Symphony into a repo\n- restart Symphony after reopening Codex\n- add a reusable `codex-symphony` command\n- bootstrap Linear-driven agent orchestration\n- create a portable Symphony package for another machine or repo\n- diagnose why Symphony is not starting\n- initialize repo-local Symphony env files safely\n\n## Core Rule\n\nDo not assume a fixed repository path.\n\nAlways resolve the target repo by:\n\n1. explicit arg",
  "cost": {
    "context_tokens": 519
  }
}

Fetch it by URL: GET /api/v1/registry/citedy-codex-symphony-codex-symphony/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.