Skip to main content

Your Siya, Your Way

Siya is highly customizable, allowing you to tailor every aspect of the experience to your needs. From UI preferences to model selection, tool configurations to custom workflows - make Siya work exactly how you want it to.

​
Configuration Overview

Siya's hierarchical configuration system provides flexibility at every level

​
Configuration Files

  • Global Config
  • Desktop Config
  • Project Config
  • SIYA.md

~/.siya/config.json

System-wide settings that apply to all Siya instances
{
  "defaultModel": "claude-opus-4",
  "theme": "dark",
  "editor": {
    "fontSize": 14,
    "fontFamily": "JetBrains Mono",
    "tabSize": 2,
    "wordWrap": true
  },
  "notifications": {
    "sound": true,
    "desktop": true,
    "email": false
  },
  "telemetry": {
    "enabled": false,
    "level": "errors"
  },
  "experimental": {
    "betaFeatures": true,
    "debugMode": false
  }
}

Setting Categories

Core Settings

  • Default model selection
  • UI theme preferences
  • Language settings
  • Timezone configuration

Developer Settings

  • Editor preferences
  • Code formatting
  • Syntax highlighting
  • Debug options

Privacy Settings

  • Telemetry control
  • Data retention
  • Logging levels
  • Analytics opt-out

Advanced Settings

  • Experimental features
  • Beta access
  • Performance tuning
  • Custom endpoints

​
Model Configuration

Choose Your AI Model

Select from cutting-edge AI models or run locally with complete privacy
  • Cloud Models
  • Local Models

Available Models

Claude Models

Claude Opus 4
  • Most capable model
  • Best for complex tasks
  • Superior reasoning
Claude Sonnet 4
  • Balanced performance
  • Faster responses
  • Cost-effective

OpenAI Models

GPT-5
  • Latest generation
  • Multimodal capable
  • Extended context
GPT-4 Turbo
  • Production ready
  • Reliable performance
  • Good value

Google Models

Gemini 2.5 Pro
  • Massive context window
  • Multimodal native
  • Fast inference
Gemini 2.5 Flash
  • Lightning fast
  • Cost optimized
  • Good for simple tasks

Specialized Models

DeepSeek Coder
  • Code specialized
  • Technical tasks
  • Open weights
Qwen 2.5
  • Multilingual
  • Strong reasoning
  • Efficient
# Claude API
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI API
export OPENAI_API_KEY="sk-..."

# Google API
export GOOGLE_API_KEY="AIza..."

# Custom Endpoints
export LLM_GATEWAY_URL="https://your-gateway.com"

​
Tool Configuration

Power Up Your Tools

Configure tools to match your development workflow perfectly

File System Tools

{
  "tools": {
    "fileSystem": {
      "defaultPermissions": "conservative",
      "autoBackup": true,
      "excludePatterns": [
        "node_modules/**",
        ".git/**",
        "*.log",
        "dist/**"
      ],
      "watchPatterns": [
        "src/**/*.{ts,tsx,js,jsx}",
        "*.config.{js,ts}"
      ],
      "encoding": "utf-8",
      "lineEndings": "auto"
    }
  }
}

Safety Features

  • Automatic backups
  • Permission checks
  • Destructive warnings
  • Undo capability

Performance

  • Smart caching
  • Batch operations
  • Async I/O
  • Memory mapping

Integration

  • Git awareness
  • Build tool hooks
  • IDE sync
  • File watchers
{
  "tools": {
    "codeAnalysis": {
      "ast": {
        "enabled": true,
        "languages": ["typescript", "javascript", "python"],
        "maxFileSize": "10MB"
      },
      "linting": {
        "autoFix": false,
        "showSuggestions": true,
        "severity": "warning"
      },
      "typeChecking": {
        "strict": true,
        "incremental": true,
        "skipLibCheck": false
      }
    }
  }
}
Code analysis tools help Siya understand your codebase structure and maintain quality
  • Grep Configuration
{
  "tools": {
    "grep": {
      "engine": "ripgrep",
      "defaultFlags": ["--smart-case", "--hidden"],
      "ignoreFile": ".gitignore",
      "maxResults": 1000,
      "contextLines": 2
    }
  }
}

