Install & First Run

Prerequisites

  • Node.js 20+ — node --version
  • git — required for marketplace plugin/workflow resolution
  • Claude Code and/or OpenAI Codex — at least one agent runtime installed and authenticated

Install

npm install -g @drisp/cli

This installs two binaries:

drisp                  # main CLI
drisp-hook-forwarder   # internal hook bridge (called by Claude Code)

Verify:

drisp --version

First Run

cd /your/project
drisp

On first launch, the setup wizard runs automatically.

Step 1: Theme

ThemeDescription
darkDefault. Dark terminal backgrounds.
lightLight terminal backgrounds.
high-contrastMaximum contrast for accessibility.

Step 2: Harness

HarnessStatus
claude-codeProduction
openai-codexProduction
opencodeComing soon

The wizard detects which agent runtimes are installed.

Step 3: Workflow (optional)

Optionally activate a workflow for your sessions. You can skip this and activate workflows later with --workflow.

Choices are saved to ~/.config/drisp/config.json. Re-run the wizard any time:

drisp setup

Common Launch Patterns

# Resume the most recent session
drisp resume
 
# Resume a specific session
drisp resume <session-uuid>
 
# Pick a session interactively
drisp sessions
 
# Start with a workflow
drisp --workflow=e2e-test-builder
 
# Run non-interactively (CI/scripts)
drisp exec "run all tests"
 
# Change isolation level
drisp --isolation=permissive
 
# ASCII-safe glyphs for limited terminals
drisp --ascii

Updating

npm update -g @drisp/cli

Platform Support

macOS and Linux. On Windows, use WSL (Unix Domain Socket requirement).