Installation

Prerequisites

Before installing Symphony, ensure you have:

• Node.js 22+ — Required for the better-sqlite3 native module. Check with node --version.
• Git — Required for worktree management. Check with git --version.
• Claude CLI — The AI agent runtime. Install from Anthropic's documentation.

Use nvm for Node.js version management

Symphony includes an .nvmrc file. Run nvm use in the project directory to switch to the correct Node version.

Clone and Install

# Clone the repository
git clone https://github.com/mottaviani-dev/symphony-adlc.git
cd symphony-adlc

# Use the correct Node version
nvm use 22

# Install dependencies
npm install

Start the Web UI

npx nuxt dev --port 3333

Open http://localhost:3333 in your browser. You'll see the Symphony kanban board.

Start the Orchestrator

The orchestrator is a separate process that dispatches agents and manages the pipeline. Open a new terminal:

npm run orchestrator

Why a separate process?

The orchestrator manages long-running agent processes and needs its own lifecycle independent of the web server. This also means you can restart the web UI without interrupting active agents.

Verify the Setup

With both processes running:

1. The web UI at http://localhost:3333 should show the kanban board
2. The orchestrator terminal should show Orchestrator started with a tick loop
3. Symphony auto-detects projects in your workspace — check the project dropdown

Next Steps

• Quick Start — Create your first issue and see agents in action
• First Agent Run — End-to-end walkthrough of the agent pipeline
• Configuration — Customize Symphony for your workflow