Prerequisites

• Node.js 20.19+ (or 22.12+) — if Node.js is not installed, the launcher will offer to download a portable copy automatically (Windows only, ~30 MB one-time download, stored in %LOCALAPPDATA%\Strada\node). You can also point to a custom binary with STRADA_NODE_PATH.
• At least one supported AI provider configured (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, etc.), a Claude subscription token (ANTHROPIC_AUTH_MODE=claude-subscription + ANTHROPIC_AUTH_TOKEN), an OpenAI ChatGPT/Codex subscription session (OPENAI_AUTH_MODE=chatgpt-subscription), or an ollama-only PROVIDER_CHAIN
• A Unity project (the path you give the agent). Strada.Core is recommended for full framework-aware assistance; without it, Strada.Brain still runs with reduced Strada-specific guidance.

1. Install

```bash

Clone from source (currently the canonical install path)

git clone https://github.com/okandemirel/Strada.Brain.git Strada.Brain

2. Setup

```bash

Interactive setup wizard (terminal or web browser)

./strada setup

Skip the chooser and jump straight into one setup surface

./strada setup --web ./strada setup --terminal

Or, after installing the user-local command

strada doctor

2. claude setup-token

ANTHROPIC_AUTH_MODE=claude-subscription ANTHROPIC_AUTH_TOKEN=sk-ant-sid01-...

Bare command after `./strada install-command`

strada

Installing skills

```bash

Install from any public git repository

strada skill install https://github.com/okandemirel/strada-skill-example

List installed skills and their status

strada skill list

Show details for an installed skill

strada skill info <name>

Deployment Subsystem

An opt-in deployment system with human-in-the-loop approval gates and circuit breaker protection.

ReadinessChecker: - Validates system readiness before deployment (build status, test results, resource availability) - Configurable readiness criteria

DeployTrigger: - Integrates with the daemon's trigger system as a new trigger type - Fires when deployment conditions are met (e.g., all tests pass, approval granted) - Includes an approval queue: deployments require explicit human approval before execution

DeploymentExecutor: - Executes deployment steps in sequence with rollback capability - Environment variable sanitization prevents credential leakage in deployment logs - Circuit breaker: consecutive deployment failures trigger automatic cooldown to prevent cascading failures

Security: Deployment is disabled by default and requires explicit opt-in via configuration. All deployment actions are logged and auditable.

---

Quick Start

Optional shorter shell

cd Strada.Brain

Optional: enable internal system auth / JWT sessions

JWT_SECRET=<generate with: openssl rand -hex 64> ```

Start your configured default channel directly in daemon mode

./strada --daemon

Configuration Reference

All configuration is via environment variables. See .env.example for the full list.

Minimum Runtime Config

Claude via API key

ANTHROPIC_API_KEY=sk-ant-...

Interactive CLI mode (fastest way to test)

./strada start --channel cli

4. CLI Commands

./strada                  # Canonical source-checkout launcher
.\strada.ps1             # Canonical Windows PowerShell source-checkout launcher
strada.cmd               # Windows Command Prompt companion launcher inside the checkout
node strada.js            # Universal Node.js entry point (works on any OS without shell wrappers)
./strada install-command  # Install a user-local bare `strada` command
.\strada.ps1 install-command # Windows source-checkout bare-command install
./strada uninstall        # Remove the installed bare command and managed PATH/profile changes
.\strada.ps1 uninstall    # Windows source-checkout bare-command uninstall
strada uninstall --purge-config # Also remove Strada runtime state and source-checkout generated artifacts for a zero-install rerun
strada                    # Smart launcher after install-command
strada --daemon           # Start the configured default channel in daemon mode
strada --web              # Open the web channel, or continue web-first setup on a fresh machine
strada --terminal         # Open the terminal channel, or force terminal setup on a fresh machine
./strada setup --web      # Launch the browser wizard directly
./strada setup --terminal # Use the terminal wizard directly
.\strada.ps1 setup --web  # Windows PowerShell browser wizard
.\strada.ps1 setup --terminal # Windows PowerShell terminal wizard
./strada doctor           # Verify install/build/config readiness
.\strada.ps1 doctor       # Windows PowerShell readiness check
./strada start            # Start the agent
./strada supervise        # Run with auto-restart supervisor
./strada update           # Check and apply updates
./strada update --check   # Check for updates without applying
./strada version-info     # Show version, install method, update status

Strada.MCP Integration

Strada.Brain detects an installed Strada.MCP, verifies the package root, and loads only MCP action tools that are executable in the current Brain runtime into the main toolchain. Detection can be pinned with STRADA_MCP_PATH, while missing Strada.Core / Strada.Modules installs use the explicit STRADA_CORE_REPO_URL and STRADA_MODULES_REPO_URL config values instead of hidden env fallbacks. Installed Strada.Core and Strada.MCP docs/sources remain authoritative knowledge even when bridge or runtime constraints keep some MCP prompts/resources/tools out of the live worker tool surface.

---