# Installation

Clew 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 clew-code
    clew

    # Verify
    clew --version

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

## Via Bun (global)

    bun install -g clew-code
    clew

## From Source

    git clone https://github.com/JonusNattapong/ClewCode.git
    cd ClewCode
    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