CLI Reference

Complete command reference for Sypha CLI.

SYPHA(1)

NAME

sypha - Enterprise AI-powered terminal interface for software development

SYNOPSIS

sypha [options] [prompt]
sypha <command> [arguments]

Sypha CLI is an enterprise-grade command line interface that provides AI-powered assistance for software development tasks. It supports 40+ AI providers, intelligent session management, git integration, and enterprise analytics.

OPTIONS

-v, --version              Print version information
-h, --help                 Print help information
-w, --working-dir PATH     Set working directory
-s, --setting KEY=VALUE    Override configuration setting
-d, --debug                Enable debug mode

EXAMPLES

# Launch interactive mode
sypha

# Execute direct command
sypha "Add unit tests to utils.js"

# Set working directory
sypha -w /path/to/project

# Override settings
sypha -s autoSave=false -s theme="Monokai"

Command Categories

Core Commands

/help

Display help information for commands.

Usage:

/help [command]

Examples:

/help              # Show all commands
/help session      # Show session command help
/help mode         # Show mode command help

/new

Start a fresh conversation, clearing current context.

Usage:

/new

Description: Creates a new session with empty context. The current session is automatically saved before starting a new one.

/clear

Clear the terminal screen without affecting session state.

Usage:

/clear

Alias: /cls

/exit

Exit Sypha CLI and return to shell.

Usage:

/exit

Aliases: /quit, /q

Description: Saves the current session before exiting. Use Ctrl+C for emergency exit.

Model Management

/model

Manage AI models.

Usage:

/model [action] [model-name]

Actions:

list - List available models for current provider
<model-name> - Switch to specified model
info - Show current model information

Examples:

/model list                        # List all models
/model claude-sonnet-4-5          # Switch to Claude Sonnet 4.5
/model gpt-4                      # Switch to GPT-4
/model info                       # Show current model details

Output Example:

Available models for anthropic:
  • claude-sonnet-4-5 (recommended)
  • claude-opus-4
  • claude-haiku-4

Current model: claude-sonnet-4-5
Provider: anthropic
Context window: 200,000 tokens

/provider

Switch AI provider.

Usage:

/provider [provider-name]

Examples:

/provider anthropic               # Switch to Anthropic
/provider openai                  # Switch to OpenAI
/provider gemini                  # Switch to Google Gemini
/provider sypha                   # Switch to Sypha (intelligent routing)
/provider list                    # List all providers

Major Providers:

anthropic - Claude models
openai - GPT models
gemini - Google Gemini
mistral - Mistral AI
deepseek - DeepSeek models
groq - Ultra-fast inference
bedrock - AWS Bedrock
azure - Azure OpenAI
ollama - Local models
sypha - Intelligent routing

/profile

Manage provider profiles and API keys.

Usage:

/profile [action]

Actions:

list - List all configured profiles
show - Show current profile details
add - Add new profile
remove <name> - Remove profile

Examples:

/profile list                      # List profiles
/profile show                      # Show current profile
/profile add                       # Add new profile (interactive)

Mode Management

/mode

Switch operational mode.

Usage:

/mode [mode-name]

Available Modes:

code - General development (default)
plan - Architectural planning
debug - Troubleshooting and debugging
architect - System design

Examples:

/mode code                        # Switch to code mode
/mode plan                        # Switch to plan mode
/mode debug                       # Switch to debug mode
/mode architect                   # Switch to architect mode

Keyboard Shortcut: Shift+Tab for quick mode selection

Mode Descriptions:

code mode:

General-purpose development
Code generation and modification
Best for feature implementation

plan mode:

Architectural planning
Design documents
Technical specifications
Best for system design

debug mode:

Error investigation
Root cause analysis
Performance troubleshooting
Best for bug hunting

architect mode:

High-level system design
Technology evaluation
Architecture decisions
Best for technical leadership

Session Management

/session

Manage conversation sessions.

Usage:

/session <action> [arguments]

Actions:

list - Show all saved sessions

/session list
/session list --favorites         # Show only favorited sessions

show - Display current session information

/session show

save - Manually save current session

/session save

resume - Resume most recent session

/session resume

select - Restore specific session by ID

/session select <session-id>

search - Search sessions by content

/session search <query>
/session search "authentication"

rename - Rename a session

