CLI Commands

Cyberstrike provides a powerful command line interface for security assessments. This reference covers all available commands, options, and usage patterns.

Command Structure

cyberstrike [global-options] <command> [command-options] [arguments]

Global Options

Interactive Mode

Launch the terminal user interface without arguments:

cyberstrike

Interactive Mode Options

Examples

# Start with specific model
cyberstrike --model anthropic/claude-sonnet-4-20250514

# Select a primary agent (only 'cyberstrike' ships built-in)
cyberstrike --agent cyberstrike

# Continue previous session
cyberstrike --continue

run

Execute a single prompt without entering interactive mode.

cyberstrike run [message..] [options]

Options

Examples

# Run single command
cyberstrike run "scan example.com for open ports"

# Attach file to request
cyberstrike run "analyze this config" -f nginx.conf

# Output as JSON
cyberstrike run "list vulnerabilities" --format json

# Continue previous session
cyberstrike run "now check for XSS" --continue

Piping Input

Accept input from stdin:

echo "analyze this code" | cyberstrike run
cat report.txt | cyberstrike run "summarize this"

auth

Manage authentication credentials for AI providers.

auth login

Add credentials for an AI provider:

cyberstrike auth login [url]

Interactive Login

cyberstrike auth login
# Select provider from list
# Enter API key when prompted

Well-Known URL Login

cyberstrike auth login https://custom-provider.example.com

auth logout

Remove stored credentials:

cyberstrike auth logout
# Select provider from list

auth list

Display all configured credentials:

cyberstrike auth list

Output shows:

• Stored credentials by provider
• Authentication type (api, oauth)
• Active environment variables

mcp

Manage Model Context Protocol (MCP) servers.

mcp list

List configured MCP servers and their status:

cyberstrike mcp list

Status indicators:

• ✓ Connected
• ○ Not initialized / Disabled
• ⚠ Needs authentication
• ✗ Failed

mcp add

Add a new MCP server interactively:

cyberstrike mcp add

The wizard prompts for:

1. Location (project or global)
2. Server name
3. Server type (local or remote)
4. Connection details

Local Server Example

# After running `cyberstrike mcp add`:
# Location: Current project
# Name: filesystem
# Type: Local
# Command: npx @modelcontextprotocol/server-filesystem /path/to/dir

Remote Server Example

# After running `cyberstrike mcp add`:
# Location: Global
# Name: custom-api
# Type: Remote
# URL: https://api.example.com/mcp
# OAuth: Yes/No

mcp auth

Authenticate with an OAuth-enabled MCP server:

cyberstrike mcp auth [name]

mcp auth list

List OAuth status for all MCP servers:

cyberstrike mcp auth list

mcp logout

Remove OAuth credentials:

cyberstrike mcp logout [name]

mcp debug

Debug OAuth connection issues:

cyberstrike mcp debug <name>

session

Manage conversation sessions.

session list

List all sessions:

cyberstrike session list [options]

Examples

# List 10 most recent sessions
cyberstrike session list -n 10

# Export as JSON
cyberstrike session list --format json

models

List available AI models.

cyberstrike models

Displays all models organized by provider with:

• Model identifier
• Model name
• Capabilities

agent

Manage security agents.

cyberstrike agent [name]

Listing Agents

cyberstrike agent
# Shows available agents

Agent Information

cyberstrike agent web-application
# Shows agent details and prompt

github

GitHub App integration.

github install

Install the Cyberstrike GitHub App into a repository:

cyberstrike github install

github run

Run Cyberstrike against a GitHub event (used by the CI workflow):

cyberstrike github run

pr

Review a pull request by number.

cyberstrike pr <number>

export

Export a session as JSON to stdout (no options):

cyberstrike export [sessionID]

import

Import session data.

cyberstrike import <file> [options]

upgrade

Update Cyberstrike to the latest version.

cyberstrike upgrade

uninstall

Remove Cyberstrike from your system.

cyberstrike uninstall

serve

Start the Cyberstrike API server. Requires CYBERSTRIKE_SERVER_PASSWORD to be set.

CYBERSTRIKE_SERVER_PASSWORD=secret cyberstrike serve [options]

stats

Display usage statistics.

cyberstrike stats

Shows:

• Token usage
• Session counts
• Cost estimates

completion

Generate shell completion scripts.

# Bash
cyberstrike completion >> ~/.bashrc

# Zsh
cyberstrike completion >> ~/.zshrc

# Fish
cyberstrike completion | source

Environment Variables

Configure Cyberstrike behavior through environment variables:

Exit Codes

Configuration Files

Cyberstrike reads configuration from these locations:

See Configuration Reference for schema details.