NightCode CLI

A terminal-based AI coding agent powered by Bun, OpenTUI, and the AI SDK. Plan, chat, and build inside your project without leaving the terminal.

Quick start

# Run directly (no install)
npx @drewsepsi/nightcode

# Or install globally
npm install -g @drewsepsi/nightcode
nightcode

The CLI opens an OAuth flow in your browser to authenticate on first use.

Configuration

Set these in a .env file in the directory where you run NightCode, or export them in your shell:

| Variable | Required | Description | |----------|----------|-------------| | API_URL | Yes | URL of the NightCode API server (e.g. https://nightcode-api.example.com) | | OPENROUTER_API_KEY | Yes | OpenRouter API key for AI model access |

Example .env:

API_URL=https://nightcode-api.example.com
OPENROUTER_API_KEY=sk-or-v1-...

Modes

• Plan — read-only tools: read files, search code, list directories. Safe for exploring.
• Build — full tool access: edit files, write code, run shell commands.

Press tab to open the command menu and switch modes, change models, or manage sessions.

Requirements

Bun runtime (the CLI runs on Bun, not Node.js).

Links

• GitHub
• Issues