@synergy-hq/cli
v0.3.1
Published
Localhost spec-review and agent-orchestration tool for AI coding workflows. Auto-syncs your in-browser feedback into Claude Code, Codex CLI, and Cursor.
Maintainers
Readme
@synergy-hq/cli
The CLI for synergy — a localhost spec-review and agent-orchestration tool for AI coding workflows.
npx @synergy-hq/cli init
npx @synergy-hq/cli spec ./plan.mdWhat it does
Scaffolds synergy into your project, starts review sessions from markdown specs, and routes in-browser feedback automatically into Claude Code, Codex CLI, or Cursor on every prompt.
Running synergy init will:
- Create
.synergy/with workspace and project identity files - Copy the
sync-feedback.shhook script - Auto-detect
.claude/,.codex/,.cursor/and wire each one up:- Adds a
UserPromptSubmithook to.claude/settings.json - Appends a hook entry to
.codex/config.toml - Writes a
.cursor/rules/sync-feedback.mdcrule
- Adds a
Run synergy spec ./plan.md to create an active session. The CLI copies the spec into .synergy/sessions/<session-id>/source/, registers it with the dashboard, and tracks session files for later decomposition into technical specs, phase specs, and sub-agent briefs.
After that, anything you queue in the synergy UI is automatically prepended to your next prompt — no more "did you see my feedback?" round-trips.
Prerequisites
- Node.js 20+
- The synergy server running on
localhost:8200(see the main README for setup)
Supported clients
| Client | Mechanism | Reliability |
| ----------- | -------------------------------------------------- | --------------- |
| Claude Code | UserPromptSubmit hook in .claude/settings.json | Deterministic |
| Codex CLI | Hook entry in .codex/config.toml | Deterministic |
| Cursor | alwaysApply: true rule in .cursor/rules/ | Model-dependent |
Links
- Repo: https://github.com/sanzhardanybayev/synergy
- Issues: https://github.com/sanzhardanybayev/synergy/issues
License
MIT
