installation

Get Anthracode running.

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

compatibilityWindows x64Linux x64macOS — coming soon

curl

fast path

Linux x64 / WSL shell installer. It uses Node 18+ if present, otherwise installs a local Node.js runtime, then installs Anthracode with optional platform binaries included.

~/install & run

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

npm

recommended

Same binary on Windows x64 and Linux x64. The correct per-platform binary is fetched automatically. Requires Node 18+.

~/install & run

$ npm i -g anthracode-ai
$ anthracode

Windows · x64

native

Runs natively in PowerShell and Windows Terminal — no WSL, no Docker. Process management goes through Win32 APIs.

~/install & run

$ npm i -g anthracode-ai
$ anthracode

Linux · x64

supported

x64 only for now (arm64 follows). If npm skips the optional binary, re-run with --include=optional — postinstall also self-heals by downloading the right binary.

~/install & run

$ npm i -g anthracode-ai
$ anthracode

macOS

planned

Not available yet. macOS builds (Apple Silicon and Intel) are planned and shipping in a later release — watch the GitHub releases.

not available yet — planned for a later release

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.

Can I install with curl?
Yes on Linux x64 or WSL: curl -fsSL https://www.anthracode.com/install | bash. The script uses your existing Node 18+ and npm if available; otherwise it installs a local Node.js runtime under ~/.local/share/anthracode/node, persists PATH, then installs anthracode-ai globally with optional binaries included. On Windows PowerShell, use npm i -g anthracode-ai instead.
Which platforms are supported?
Windows x64 and Linux x64 are supported today — install with npm i -g anthracode-ai on both. macOS builds (Apple Silicon and Intel) are planned and will ship in a later release. On Linux only x64 is built for now; arm64 follows.
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 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.
The Linux binary didn't install — npm skipped the optional dependency.
Re-run with npm i -g anthracode-ai --include=optional. The postinstall step also self-heals: it downloads and extracts the correct anthracode-linux-x64 binary from the npm registry if the optional dependency was skipped (common on WSL/nvm).
How do I update?
Re-run npm i -g anthracode-ai. Anthracode also prints a one-line nag inside the TUI when a newer version is available, and can install the update for you.
Can I pin a specific version?
Yes. npm i -g anthracode-ai@<version>. The current latest npm tag is 1.15.12-anthra138, and the CLI version format is <opencode-base>-anthra<N>.
When is macOS coming?
It's on the roadmap. The cross-compile pipeline already produces Windows and Linux binaries on a single runner; macOS is the next target. Watch the GitHub releases for the announcement.

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