Configuration

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

~/.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

Model Configuration

Choose Your AI Model

Select from cutting-edge AI models or run locally with complete privacy

Available Models

Model Selection Strategy

API Configuration

# 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

Code Analysis Tools

{
  "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

Search Tools

{
  "tools": {
    "grep": {
      "engine": "ripgrep",
      "defaultFlags": ["--smart-case", "--hidden"],
      "ignoreFile": ".gitignore",
      "maxResults": 1000,
      "contextLines": 2
    }
  }
}

Execution Tools

{
  "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

Ask Siya

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

Automatic Configuration

Siya will handle the installation and configuration

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

Natural Language

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

Siya Generates

Siya creates the appropriate hook configuration

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

{
  "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

Security Settings

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 & Debugging

{
  "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

Layer Appropriately

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

Version Control

Commit project configs, exclude personal preferences and secrets

Document Settings

Add comments explaining non-obvious configuration choices

Regular Review

Periodically review and clean up unused configurations

Team Alignment

Share project configurations to ensure consistency

Troubleshooting Configuration

Common Issues

Reset 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.

Getting Started

Core Concepts

Configuration & Integration

Advanced

Your Siya, Your Way

​Configuration Overview

​Configuration Files

~/.siya/config.json

​Model Configuration

Choose Your AI Model

​Tool Configuration

Power Up Your Tools

​MCP Server Configuration

Extend with MCP Servers

​Hooks Configuration

Automate Your Workflow

​Advanced Configuration

Fine-Tune Every Detail

​Configuration Best Practices

Configuration Excellence

​Troubleshooting Configuration

​Summary

Configuration Mastery Achieved

Next: MCP Integration

Explore Hooks

Configuration Overview

Configuration Files

Model Configuration

Tool Configuration

MCP Server Configuration

Hooks Configuration

Advanced Configuration

Configuration Best Practices

Troubleshooting Configuration

Summary