dipoleml
Try Raven
Docs menu

Getting started

Raven App

API

DCode

Account

Resources

Docs

DCode CLI

The DCode agent in a fast, colourful terminal workspace, installed from npm.

The DCode CLI is the same agent as the desktop app, rebuilt in 2.0 as a colourful, fast terminal workspace. It shares your account, your Raven models and your usage allowance.

Install

One line installs DCode and starts it. It checks that Node.js is new enough first and tells you exactly what to do if it is not.

shell
# macOS and Linux
curl -fsSL https://dipoleml.com/install.sh | sh

# Windows (PowerShell)
irm https://dipoleml.com/install.ps1 | iex

Or install with npm, then start it yourself:

shell
npm install -g @dipoleml/dcode-cli
dcode

On first launch DCode signs you in (a free DipoleML account works), shows a short checklist of what works on your computer, and fills the terminal window: header on top, your conversation scrolling in the middle, the message box and your 5-hour and weekly usage pinned at the bottom. Run dcode doctor if anything seems off.

Requires Node.js 22.13 or newer on Windows, macOS or Linux; older versions print a short message explaining what to install. Only the newest release is supported: npm install -g @dipoleml/dcode-cli@latest always upgrades you.

The terminal workspace

  • Launch splash. The DCode disc animates on every interactive launch, in white on dark terminals and black on light ones. It stays still when output is not a terminal, in CI, or when NO_COLOR is set.
  • Streaming answers with rendered Markdown, collapsible tool blocks, syntax-coloured diffs, and approval prompts for every write.
  • Status line showing the model, permission mode, context used, working folder and git branch.
  • Live Crew panel. When DCode splits a task across up to 24 agents, the panel lists each agent, its state and the token meter. Crews are metered in tokens only, never a price.
  • Slash commands and files. Type / for commands and @ to attach a file, then Tab to complete.
  • Colour that adapts. Truecolor, with 256 and 16 colour fallbacks. NO_COLOR and FORCE_COLOR are honoured.

Keys

  • Enter sends. While DCode is working, your message waits in a queue.
  • then Enter, Alt+Enter or Ctrl+J adds a new line.
  • Esc or Ctrl+C interrupts the running turn. Press Ctrl+C twice on an empty prompt to exit.
  • Shift+Tab cycles the permission mode. Ctrl+O or /expand shows the full output of a tool call.

One prompt, then exit

shell
dcode -p "Explain the failing tests in this repository"

Use this in scripts and CI. If you are not signed in it says so and exits with code 2, so a pipeline can tell the difference.

Signing in

dcode login opens your browser to approve the sign-in. If your Dipole ML account has two-factor authentication, the CLI asks for the 6-digit code from your authenticator app. You get three tries, and it tells you if you are rate limited. Use dcode login --no-browser on a machine without a browser and open the printed link on another device.

Skills, MCP servers and plugins

The CLI syncs the public DipoleML catalog of skills, MCP servers and plugins in the background, so what you install in the desktop app is available in the terminal too.