DisCo is a skill-powered research agent with separate Creator and Researcher modes. It combines bundled research skills and dynamic workflows with a terminal interface that can also be extended through TypeScript extensions, skills, prompt templates, themes, and DisCo packages.
Install DisCo with npm:
npm install -g --ignore-scripts @arex-skill/disco--ignore-scripts disables dependency lifecycle scripts during install. DisCo does not require install scripts for normal npm installs.
Other supported entry points are:
# macOS / Linux / WSL / Git Bash
curl -fsSL https://github.com/VectorSpaceLab/AREX-Skill/releases/latest/download/install-disco.sh | sh
# pnpm
pnpm add -g --ignore-scripts @arex-skill/disco
# Bun
bun add -g --ignore-scripts @arex-skill/discoOn Windows PowerShell, use:
powershell -NoProfile -ExecutionPolicy Bypass -Command "& { irm https://github.com/VectorSpaceLab/AREX-Skill/releases/latest/download/install-disco.ps1 | iex }"The curl and PowerShell commands use the DisCo managed installer. It keeps
releases and optional managed runtimes under the user-level DisCo directory and
refuses to overwrite an unrelated disco command. See the repository's
Installation Guide
for managed update, uninstall, and Windows shell details.
To uninstall DisCo after an npm installation:
npm uninstall -g @arex-skill/discoFor pnpm, Yarn, or Bun installs, use the matching global remove command: pnpm remove -g @arex-skill/disco, yarn global remove @arex-skill/disco, or bun uninstall -g @arex-skill/disco. For a managed curl/PowerShell installation, use the persisted installer with its uninstall option; do not remove the user-level ~/.disco/agent directory.
Then run it in a project directory:
discoAuthenticate with /login for subscription providers, or set an API key such as ANTHROPIC_API_KEY before starting disco.
For the full first-run flow, see Quickstart.
- Quickstart - install, authenticate, and run a first session.
- Using DisCo - interactive mode, slash commands, context files, and CLI reference.
- Dynamic workflows - run, monitor, author, recover, and inspect coordinated subagent workflows.
- Providers - subscription and API-key setup for built-in providers.
- llama.cpp - run a local router and manage models with
/llama. - Security - project trust, sandbox boundaries, and vulnerability reporting.
- Containerization - sandbox disco with Gondolin, Docker, or OpenShell.
- Settings - global and project settings.
- Keybindings - default shortcuts and custom keybindings.
- Sessions - session management, branching, and tree navigation.
- Compaction - context compaction and branch summarization.
- Extensions - TypeScript modules for tools, commands, events, and custom UI.
- Skills - Agent Skills for reusable on-demand capabilities.
- Prompt templates - reusable prompts that expand from slash commands.
- Themes - built-in and custom terminal themes.
- DisCo packages - bundle and share extensions, skills, prompts, and themes.
- Custom models - add model entries for supported provider APIs.
- Custom providers - implement custom APIs and OAuth flows.
- SDK - embed disco in Node.js applications.
- RPC mode - integrate over stdin/stdout JSONL.
- JSON event stream mode - print mode with structured events.
- TUI components - build custom terminal UI for extensions.
- Environment variables - DisCo process configuration and session metadata available to bash tools.
- Session format - JSONL session file format, entry types, and SessionManager API.
- Development - local setup, project structure, and debugging.