Configuration Reference

Cyberstrike can be configured through multiple methods: config files, environment variables, and command line arguments. This reference covers all configuration options.

📸 SCREENSHOT: s13-config-structure.png

Config dosya yapısı

📊 DIAGRAM: config-priority.mermaid

Config yükleme öncelik diyagramı

Configuration Hierarchy

Configuration sources are loaded in priority order (highest priority wins):

Command line arguments
CYBERSTRIKE_CONFIG_CONTENT environment variable
Project config (./cyberstrike.json or ./cyberstrike.jsonc)
Project .cyberstrike/ directory config
Custom config (CYBERSTRIKE_CONFIG path)
Global config (~/.cyberstrike/config.json)
Remote/well-known config
Default values

Configuration Files

Project Configuration

Create cyberstrike.json or cyberstrike.jsonc in your project root:

{
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "agent": {
    "build": {
      "model": "anthropic/claude-sonnet-4-20250514"
    }
  }
}

Global Configuration

Store user-wide settings at ~/.cyberstrike/config.json:

{
  "$schema": "https://cyberstrike.io/config.json",
  "theme": "cyberpunk",
  "autoupdate": true,
  "share": "manual"
}

Project Directory Structure

Create a .cyberstrike/ directory for organized configuration:

.cyberstrike/
├── cyberstrike.json    # Project config
├── agents/             # Custom agents
│   └── security.md
├── commands/           # Custom commands
│   └── scan.md
├── plugins/            # Custom plugins
│   └── my-plugin.ts
└── modes/              # Custom modes (deprecated)

Core Settings

Model Selection

Set the default AI model:

{
  "model": "anthropic/claude-sonnet-4-20250514"
}

Format: provider/model-name

Small Model

Set a model for lightweight tasks (title generation):

{
  "small_model": "anthropic/claude-haiku-4-5-20250514"
}

Default Agent

Set the default security agent:

{
  "default_agent": "web-application"
}

Username

Override the system username:

{
  "username": "pentester"
}

Theme

Set the interface theme:

{
  "theme": "cyberpunk"
}

Provider Configuration

Configure AI providers individually:

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}",
        "timeout": 300000
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.openai.com/v1"
      },
      "whitelist": ["gpt-4o", "gpt-4-turbo"],
      "blacklist": ["gpt-3.5-turbo"]
    },
    "custom-provider": {
      "id": "custom-provider",
      "name": "Custom Provider",
      "options": {
        "baseURL": "https://api.custom.example.com/v1",
        "apiKey": "{env:CUSTOM_API_KEY}"
      }
    }
  }
}

Provider Options

Option	Type	Description
`apiKey`	string	API key for authentication
`baseURL`	string	Custom API endpoint
`timeout`	number/false	Request timeout in ms (default: 300000)
`setCacheKey`	boolean	Enable prompt cache key
`enterpriseUrl`	string	GitHub Enterprise URL for copilot

Model Filtering

Control which models appear:

{
  "provider": {
    "openai": {
      "whitelist": ["gpt-4o", "o1-preview"],
      "blacklist": ["gpt-3.5-turbo"]
    }
  }
}

Disabling Providers

Disable specific providers:

{
  "disabled_providers": ["ollama", "groq"]
}

Enable only specific providers:

{
  "enabled_providers": ["anthropic", "openai"]
}

Agent Configuration

Configure agent behavior:

{
  "agent": {
    "build": {
      "model": "anthropic/claude-sonnet-4-20250514",
      "temperature": 0.7,
      "steps": 50,
      "color": "#FF5733"
    },
    "web-application": {
      "model": "anthropic/claude-opus-4-20250514",
      "prompt": "Focus on OWASP Top 10 vulnerabilities"
    }
  }
}

Agent Options

