Sypha CLI
Orchestrate Sypha agents from your terminal for a keyboard-first, high-velocity development workflow.
Sypha CLI
The Sypha CLI empowers you to command AI agents directly from your terminal. It is engineered for keyboard-first navigation, allowing you to plan, debug, and execute code changes without leaving your command-line environment.
The CLI utilizes the same high-performance engine as our IDE extensions, ensuring a consistent, agentic workflow across your entire development stack.
Installation
Initialize the Sypha package globally via npm:
npm install -g syphaNavigate to your workspace and execute sypha to begin:
# Start an interactive construction session
sypha
# Initiate with a specialized mode
sypha --mode architect
# Resume the most recent conversation in the current directory
sypha --continueUpdate Protocol
Ensure you are running the latest logic by updating the package:
npm update -g syphaStrategic Capabilities
- Terminal-First Construction: Plan and execute complex code shifts directly within your shell.
- Model Agnostic: Switch between hundreds of LLMs (Claude, GPT, Gemini, Llama) instantly without service lock-in.
- Adaptive Personas: Selection between
Architect,Logic,Debug, andResearchmodes at recruitment time. - Automation Engine: Authorise Sypha to write and execute shell scripts for repetitive file transformations or system tasks.
- Extensible Logic: Enhance agent intelligence through Sypha Skills.
Interactive Command Reference
Operational Shortcuts
| Shortcut | Strategy |
|---|---|
Shift+Tab | Cycle through Developers (Architect → Logic → Debug → Research) |
Ctrl+C | Terminate the session (Double-tap to confirm) |
Ctrl+X | Abort the current construction task |
Ctrl+Y | Toggle YOLO Mode (Authorise all operations automatically) |
! | Enter direct Shell Command mode |
Essential Slash Commands
| Command | Description |
|---|---|
/mode | Hot-swap between agent personas. |
/model | List and select different AI engines. |
/checkpoint list | Review all available project state snapshots. |
/checkpoint restore | Revert the repository to a specific historical state. |
/tasks | Browse and search your local task history. |
/config | Initiate the interactive configuration dashboard. |
/new | Reset the agent's memory for a fresh construction task. |
Sypha Skills
The CLI supports a lightweight extensibility format for injecting domain-specific expertise into your agents.
- Global Intelligence: Located in
~/.sypha/skills/(available across all environments). - Project Intelligence: Located in
.sypha/skills/(tailored for specific repository logic).
Initializing a New Skill
- Define a new skill directory (e.g.,
~/.sypha/skills/security-audit). - Authorise a
SKILL.mdfile with a descriptive name and frontmatter logic. - Restart your CLI session to harmonize the new intelligence.
Checkpoint & Safety Management
Sypha automatically archives your project state before any non-trivial file modification.
[!CAUTION] Destructive Operation: Restoring a checkpoint performs a hard Git reset. All uncommitted manual changes will be purged. Ensure your work is staged before performing a system-level restoration.
Autonomous Construction Mode
For CI/CD pipelines or batch processing, Sypha can operate without human intervention via the --auto flag.
# Execute a task autonomously
sypha --auto "Optimize all image assets in /public"
# Integrate with automated pipelines via JSON output
sypha --auto --json "Verify all API endpoints"In Autonomous Mode, all approval cycles are managed via your Auto-Approval Configuration.