I wanted something like Claude Code — but completely offline, on any laptop,
with nothing installed on the host machine.
So I built code-stick.
What it is
A CLI that turns any USB drive into a portable, self-contained AI coding agent.
You get file editing, multi-step tasks, and tool use — running entirely on the
stick against a local model. No internet. No installs. Nothing left on the host
when you unplug.
How it works
Run this once on your own machine:
npx code-stick install
Pick a model — Qwen2.5-Coder, DeepSeek-Coder, CodeGemma, or Phi-3.
It downloads everything onto the USB:
- opencode + Ollama pre-built binaries for all five targets
- Model weights in a USB-local Ollama store
- Three launchers at the root: start-windows.bat, start-mac.command, start-linux.sh
From that point on, plug into any Windows, macOS, or Linux laptop, double-click
the matching launcher, and you get a full coding agent running at 127.0.0.1.
Quit → Ollama process killed by PID → host stays completely clean.
Why I built it
Three situations cloud agents can't serve:
Airgapped environments — banks, hospitals, defense, lab VMs where you can't
install software or call external APIs.
Shared or borrowed machines — school computers, client laptops, internships
where the host must stay untouched.
Privacy-sensitive code — NDA'd or client code that legally can't go to a
hosted model.
Current state
v0.1.0 — early but working:
- Tested end-to-end on all five targets
- Docker-based smoke test in CI + Vitest unit suite
- Crash reports are local-only, no auto-upload, no telemetry
- MIT licensed, Node 20+
Try it
GitHub: github.com/MuhammadUsmanGM/code-stick
Would love feedback — especially on model selection, USB performance, and any
edge cases on your OS.
Top comments (0)