https://github.com/helmcode/nan-cli
https://github.com/helmcode/nan-cli
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/helmcode/nan-cli
- Owner: helmcode
- Created: 2026-05-21T17:44:52.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-01T19:18:56.000Z (20 days ago)
- Last Synced: 2026-06-01T21:15:43.329Z (20 days ago)
- Language: Go
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# nan
CLI for [nan.builders](https://nan.builders) — manage your account, monitor usage, and auto-configure AI coding tools with the NaN API.
## Install
```bash
curl -fsSL https://nan.builders/install | bash
```
By default installs to `/usr/local/bin`. Override with `INSTALL_DIR`:
```bash
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](https://opencode.ai)
- [Factory AI](https://factory.ai) (`droid`)
- [Pi](https://pi.ai)
- [Codex](https://github.com/openai/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](https://mise.jdx.dev/) recommended):
```bash
git clone https://github.com/helmcode/nan-cli
cd nan-cli
go build -o nan .
./nan
```
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).