Getting Started

Cyberstrike is an AI-powered penetration testing agent that automates security assessments. This guide covers installation, authentication, and running your first scan.

System Requirements

Before installing Cyberstrike, verify your system meets these requirements:

Installing Cyberstrike

Choose your preferred installation method based on your operating system and package manager.

npm (Recommended)

1. Open your terminal
2. Run the installation command:

npm install -g cyberstrike

3. Verify the installation:

cyberstrike --version

Bun

1. Install Bun if not already installed:

curl -fsSL https://bun.sh/install | bash

2. Install Cyberstrike:

bun install -g cyberstrike

Homebrew (macOS)

1. Add the Cyberstrike tap:

brew tap CyberStrikeus/tap

2. Install Cyberstrike:

brew install cyberstrike

curl (Linux/macOS)

Run the installation script:

curl -fsSL https://cyberstrike.io/install.sh | bash

Docker

Pull and run the official Docker image:

docker pull cyberstrike/cyberstrike:latest
docker run -it cyberstrike/cyberstrike

Authenticating with an AI Provider

Cyberstrike requires an AI provider to function. The following providers are supported:

Setting Up Authentication

1. Run the authentication command:

cyberstrike auth login

2. Select your provider from the list:

? Select provider
❯ OpenRouter (free tier available)
  Anthropic (API key from console.anthropic.com)
  OpenAI (ChatGPT Plus/Pro or API key)
  Google (API key from ai.google.dev)
  Ollama (local models)
  Other

3. Enter your API key when prompted

4. Verify your credentials:

cyberstrike auth list

Using Environment Variables

Set API keys as environment variables instead of storing them:

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

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

# Google
export GOOGLE_API_KEY="AI..."

# OpenRouter
export OPENROUTER_API_KEY="sk-or-..."

Add these to your shell profile (~/.bashrc, ~/.zshrc) for persistence.

Running Your First Scan

Starting Interactive Mode

Launch Cyberstrike in your target directory:

cd /path/to/target
cyberstrike

The terminal user interface (TUI) appears with:

• Input prompt at the bottom
• Response area in the center
• Status bar showing model and token usage

Executing a Quick Scan

Run a single command without entering interactive mode:

cyberstrike run "perform reconnaissance on example.com"

Selecting a Security Agent

Cyberstrike includes specialized agents for different assessment types:

# Web application security
cyberstrike --agent web-application

# Cloud infrastructure
cyberstrike --agent cloud-security

# Network penetration testing
cyberstrike --agent internal-network

# Bug bounty reconnaissance
cyberstrike --agent bug-hunter

Basic Configuration

Create a project configuration file for consistent settings:

cyberstrike init

This creates cyberstrike.json in your current directory:

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

Configuration Hierarchy

Cyberstrike loads configuration from multiple sources in this order:

1. Command line arguments (highest priority)
2. Environment variables
3. Project config (cyberstrike.json)
4. User config (~/.cyberstrike/config.json)
5. Default values (lowest priority)

Keyboard Shortcuts

Learn these shortcuts for efficient navigation:

Next Steps

Continue learning with these guides:

1. Configuration Reference - Customize Cyberstrike settings
2. AI Providers - Configure your preferred AI provider
3. Security Agents - Learn about specialized agents
4. CLI Commands - Complete command reference