@localcode/cli · v2.1 · MIT

Code
locally.
Think freely.

A terminal AI coding assistant that runs on your machine. Works with Ollama, Claude, OpenAI, or Groq. Built by TheAlxLabs, co-piloted by Nyx.

↓ Install now ⎇ GitHub
4
Providers
13
Commands
6
Tool types
localcode — ~/projects/myapp
Runs local with Ollama Permission prompts before writes Streaming diffs Checkpoint system Co-authored by Nyx Claude · OpenAI · Groq · Ollama @file context injection TypeScript · Node 18+ MIT License Runs local with Ollama Permission prompts before writes Streaming diffs Checkpoint system Co-authored by Nyx Claude · OpenAI · Groq · Ollama @file context injection TypeScript · Node 18+ MIT License
How it works

From install to
first commit.

LocalCode is a single npm package. No config files, no daemons. Just a terminal.

↓
01

Install

npm install -g @localcode/cli. One command, Node 18+ required. Ollama optional.

◈
02

Setup wizard

First launch walks you through picking a provider, checking Ollama, and entering an API key if needed.

❯
03

Chat & code

Ask anything. LocalCode reads files, writes patches, runs shell commands — always asking permission first.

⎇
04

Commit with Nyx

Run /commit to generate a conventional commit message. Nyx is automatically added as co-author.

Features

Built different.

Every feature stays out of your way — until you need it.

⚿

Permission prompts

Every file write, patch, or delete asks before executing. Press y yes, n no, or a to allow all for the session.

Safety
±

Streaming diffs

After every file edit you see the exact lines added and removed — inline, immediately, before the model continues.

Transparency
◉

Checkpoints

Snapshot full session state before risky changes. /checkpoint before-refactor and restore with /restore.

Safety net
@

Context injection

Reference any file or folder inline: @src/auth.ts injects a file, @src/ injects the whole tree.

Context
⎇

AI-generated commits

/commit reads your staged diff and writes a conventional commit message. Nyx co-authors every one.

Git
⊟

Conversation compact

Long sessions burn through context fast. /compact asks the model to summarize and replaces all messages with that summary.

Context window
◈

Multi-provider

Switch between Ollama, Claude, OpenAI, and Groq at runtime with /provider. Keys are stored per-provider.

Flexibility
↑↓

Shell history

Arrow keys navigate your message history just like a real shell. Your last 100 messages are kept per session.

UX
◎

Session status

/status shows provider, model, API key, message count, estimated token usage, and checkpoints at a glance.

Observability
/\_/\ ( ·.· ) > ♥ <
Your co-pilot

Meet Nyx.

Nyx is LocalCode's ASCII cat mascot. She lives in the header of every session, reacting in real time to what's happening — thinking when the model is working, lighting up green on success, going red on errors.

She's not just decoration. Every git commit made through /commit is tagged with her co-author signature, so she shows up as a real contributor on your GitHub repos.

Co-authored-by: Nyx <nyx@thealxlabs.ca>
Mood states
idle · thinking · happy · error · waiting
Co-author email
nyx@thealxlabs.ca
Appears in
Header · Commits · Errors · Setup wizard
Created by
TheAlxLabs · Toronto
Reference

Every command.

Type / in the app to open the interactive command picker with full descriptions and usage hints.

/clearClear conversation history. Checkpoints are preserved.session
/compactSummarize & compress the conversation to save context window.session
/statusShow provider, model, key status, token count, checkpoints.session
/checkpointSave a named snapshot. Usage: /checkpoint before-refactorsession
/restoreList or restore a saved checkpoint by ID.session
/exitSave session state and quit the application.session
/contextInject a file or folder into the conversation. Usage: /context src/context
/diffShow all files modified by tool calls in this session.context
/commitGenerate a conventional commit from staged changes. Nyx co-authors.git
/allowallToggle permission prompts for all tool calls this session.tools
/providerList or switch providers. Usage: /provider claudeproviders
/apikeySet API key for current provider. Usage: /apikey sk-ant-…providers
/modelSwitch model for the active provider. Usage: /model qwen2.5-coder:7bproviders
Providers

Your model,
your choice.

Switch at runtime with /provider <name>. API keys are stored per-provider and loaded from env automatically.

Ollama qwen2.5-coder · llama3.2 · mistral · deepseek-r1 · gemma3 Free · Local · No key Needs Ollama running locally
Claude claude-sonnet-4-5 · claude-opus-4-5 · claude-haiku-4-5 ANTHROPIC_API_KEY console.anthropic.com
OpenAI gpt-4o · gpt-4o-mini · o1-mini · o3-mini OPENAI_API_KEY platform.openai.com/api-keys
Groq llama-3.3-70b · mixtral-8x7b · gemma2-9b Free tier · GROQ_API_KEY console.groq.com/keys
Get started

Ship it to your terminal.

Node 18 or later required. Ollama is optional.

npm install -g @localcode/cli
No global install: npx @localcode/cli  ·  GitHub  ·  npm
THEN RUN:
localcode

First run → setup wizard → provider → launch.

Node.js 18+ macOS · Linux · WSL MIT License TypeScript source