Install

Two primary install paths: use the curl installer on Linux/WSL, or install the published npm package everywhere. Source builds are covered at the end for contributors.

npm package facts

Latest npm tag: anthracode-ai@1.15.12-anthra138. The package has 0 runtime dependencies, 89 published versions, and ships native optional binaries for Windows x64 and Linux x64.

Platform support

Windows x64 and Linux x64 are supported today. macOS builds (Apple Silicon and Intel) are planned and will ship in a later release.

Option A — curl

Linux x64 / WSL shortcut. Node 18 or later and npm are required; the script verifies both before installing the published package.

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

Option B — npm (recommended for Windows)

Node 18 or later is required.

npm i -g anthracode-ai

Verify the install:

anthracode --version

If the Linux binary didn’t install (npm sometimes skips the per-platform 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).

Option C — build from source (contributors)

For contributors and people who want the absolute latest from anthracode/dev.

Prerequisites

• Bun 1.3.14 stable or newer. Do not use canary for release builds.
• Git, any version.
• A terminal. Anthracode is TUI-only; no web, desktop, or hosted server target is supported in this branch.

On Windows, make sure node-gyp prerequisites (Visual Studio Build Tools + Python) are on PATH if any native deps need rebuilding.

Clone & install

git clone https://github.com/rafa57600/anthracode.git
cd anthracode
bun install

Build the TUI binary

cd packages/anthracode
bun run script/build.ts --single --skip-install

This produces packages/anthracode/bin/anthracode — a self-contained executable.

Install the command globally

cd packages/anthracode
npm install -g .