/session rename <session-id> <new-name>
/session rename a1b2c3d4 "JWT Implementation"

delete - Delete a session

/session delete <session-id>

favorite - Mark session as favorite

/session favorite <session-id>

new - Start new session (alternative to /new)

/session new

Examples:

# List all sessions
/session list

# Resume last session
/session resume

# Search for auth-related sessions
/session search "authentication"

# Select specific session
/session select a1b2c3d4

# Show current session details
/session show

# Rename session
/session rename a1b2c3d4 "User Auth Implementation"

# Mark as favorite
/session favorite a1b2c3d4

Session Output Example:

📋 Current Session:

ID: a1b2c3d4-e5f6-7890-1234-567890abcdef
Name: User Auth Implementation ⭐
Created: 2 hours ago
Last active: 5 minutes ago
Messages: 28
Provider: anthropic/claude-sonnet-4-5
Working directory: /Users/name/project
Git branch: feature/auth
Tokens used: 45,231
Estimated cost: $0.68
Auto-save: Enabled (saved 2 minutes ago)

Git Integration

/add

Stage files for commit.

Usage:

/add <files...>

Examples:

/add src/auth.ts                  # Stage single file
/add src/*.ts                     # Stage with glob pattern
/add .                            # Stage all changes
/add src/ tests/                  # Stage multiple paths

/commit

Create git commit with Sypha branding.

Usage:

/commit <message>

Examples:

/commit "Add user authentication"
/commit "Fix: Resolve memory leak in cache"

Commit Format:

Add user authentication

Co-Authored-By: Sypha AI <noreply@sypha.ai>

/status

Show git repository status.

Usage:

/status

Output:

On branch: feature/auth
Your branch is ahead of 'origin/feature/auth' by 2 commits.

Changes to be committed:
  modified: src/auth/jwt.ts
  new file: src/auth/types.ts

Changes not staged:
  modified: src/routes/auth.ts

Untracked files:
  src/auth/refresh.ts

/diff

View git changes with visual diff.

Usage:

/diff [options]

Options:

--staged - Show staged changes only
--cached - Alias for --staged

Examples:

/diff                             # Show unstaged changes
/diff --staged                    # Show staged changes

Visual Diff:

Green background for additions
Red background for deletions
Line numbers in gutter
Ctrl+S to expand/collapse large diffs

/push

Push commits to remote repository.

Usage:

/push [remote] [branch]

Examples:

/push                             # Push to default remote/branch
/push origin main                 # Push to specific remote/branch

/undo

Undo last git operation.

Usage:

/undo

Description: Reverts the last file modification. Creates a checkpoint before undoing.

Checkpoint System

/checkpoint

Manage git-integrated conversation snapshots.

Usage:

/checkpoint <action> [arguments]

Actions:

create - Create new checkpoint

/checkpoint create [description]
/checkpoint create "Before refactoring auth"

list - List all checkpoints

/checkpoint list

restore - Restore checkpoint

/checkpoint restore <checkpoint-id>

delete - Delete checkpoint

/checkpoint delete <checkpoint-id>

Examples:

# Create checkpoint
/checkpoint create "Before risky refactor"

# List checkpoints
/checkpoint list

# Restore checkpoint
/checkpoint restore cp-a1b2c3d4

# Delete old checkpoint
/checkpoint delete cp-e5f6g7h8

Checkpoint Output:

📍 Checkpoints:

1. cp-a1b2c3d4 - Before risky refactor
   Created: 15 minutes ago
   Branch: feature/auth
   Files changed: 3

2. cp-e5f6g7h8 - Working auth implementation
   Created: 2 hours ago
   Branch: feature/auth
   Files changed: 8

Configuration

/config

Open configuration file in editor.

Usage:

/config

Configuration File: ~/.sypha/cli/config.json

Configuration Options:

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-5",
  "theme": "Sypha Blue",
  "autoSave": true,
  "autoSaveInterval": 5000,
  "analytics": {
    "enabled": true,
    "track_usage": true
  },
  "gitIntegration": {
    "enabled": true,
    "autoCheckpoint": true
  }
}

/theme

Change terminal theme.

Usage:

/theme [theme-name]

Available Themes:

Sypha Blue (default)
Sypha Dark
Sypha Light
Dracula
Monokai
Solarized Dark
Solarized Light
Nord
One Dark
Gruvbox
Material
Tokyo Night
Catppuccin
Rose Pine
Everforest

Examples:

/theme                            # List available themes
/theme Dracula                    # Switch to Dracula theme
/theme "Tokyo Night"              # Switch to Tokyo Night

Utilities

/condense

Manually trigger conversation condensing.

Usage:

/condense

Description: Condenses conversation history to reduce token usage while preserving context. Normally happens automatically, but can be triggered manually.

/export

Export session data.

Usage:

/export <type> [id] [options]

Types:

session - Export session conversation

Options:

--format json - Export as JSON (default)
--format markdown - Export as Markdown

Examples:

/export session a1b2c3d4 --format json
/export session a1b2c3d4 --format markdown

/import

Import session data.

Usage:

/import <file-path>

Examples:

/import ~/Downloads/session-export.json

/logout

Log out from Sypha enterprise account.

Usage:

/logout

Description: Clears authentication tokens and returns to login screen.

/teams

Manage enterprise teams (Enterprise only).

Usage:

/teams <action>

Actions:

list - List all teams
switch <team-id> - Switch active team
show - Show current team details

Examples:

/teams list                       # List all teams
/teams switch team-abc123         # Switch to team
/teams show                       # Show current team

Analytics & Monitoring

View Current Usage

Usage statistics are displayed automatically after each response:

╭─────────────────────────────────────────────────────╮
│ anthropic/claude-sonnet-4-5                         │
│ ⏱  2.3s | 💬 1,234 in | 567 out | 💰 $0.023        │
╰─────────────────────────────────────────────────────╯

Metrics:

Response time
Input tokens
Output tokens
Estimated cost

Keyboard Shortcuts

Universal Shortcuts

Shortcut	Action	Description
`Ctrl+Y`	Toggle Auto-Edit	Enable/disable automatic file approval
`Shift+Tab`	Quick Mode Switch	Open mode selection menu
`Ctrl+D`	Show TODOs	Display current task list
`Ctrl+E`	Reasoning History	View AI's decision-making process
`!`	Shell Mode	Execute shell commands

Context-Aware Shortcuts

Shortcut	Action	Context
`Ctrl+X`	Cancel Streaming	During AI response
`Ctrl+S`	Expand/Collapse	In diff view with truncation
`Y` or `1`	Allow once	During approval prompt
`A` or `2`	Allow for session	During approval prompt
`N` or `3`	Reject	During approval prompt
`Esc`	Cancel	During approval prompt
`Up/Down`	Navigate options	During approval prompt
`Enter`	Execute selection	During approval prompt

Image Support

Reference images using @ syntax:

Syntax:

@<filename> <prompt>
@"<path with spaces>" <prompt>

Supported Formats: PNG, JPG, JPEG, GIF, WebP, SVG, BMP, TIFF, AVIF

Examples:

@screenshot.png analyze this error
@"designs/mobile app.png" implement this design
@diagram.png explain this architecture

Environment Variables

API Configuration

# Sypha Enterprise
export SYPHA_API_BASE_URL="https://api.sypha.ai"
export SYPHA_API_KEY="your-api-key"

# Provider Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="..."
export MISTRAL_API_KEY="..."
export DEEPSEEK_API_KEY="..."

Analytics

export SYPHA_CLI_ANALYTICS_ENABLED=true
export SYPHA_CLI_ANALYTICS_DEBUG=false

Session Management

export SYPHA_SESSION_AUTO_SAVE=true
export SYPHA_SESSION_SAVE_INTERVAL=5000

Git Integration

export SYPHA_GIT_INTEGRATION_ENABLED=true

Debug Mode

export SYPHA_CLI_DEBUG=true

Exit Codes

Code	Description
0	Success
1	General error
2	Command not found
3	Invalid arguments
126	Command cannot execute
127	Command not found
130	Terminated by Ctrl+C

Files

~/.sypha/cli/config.json           Main configuration file
~/.sypha/cli/sessions/             Session storage directory
~/.sypha/cli/logs/                 Log files
~/.sypha/cli/cache/                Cache directory
~/.sypha/cli/themes/               Custom themes

Support

Documentation: https://sypha.ai/docs
Email: support@sypha.ai
GitHub: https://github.com/your-org/sypha-cli
Discord: https://discord.gg/sypha

CLI Reference

On this page