Advanced Configuration

Customize every aspect of Sypha CLI to fit your workflow.

Configuration File

The main configuration file is located at ~/.sypha/cli/config.json.

You can open this file directly in your default editor using the /config command.

Complete Schema

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-5",
  "theme": "Sypha Blue",
  "language": "en",
  "autoSave": true,
  "autoSaveInterval": 5000,
  "analytics": {
    "enabled": true,
    "track_usage": true,
    "track_performance": true
  },
  "gitIntegration": {
    "enabled": true,
    "autoCheckpoint": true,
    "brandCommits": true,
    "visualDiffs": true
  },
  "context": {
    "includedFiles": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.md", "**/*.json"],
    "excludedFiles": ["**/node_modules/**", "**/dist/**", "**/.git/**"],
    "maxTokens": 200000
  },
  "ui": {
    "showLineNumbers": true,
    "showTimestamp": true,
    "syntaxHighlighting": true
  }
}

Environment Variables

Override configuration settings using environment variables. This is useful for CI/CD pipelines or temporary overrides.

Core Settings

Variable	Description	Default
`SYPHA_PROVIDER`	AI Provider to use	`anthropic`
`SYPHA_MODEL`	Specific model ID	`claude-sonnet-4-5`
`SYPHA_THEME`	UI Theme	`Sypha Blue`
`SYPHA_WORKING_DIR`	Initial working directory	Current directory

API & Authentication

# Base URL for enterprise deployments
export SYPHA_API_BASE_URL="https://api.custom-domain.com"

# Enterprise API Key
export SYPHA_API_KEY="sk_ent_..."

# Provider-specific Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-proj-..."
export GEMINI_API_KEY="AIza..."

Git Integration

Variable	Description	Default
`SYPHA_GIT_ENABLED`	Enable git features	`true`
`SYPHA_GIT_AUTO_CHECKPOINT`	Create checkpoints before risky ops	`true`
`SYPHA_GIT_BRAND_COMMITS`	Add Co-Authored-By trailer	`true`

System & Debugging

# Enable detailed debug logging
export SYPHA_CLI_DEBUG=true

# Path to log file
export SYPHA_LOG_PATH="/tmp/sypha-cli.log"

# Disable analytics
export SYPHA_ANALYTICS_ENABLED=false

Custom Themes

Sypha CLI supports custom themes. You can define your own color scheme in ~/.sypha/cli/themes/my-theme.json.

Theme Structure

{
  "name": "Neon Night",
  "type": "dark",
  "colors": {
    "background": "#0a0a12",
    "foreground": "#e0e0e0",
    "primary": "#ff00ff",
    "secondary": "#00ffff",
    "success": "#00ff00",
    "error": "#ff0000",
    "warning": "#ffff00",
    "info": "#0000ff",
    "muted": "#666666",
    "border": "#333333"
  }
}

Once saved, load your theme:

/theme "Neon Night"

Hooks & Automation

You can configure scripts to run before or after specific Sypha events.

Define hooks in ~/.sypha/cli/hooks.json:

{
  "onSessionStart": "echo 'Session started' >> /tmp/session.log",
  "onCheckpointCreate": "notify-send 'Checkpoint created'",
  "onExit": "cleanup-temp-files.sh"
}

Proxy Configuration

If you are behind a corporate proxy, Sypha respects standard proxy environment variables:

export HTTP_PROXY="http://proxy.company.com:8080"
export HTTPS_PROXY="http://proxy.company.com:8080"
export NO_PROXY="localhost,127.0.0.1,internal.company.com"

🔧

Having trouble? Check the troubleshooting guide for common configuration issues.

Advanced Configuration

On this page