# Codex Symphony

> >

- **Type:** Skill
- **Install:** `agentstack add skill-citedy-skills-codex-symphony`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [citedy](https://agentstack.voostack.com/s/citedy)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [citedy](https://github.com/citedy)
- **Source:** https://github.com/citedy/skills/tree/main/skills/codex-symphony

## Install

```sh
agentstack add skill-citedy-skills-codex-symphony
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
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:

```bash
./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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [citedy](https://github.com/citedy)
- **Source:** [citedy/skills](https://github.com/citedy/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-citedy-skills-codex-symphony
- Seller: https://agentstack.voostack.com/s/citedy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.