Installation

Claudevil runs on Windows, macOS, Linux, and WSL2. Runtime: Bun 1.3+.

Prerequisites

Bun 1.3+ — required runtime for both global installs and source builds
At least one AI provider API key

Via npm (global)

npm install -g @jonusnattapong/claudecode
claudevil

# Verify
claudevil --version

Important: the npm package installs the launcher only. You must install Bun separately before running claudevil.

Via Bun (global)

bun install -g @jonusnattapong/claudecode
claudevil

From Source

git clone https://github.com/JonusNattapong/claudecode.git
cd claudecode
bun install
bun run build
bun run start

# Development mode with watch
bun run dev

Build output goes to dist/. The build uses Bun bundler with compile-time feature defines (TRANSCRIPT_CLASSIFIER, CHICAGO_MCP).

Platform-Specific Notes

Windows

Both cmd and PowerShell supported as shell targets
ripgrep bundled at src/utils/vendor/ripgrep/x64-win32/rg.exe
WSL2 recommended for best experience
Windows argv normalization in src/entry.ts
TTY polyfill for Ink compatibility in src/main.tsx

macOS

Native support with menu bar app integration (moltbot)
Voice Wake and Talk Mode overlays
Keychain prefetch for faster OAuth startup
WebChat and debug tools available

Linux

Full support via terminal
Tailscale Serve/Funnel for remote gateway access

Release Channels

Channel	npm Tag	Description
stable	`latest`	Tagged releases (vYYYY.M.D)
beta	`beta`	Prereleases (vYYYY.M.D-beta.N)
dev	`dev`	Moving main branch

Verifying Installation

/doctor     # Run environment diagnostics
/status     # Check version, model, account, API connectivity