Sypha AI Docs
Sypha CLI

Agents

Pick the right specialised agent — Code, Plan, Debug, Orchestrator, or Ask — or define your own.

Sypha ships five built-in agents, each tuned for a phase of the workflow. You can also define your own custom agents.

Code

Implementation — writes and edits code, runs commands, ships changes.

Plan

System design and planning — reasons about the approach before touching files.

Debug

Troubleshooting — isolates and fixes failures.

Orchestrator

Delegates large tasks to parallel sub-agents and stitches the results together.

Ask

Read-only Q&A — answers questions about your codebase without making changes.

Custom agents

Define your own agent (name, model, instructions, tools) for team-specific workflows.

Switching agents

Press Tab to cycle to the next agent, Shift+Tab for the previous one.

Run /agents to pick from the list (Code / Plan / Debug / Orchestrator / Ask / custom).

Start directly in an agent: sypha --agent plan

Reference an agent inline in your prompt with @agent.

Model selection applies to all agents — set a default model (and a default sub-agent model/effort) once and every agent uses it.

On this page