Nulz Code

Free, bring-your-own-key (BYOK) agentic coding CLI. Multi-provider, terminal-native, built for editing code, scraping, and automation. Part of the Nulz Ecosystem.

bun add -g @nulz-rip/code      # or:  npm install -g @nulz-rip/code
nulz

First launch: pick a provider, paste its API key (stored locally in ~/.nulz, never sent anywhere but the provider). Then talk to it like a coding agent.

Update

bun add -g @nulz-rip/code@latest
# or, inside the app:
/update

Providers (15)

Bring your own key for any of:

Gemini · Anthropic (Claude) · OpenRouter · OpenAI · Groq · DeepSeek · Kimi (Moonshot) · xAI (Grok) · Mistral · Together · Fireworks · Perplexity · Cerebras · Ollama (local) · LM Studio (local)

• /provider — switch provider (asks for the key if not saved)
• /model — pick a model; ←/→ switches provider when you have several
• Add several up front in the login flow; switch any time

Three native backends under the hood: Gemini, Anthropic Messages API, and one OpenAI-compatible adapter that covers everyone else.

What it does

• Editing — read/write/edit files with diff-preview approvals, glob, grep, ls
• Shell — run commands (streamed). Read-only commands auto-approve; destructive ones ask. "Always allow" remembers a command. shift+tab = bypass mode
• Web & scraping — web_search, fetch_url, extract_text, download_file, and a headless-browser browser_scrape (Playwright) for JS sites
• Sessions — per-folder, resumable (/resume), with /rewind to restore code and conversation to before any earlier turn
• /compact — summarize old turns so long sessions never hit the context wall
• Context — drop a NULZ.md in a folder (or run /init); @file mentions inject files; /prefs sets your default stack
• Live — thinking tokens, token usage, markdown rendering, image paste (alt+V) for vision models, clipboard copy with char count
• Resilient — auto-retries on provider overload (503/429) with backoff

Scripting / automation

nulz -p "scrape the top HN stories, save to hn.json" -q
echo "summarize package.json" | nulz -p
nulz -c        # continue your last session

-p/--print runs one-shot (no UI), auto-approves tools, prints to stdout. Flags: --provider, --model, -q/--quiet. Cron it for unattended automation.

Keys

| key | action | |-----|--------| | ↑/↓ / wheel | scroll the transcript | | PgUp/PgDn | page scroll · PgDn jumps to bottom | | ctrl+↑/↓ | recall previous prompts | | shift+tab | toggle bypass (auto-approve) | | alt+V | paste a clipboard image | | esc | interrupt a running turn | | Tab | complete a slash command |

Optional: headless browser

browser_scrape needs Chromium once:

bunx playwright install chromium

License

MIT — see LICENSE.