Package Exports

@nulz-rip/code

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nulz-rip/code) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.