nan

CLI for nan.builders — manage your account, monitor usage, and auto-configure AI coding tools with the NaN API.

Install

curl -fsSL https://nan.builders/install | bash

By default installs to /usr/local/bin. Override with INSTALL_DIR:

INSTALL_DIR=~/.local/bin curl -fsSL https://nan.builders/install | bash

Usage

Run nan to open the TUI dashboard:

nan

Navigate with ←/→ between tabs, ↑/↓ to scroll, r to refresh, ? for help, q to quit.

Tabs

Tab	Description
Profile	Your nan.builders account details
Usage	Token usage across the last 24h, 30 days, and all time
Models	Available models and your usage per model
Costs	Estimated cost comparison against other providers
Setup	API key management and tool auto-configuration
About	Version and links

Setup tab

The Setup tab lets you configure AI coding tools to use the NaN API automatically. Supported tools:

• OpenCode
• Factory AI (droid)
• Pi
• Codex

Press e to set your API key, space to toggle tools, and c to apply the configuration.

Build from source

Requires Go 1.26+ (mise recommended):

git clone https://github.com/helmcode/nan-cli
cd nan-cli
go build -o nan .
./nan

Contributing

See CONTRIBUTING.md.