Referencia de Configuracao

O Cyberstrike pode ser configurado por multiplos metodos: arquivos de configuracao, variaveis de ambiente e argumentos de linha de comando. Esta referencia cobre todas as opcoes de configuracao.

Hierarquia de Configuracao

As fontes de configuracao sao mescladas em ordem de prioridade (a maior prioridade vence):

1. Argumentos de linha de comando
2. Configuracao gerenciada (empresarial) — cyberstrike.json/cyberstrike.jsonc controlado pelo administrador no diretorio gerenciado
3. Variavel de ambiente CYBERSTRIKE_CONFIG_CONTENT (JSON inline)
4. Configuracao do diretorio .cyberstrike/ — o .cyberstrike/ do projeto, depois ~/.cyberstrike/ no diretorio home
5. Configuracao do projeto (./cyberstrike.json ou ./cyberstrike.jsonc, descoberto subindo a partir do diretorio de trabalho)
6. Caminho de configuracao personalizado (CYBERSTRIKE_CONFIG)
7. Configuracao global (~/.config/cyberstrike/config.json, cyberstrike.json ou cyberstrike.jsonc)
8. Configuracao remota / well-known
9. Valores padrao

Inspecionando a Configuracao

Para ver a configuracao efetiva apos todas as fontes serem mescladas, execute:

cyberstrike debug config

Isso imprime a configuracao resolvida como JSON. Nao existem comandos config get/set — altere as configuracoes editando o arquivo de configuracao diretamente (veja abaixo).

Arquivos de Configuracao

Configuracao do Projeto

Crie cyberstrike.json ou cyberstrike.jsonc na raiz do seu projeto:

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

Configuracao Global

Armazene configuracoes de usuario em ~/.config/cyberstrike/. Qualquer um entre config.json, cyberstrike.json ou cyberstrike.jsonc e carregado (o Cyberstrike gera automaticamente o config.json):

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

Estrutura do Diretorio do Projeto

Crie um diretorio .cyberstrike/ para configuracao organizada:

.cyberstrike/
├── cyberstrike.json    # Configuracao do projeto
├── agents/             # Agentes personalizados
│   └── security.md
├── commands/           # Comandos personalizados
│   └── scan.md
├── plugins/            # Plugins personalizados
│   └── my-plugin.ts
└── modes/              # Modos personalizados (obsoleto)

Configuracoes Principais

Selecao de Modelo

Defina o modelo de IA padrao:

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

Formato: provider/model-name

Modelo Leve

Defina um modelo para tarefas leves (geracao de titulo):

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

Agente Padrao

Defina o agente de seguranca padrao:

{
  "default_agent": "cyberstrike"
}

Nome de Usuario

Sobrescreva o nome de usuario do sistema:

{
  "username": "pentester"
}

Tema

Defina o tema da interface:

{
  "theme": "cyberstrike"
}

Configuracao de Provedores

Configure provedores de IA individualmente:

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

Opcoes do Provedor

Filtragem de Modelos

Controle quais modelos aparecem:

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

Desabilitando Provedores

Desabilite provedores especificos:

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

Habilite apenas provedores especificos:

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

Configuracao de Agentes

Configure o comportamento dos agentes:

{
  "agent": {
    "cyberstrike": {
      "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"
    }
  }
}

Opcoes do Agente

Criando Agentes Personalizados

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

Configuracao MCP

Configure servidores Model Context Protocol:

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

Servidor MCP Local

Servidor MCP Remoto

Configuracao OAuth

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

Configuracao de Permissoes

Controle permissoes de ferramentas:

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

Acoes de Permissao

Permissoes Baseadas em Padrao

Especifique permissoes por padrao:

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

Chaves de Permissao Disponiveis

Keybindings

Personalize atalhos de teclado:

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

Formato de Tecla

• Tecla unica: ctrl+c, escape, return
• Multiplos bindings: ctrl+c,ctrl+d (separados por virgula)
• Sequencias de lider: <leader>n (usa a tecla lider)
• Desabilitar: none

Configuracoes da TUI

Configure a interface de terminal:

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

Configuracao do Servidor

Configure o servidor de API:

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

Plugins e Hooks

O Cyberstrike nao usa um sistema de hooks baseado em configuracao. Hooks de automacao e ciclo de vida sao implementados como plugins — modulos JavaScript/TypeScript que se inscrevem em eventos como tool.execute.before, tool.execute.after ou permission.ask.

Registre plugins por nome. Eles sao resolvidos do npm ou de um diretorio local {plugin,plugins}/ dentro de .cyberstrike/:

{
  "plugin": ["my-plugin", "@scope/another-plugin"]
}

Consulte Hooks e Plugins para a lista completa de eventos e o guia de autoria.

Opcoes Experimentais

O bloco experimental expoe funcionalidades opt-in:

{
  "experimental": {
    "batch_tool": true,
    "openTelemetry": false,
    "continue_loop_on_deny": false,
    "mcp_timeout": 5000
  }
}

Configuracao de Compartilhamento

Controle o compartilhamento de sessoes:

{
  "share": "manual"
}

Configuracoes de Compactacao

Configure a compactacao de contexto:

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

Variaveis de Ambiente

Variaveis de Configuracao

Chaves de API de Provedores

Flags de Comportamento

Substituicao de Variaveis

Variaveis de Ambiente

Referencie variaveis de ambiente na configuracao:

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

Referencias de Arquivo

Inclua conteudo de arquivos:

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

Suporta:

• Caminhos relativos: {file:./path/to/file}
• Caminhos absolutos: {file:/absolute/path}
• Diretorio home: {file:~/path/from/home}

Configuracao LSP

Configure o Language Server Protocol:

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

Defina lsp: false para desabilitar todas as funcionalidades LSP.

Configuracao de Formatador

Configure formatadores de codigo:

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

Defina formatter: false para desabilitar todos os formatadores.

Exemplo Completo

{
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "cyberstrike",
  "theme": "cyberstrike",
  "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
  }
}