lupacode

AI-powered terminal coding assistant.

Install globally

Requires Bun >= 1.0.

# Remove any old global install first (important on Windows)
npm uninstall -g lupacode

# Install latest
bun install -g lupacode
# or
npm install -g lupacode

Then run from any directory:

lupacode

Verify the version in the footer (e.g. v1.0.2).

Configuration

Global config lives in ~/.lupacode/ (same on every machine/user):

| File | Purpose | |---|---| | ~/.lupacode/.env | Optional env overrides (see below) | | ~/.lupacode/auth.json | Saved login token (created by /login) | | ~/.lupacode/preferences.json | Theme, model, mode preferences |

| Env var | Default | Description | |---|---|---| | API_URL | https://lupacodeserver-production.up.railway.app | LupaCode API server |

Example ~/.lupacode/.env (only if you need a custom server):

API_URL=https://lupacodeserver-production.up.railway.app

The CLI does not read .env from your current project folder, so running lupacode in a repo with API_URL=http://localhost:3000 will not break the global install.

Authentication

Type /login in the CLI — it opens your browser for Clerk OAuth.

Local development (monorepo)

bun run dev:cli

Dev mode uses Bun's normal .env loading from the repo root for local server testing.