README.md

April 1, 2026 · View on GitHub

npm downloads stars license

Darce

AI coding agent that lives in your terminal.
Reads, writes, edits code, runs commands, searches codebases.
One command to install. One command to start.

Website · npm · Get Started · Pricing · Dashboard


> fix the authentication bug in login.ts

  I'll read the file first.

  ○ Read src/auth/login.ts
    1  import { verify } from './jwt'
    ... 45 more lines

  Found it — token expiry compares seconds vs milliseconds.

  ● Edit src/auth/login.ts
    File updated

  ● Bash npm test
    24/24 tests passing

  Fixed. Wrapped the Unix timestamp in * 1000.

qwen3-coder · 3.1k tokens · \$0.0008 · 6s

Why Darce?

DarceClaude CodeCursorGitHub Copilot CLI
Works in any terminalYesYesNo (IDE only)Partial
Any model (Claude, Grok, Gemini, DeepSeek, Llama)YesClaude onlyLimitedGPT only
Reads + edits filesYesYesYesNo
Runs shell commandsYesYesNoYes
Smart model switchingYesNoNoNo
Free tierYesNoNoNo
Open sourceYesPartialNoNo
Install time3 secondsMinutesMinutesMinutes
Package size14 kB~200 MB~500 MB~100 MB

Get Started

npm install -g darce-cli
darce login
darce

That's it. No config files. No API keys to copy. No Docker.

What Can It Do?

Fix bugs — Describe the issue, Darce reads the code, finds the problem, fixes it, runs your tests.

Build features — "Add a dark mode toggle to the settings page" — Darce creates the files, writes the code, wires everything up.

Refactor — "Convert this class component to a hook" — reads the file, rewrites it, verifies nothing broke.

Explore codebases — "How does authentication work in this project?" — searches files, reads code, explains the architecture.

Run commands — "Install tailwind and set it up" — runs npm, creates config files, updates your code.

Features

/help     List commands          Ctrl+M   Switch models
/model    Change model           Ctrl+C   Cancel / Exit
/clear    Reset conversation     Up/Down  Input history
/cost     Session costs          """      Multi-line mode
/compact  Shrink context
  • 7 tools — Read, Write, Edit, Bash, Glob, Grep, WebFetch
  • Smart routing — auto-picks the best model for each task
  • Streaming — responses appear line-by-line as they generate
  • Git-aware — knows your branch, changes, and recent commits
  • Session resumedarce --resume picks up where you left off
  • Context compaction — stays fast even in long conversations
  • Cost tracking — real-time token count and spend in the status bar
  • Account dashboard — usage stats at cli.darce.dev/dashboard

Models

Switch mid-conversation with Ctrl+M or /model.

ModelBest forSpeed
qwen/qwen3-coderGeneral coding (default)Fast
x-ai/grok-4.1-fastComplex reasoningFast
anthropic/claude-sonnet-4Precise codingMedium
google/gemini-2.5-proHuge codebases (1M ctx)Medium
deepseek/deepseek-r1Deep reasoningSlower
deepseek/deepseek-chatQuick questionsVery fast
meta-llama/llama-4-maverickOpen source (1M ctx)Fast

Pricing

Start free. Upgrade when you need more. Cancel anytime.

StarterBuilderPower
PriceFree$15/mo$65/mo
Requests25/mo500/mo2,500/mo
Modelsqwen3-coderAllAll + priority
Tools3 (Read, Grep, Glob)All 7All 7
SessionsNo resumeResume + historyResume + history
DashboardBasicFullFull + priority support
darce login           # Start free
darce upgrade         # Upgrade to Builder or Power

Or sign up at cli.darce.dev

Slash Commands

CommandDescription
/helpList all commands
/model <id>Switch model (/m alias)
/clearClear conversation (/c alias)
/costShow session cost breakdown
/compactCompact conversation history
/quitExit (/q alias)

Config

darce login handles everything. For power users:

// ~/.darcerc
{
  "apiKey": "darce-...",
  "apiBase": "https://api.darce.dev",
  "router": {
    "default": "qwen/qwen3-coder",
    "rules": [
      { "when": "large-context", "use": "google/gemini-2.5-pro" },
      { "when": "complex-reasoning", "use": "x-ai/grok-4.1-fast" }
    ]
  }
}

Contributing

git clone https://github.com/AmerSarhan/darce-cli.git
cd darce-cli
npm install
npm run dev           # Run from source
npx tsx test.ts       # 106 tests
npm run build         # Build for production

Star History

If Darce saved you time, drop a star. It helps others find it.

Star History Chart


Built by darce.dev
MIT License