Option	Type	Description
`model`	string	Override model for this agent
`temperature`	number	Model temperature (0-1)
`top_p`	number	Top-p sampling value
`steps`	number	Maximum agentic iterations
`prompt`	string	Custom system prompt
`color`	string	Hex color code (#RRGGBB)
`description`	string	Agent description
`mode`	string	Agent mode: “primary”, “subagent”, “all”
`hidden`	boolean	Hide from autocomplete
`disable`	boolean	Disable this agent

Creating Custom Agents

Create .cyberstrike/agents/custom.md:

---
description: Custom security agent for API testing
model: anthropic/claude-opus-4-20250514
mode: primary
---

You are an API security specialist. Focus on:
- Authentication vulnerabilities
- Authorization bypass
- Input validation
- Rate limiting issues

MCP Configuration

Configure Model Context Protocol servers:

{
  "mcp": {
    "filesystem": {
      "type": "local",
      "command": ["npx", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
      "enabled": true,
      "timeout": 5000
    },
    "remote-api": {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "oauth": {
        "clientId": "your-client-id",
        "scope": "read write"
      }
    }
  }
}

Local MCP Server

Option	Type	Description
`type`	”local”	Server type
`command`	string[]	Command and arguments
`environment`	object	Environment variables
`enabled`	boolean	Enable/disable server
`timeout`	number	Request timeout in ms

Remote MCP Server

Option	Type	Description
`type`	”remote”	Server type
`url`	string	Server URL
`headers`	object	Request headers
`oauth`	object/false	OAuth configuration
`enabled`	boolean	Enable/disable server
`timeout`	number	Request timeout in ms

OAuth Configuration

{
  "oauth": {
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "scope": "read write"
  }
}

Permission Configuration

Control tool permissions:

{
  "permission": {
    "bash": "ask",
    "edit": "allow",
    "read": "allow",
    "glob": "allow",
    "grep": "allow",
    "websearch": "deny"
  }
}

Permission Actions

Action	Description
`ask`	Prompt user for approval (default)
`allow`	Auto-approve without asking
`deny`	Block tool usage

Pattern-Based Permissions

Specify permissions per pattern:

{
  "permission": {
    "bash": {
      "*": "ask",
      "ls *": "allow",
      "rm -rf *": "deny"
    },
    "edit": {
      "*": "ask",
      "*.md": "allow"
    }
  }
}

Available Permission Keys

Key	Description
`read`	File reading
`edit`	File editing/writing
`glob`	File pattern matching
`grep`	Content searching
`list`	Directory listing
`bash`	Command execution
`task`	Task execution
`websearch`	Web searches
`webfetch`	URL fetching
`lsp`	LSP operations
`external_directory`	Access outside project

Keybindings

Customize keyboard shortcuts:

{
  "keybinds": {
    "leader": "ctrl+x",
    "app_exit": "ctrl+c,ctrl+d",
    "session_new": "<leader>n",
    "session_list": "<leader>l",
    "model_list": "<leader>m",
    "agent_list": "<leader>a",
    "input_submit": "return",
    "input_newline": "shift+return,ctrl+return"
  }
}

Key Format

Single key: ctrl+c, escape, return
Multiple bindings: ctrl+c,ctrl+d (comma-separated)
Leader sequences: <leader>n (uses leader key)
Disable: none

TUI Settings

Configure the terminal interface:

{
  "tui": {
    "scroll_speed": 1.0,
    "scroll_acceleration": {
      "enabled": true
    },
    "diff_style": "auto"
  }
}

Option	Type	Description
`scroll_speed`	number	Scroll speed multiplier
`scroll_acceleration`	object	Acceleration settings
`diff_style`	”auto”/“stacked”	Diff rendering style

Server Configuration

Configure the API server:

{
  "server": {
    "port": 4096,
    "hostname": "localhost",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Hooks Configuration

Configure automation hooks:

{
  "experimental": {
    "hook": {
      "file_edited": {
        "*.ts": [
          {
            "command": ["bun", "run", "lint"],
            "environment": {}
          }
        ]
      },
      "session_completed": [
        {
          "command": ["notify-send", "Session completed"]
        }
      ]
    }
  }
}

Control session sharing:

{
  "share": "manual"
}

Value	Description
`manual`	Share via commands only
`auto`	Auto-share new sessions
`disabled`	Disable all sharing

Compaction Settings

Configure context compaction:

{
  "compaction": {
    "auto": true,
    "prune": true
  }
}

Option	Description
`auto`	Auto-compact when context is full
`prune`	Prune old tool outputs

Environment Variables

Configuration Variables

Variable	Description
`CYBERSTRIKE_CONFIG`	Custom config file path
`CYBERSTRIKE_CONFIG_CONTENT`	Inline JSON config
`CYBERSTRIKE_CONFIG_DIR`	Additional config directory
`CYBERSTRIKE_DISABLE_PROJECT_CONFIG`	Ignore project config
`CYBERSTRIKE_PERMISSION`	JSON permission overrides

Provider API Keys

Variable	Provider
`ANTHROPIC_API_KEY`	Anthropic
`OPENAI_API_KEY`	OpenAI
`GOOGLE_API_KEY`	Google
`OPENROUTER_API_KEY`	OpenRouter
`AWS_ACCESS_KEY_ID`	AWS Bedrock
`AZURE_API_KEY`	Azure OpenAI

Behavior Flags

Variable	Description
`CYBERSTRIKE_AUTO_SHARE`	Auto-share sessions
`CYBERSTRIKE_DISABLE_AUTOCOMPACT`	Disable auto-compaction
`CYBERSTRIKE_DISABLE_PRUNE`	Disable output pruning

Variable Substitution

Environment Variables

Reference environment variables in config:

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

File References

Include content from files:

{
  "instructions": ["{file:./SECURITY.md}"]
}

Supports:

Relative paths: {file:./path/to/file}
Absolute paths: {file:/absolute/path}
Home directory: {file:~/path/from/home}

LSP Configuration

Configure Language Server Protocol:

{
  "lsp": {
    "typescript": {
      "command": ["typescript-language-server", "--stdio"],
      "extensions": [".ts", ".tsx"]
    },
    "rust": {
      "disabled": true
    }
  }
}

Set lsp: false to disable all LSP features.

Formatter Configuration

Configure code formatters:

{
  "formatter": {
    "prettier": {
      "command": ["prettier", "--write"],
      "extensions": [".ts", ".tsx", ".js", ".jsx"]
    },
    "rustfmt": {
      "disabled": true
    }
  }
}

Set formatter: false to disable all formatters.

Complete Example

{
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "small_model": "anthropic/claude-haiku-4-5-20250514",
  "default_agent": "web-application",
  "theme": "cyberpunk",
  "share": "manual",
  "autoupdate": "notify",

  "provider": {
    "anthropic": {
      "options": {
        "timeout": 300000
      }
    }
  },

  "agent": {
    "web-application": {
      "model": "anthropic/claude-opus-4-20250514",
      "steps": 100
    }
  },

  "permission": {
    "bash": "ask",
    "edit": "allow",
    "read": "allow"
  },

  "mcp": {
    "filesystem": {
      "type": "local",
      "command": ["npx", "@modelcontextprotocol/server-filesystem", "."],
      "enabled": true
    }
  },

  "keybinds": {
    "leader": "ctrl+x"
  },

  "compaction": {
    "auto": true,
    "prune": true
  }
}

Configuration Reference

Configuration Hierarchy

Configuration Files

Project Configuration

Global Configuration

Project Directory Structure

Core Settings

Model Selection

Small Model

Default Agent

Username

Theme

Provider Configuration

Provider Options

Model Filtering

Disabling Providers

Agent Configuration

Agent Options

Creating Custom Agents

MCP Configuration

Local MCP Server

Remote MCP Server

OAuth Configuration

Permission Configuration

Permission Actions

Pattern-Based Permissions

Available Permission Keys

Keybindings

Key Format

TUI Settings

Server Configuration

Hooks Configuration

Sharing Configuration

Compaction Settings

Environment Variables

Configuration Variables

Provider API Keys

Behavior Flags

Variable Substitution

Environment Variables

File References

LSP Configuration

Formatter Configuration

Complete Example