installation

Get Anthracode running.

Pick your platform. One command. Anthracode is a single TUI binary — no daemons, no background services, no cloud account required.

npm

recommended

~/install & run

$ npm i -g anthracode-ai
$ anthracode

macOS

~/homebrew

$ brew tap anthracode/tap
$ brew install anthracode
$ anthracode

Linux

~/curl

$ curl -fsSL https://anthracode.com/install.sh | sh
$ anthracode

Windows

native

~/scoop or winget

$ scoop bucket add anthracode https://github.com/rafa57600/anthracode-scoop
$ scoop install anthracode
# or
$ winget install Anthracode.Anthracode
$ anthracode

From source

~/clone & build

$ git clone https://github.com/rafa57600/anthracode.git
$ cd anthracode
$ pnpm install
$ pnpm build
$ pnpm link --global
$ anthracode

after install

01 Run anthracode in any project directory. It creates .anthracode/ with local memory and config.

02 Set your model with /model. Bring your own key: Anthropic, OpenAI, or any OpenAI-compatible endpoint.

03 Type /help inside the TUI to discover commands, memory tiers, skills, and processes.

faq

Quick answers to install-time questions. Open an issue on GitHub if yours isn't here.

Which install method should I pick?
npm if you already have Node — it's the same binary on every OS and the fastest path to running. Use Homebrew, Scoop, or winget if you prefer your package manager handling updates. Build from source only if you're contributing.
Does Anthracode need a cloud account to run?
No. The TUI runs fully offline against any model you point it at — Anthropic, OpenAI, or any OpenAI-compatible local LLM. A free anthracode.com account is only required for Pro features like memory cloud sync.
Why a native Windows binary instead of WSL?
WSL adds a Linux dependency, slow filesystem bridges, and a different process model than the rest of your dev tools. Anthracode ships a real Win32 binary so PowerShell, paths, and process management all behave the way Windows users expect.
How do I update?
Re-run the install command for your platform: npm i -g anthracode-ai, brew upgrade anthracode, scoop update anthracode, etc. Anthracode itself prints a one-line nag inside the TUI when a newer version is available.
How do I uninstall?
npm uninstall -g anthracode-ai (or the brew/scoop/winget equivalent). Local state lives in .anthracode/ inside your projects and ~/.anthracode/ for account-scope memory — delete those directories if you want a clean slate.
Can I pin a specific version?
Yes. npm i -g anthracode-ai@0.0.6 (or any published tag). Homebrew + Scoop both expose @version syntax. From source, git checkout the tag before pnpm build.

Stuck? Open an issue or email hi@anthracode.com.