radical-code

Install radical-code — a Rust-based multi-agent AI development framework — from npm.

npm install -g radical-code
radical-code init     # interactive setup wizard
radical-code          # start the TUI

What you get

• radical-code binary (static musl build; runs on any linux-x64 distro, no OpenSSL/glibc version requirements).
• Setup wizard (radical-code init): pick providers (Anthropic, OpenAI, Bedrock, Vertex, or custom LiteLLM-style endpoints), pick models, set a default, and bind agent roles — all persisted to an encrypted local store (~/.local/share/radical-code/config.db + secrets vault, keys encrypted at rest, files 0600).

How the wrapper works

The radical-code command is a thin Node shim that locates the bundled static binary and execs it. The shim resolves bin/radical-code-linux-x64 directly, so the package works even on npm installs where postinstall scripts are blocked (e.g. --ignore-scripts). Postinstall is only a convenience copy that duplicates the binary to bin/radical-code; it is not required for the package to function.

Commands

| Command | What it does | |---|---| | radical-code init | Interactive setup wizard (providers, models, defaults, agent bindings) | | radical-code | Terminal UI | | radical-code repl | Simple REPL | | radical-code "<prompt>" | One-shot prompt against the configured default provider | | radical-code dispatch <role> "task" | Dispatch to a specialist agent (planner, developer, reviewer, ...) | | radical-code workflow <name> -i '{}' | Run a workflow (code_development, bug_fix, code_review, refactoring) | | radical-code team <preset> "task" | Run a 2x/4x agent team | | radical-code mcp serve | Expose radical-code as an MCP brain server | | radical-code --version | Print the installed version |

API keys

Keys captured by the wizard are stored encrypted. Environment variables are also honored (env wins over the vault, and is never written to disk): ANTHROPIC_API_KEY, OPENAI_API_KEY, LITELLM_API_KEY.

Platforms

This package currently ships a prebuilt binary for linux-x64. Other platforms: build from source with cargo install --git https://github.com/TheArchitectit/RADICAL-CODE radical-code, or set RADICAL_CODE_BIN=/path/to/radical-code to point this wrapper at any local build.

Configuration locations

• Config + secrets: ~/.local/share/radical-code/ (override with RADICAL_CODE_CONFIG_DB / RADICAL_CODE_SECRETS_DB)
• Project agents scaffolded by the wizard: .radco/agents/