{
  "tools": {
    "execution": {
      "shell": "/bin/zsh",
      "timeout": 120000,
      "sandbox": {
        "enabled": true,
        "networking": false,
        "filesystem": "read-only"
      },
      "environment": {
        "NODE_ENV": "development",
        "PYTHONPATH": "./src"
      }
    }
  }
}
Sandbox mode restricts network and filesystem access for safety

​
MCP Server Configuration

Extend with MCP Servers

Connect specialized tools and services through Model Context Protocol

MCP servers extend Siya's capabilities with domain-specific tools

  • Quick Setup
  • Manual Setup
  • Available Servers
1

Ask Siya

Simply tell Siya: “Configure the stock-market MCP server”
2

Automatic Configuration

Siya will handle the installation and configuration
3

Start Using

The server’s tools are immediately available
Siya can configure any MCP server from a GitHub URL or npm package name

​
Hooks Configuration

Automate Your Workflow

Create powerful automations that trigger on Siya’s actions

Hooks enable event-driven automation within Siya

  • Creating Hooks
  • Hook Events
  • Hook Examples
1

Natural Language

Tell Siya: “Create a hook that runs tests whenever I modify a test file”
2

Siya Generates

Siya creates the appropriate hook configuration
3

Automatic Activation

Hook starts working immediately
{
  "hooks": [
    {
      "name": "Auto-test on change",
      "event": "file:modified",
      "pattern": "**/*.test.{js,ts}",
      "command": "npm test -- ${file}",
      "enabled": true
    }
  ]
}

​
Advanced Configuration

Fine-Tune Every Detail

Advanced settings for power users who want complete control

Performance Tuning

  • Memory Optimization
  • Network Settings
  • Concurrency
{
  "performance": {
    "memory": {
      "maxHeapSize": "4096MB",
      "gcInterval": 300000,
      "cacheSize": "1GB",
      "compressionLevel": 6
    }
  }
}

Heap Settings

  • Initial: 512MB
  • Maximum: 4GB
  • Growth: Adaptive
  • GC: Incremental

Cache Strategy

  • LRU eviction
  • TTL: 1 hour
  • Compression: zstd
  • Persistence: optional

Access Control

{
  "security": {
    "fileAccess": {
      "whitelist": ["~/projects", "/tmp"],
      "blacklist": ["~/.ssh", "/etc"],
      "readOnly": ["~/Documents"]
    }
  }
}

Secrets Management

{
  "security": {
    "secrets": {
      "provider": "keychain",
      "encryption": "aes-256-gcm",
      "autoLock": 300
    }
  }
}
Never commit sensitive configuration to version control
{
  "logging": {
    "level": "info",
    "outputs": ["console", "file"],
    "file": {
      "path": "~/.siya/logs",
      "maxSize": "100MB",
      "maxFiles": 5,
      "compress": true
    },
    "filters": {
      "exclude": ["password", "token", "key"],
      "include": ["error", "warning"]
    }
  },
  "debugging": {
    "enabled": false,
    "verboseTools": ["bash", "mcp"],
    "traceRequests": false,
    "profileMemory": false
  }
}
Enable debugging temporarily with: siya --debug

​
Configuration Best Practices

Configuration Excellence

Follow these practices for maintainable and effective configurations
1

Layer Appropriately

Use global for preferences, project for code style, session for experiments
2

Version Control

Commit project configs, exclude personal preferences and secrets
3

Document Settings

Add comments explaining non-obvious configuration choices
4

Regular Review

Periodically review and clean up unused configurations
5

Team Alignment

Share project configurations to ensure consistency

​
Troubleshooting Configuration

# Backup current config
cp ~/.siya/config.json ~/.siya/config.backup.json

# Reset to defaults
rm ~/.siya/config.json

# Siya will recreate with defaults
siya

​
Summary

Configuration Mastery Achieved

You now have complete control over Siya’s behavior. From simple preferences to complex automations, every aspect can be tailored to your workflow. Use configurations wisely to create a development environment that feels like a natural extension of your thought process.

Next: MCP Integration

Extend Siya with powerful MCP servers

Explore Hooks

Create powerful workflow automations
Configure once. Work efficiently forever.