Code Stick banner
MuhammadUsmanGM MuhammadUsmanGM

Code Stick

AI community

Description

Plug in a USB. Get an offline AI coding agent on any laptop - Windows, macOS, Linux. opencode + Ollama, pre-built for 5 targets, zero install on the host.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

code-stick

**Plug in a USB. Get an offline AI coding agent on any laptop.** One stick. Six targets — **Windows (x64 + ARM64), macOS (Apple Silicon + Intel), Linux (x64 + ARM64)**. Zero install on the host.

[![npm](https://img.shields.io/npm/v/code-stick.svg)](https://www.npmjs.com/package/code-stick) [![license](https://img.shields.io/npm/l/code-stick.svg)](./LICENSE) [![node](https://img.shields.io/node/v/code-stick.svg)](https://nodejs.org)

![code-stick demo](./public/code-stick.gif)

npx code-stick install

Why

You want an AI coding agent that works on:

  • Airgapped or restricted machines — banks, defense, hospitals, lab VMs.
  • Shared / borrowed laptops — internships, school computers, client sites.
  • Spotty wifi — flights, trains, cafes, conferences.
  • Privacy-sensitive code — closed-source clients, NDAs, personal projects.

Cloud agents won't work. Installing Ollama + a 5 GB model on every machine you touch won't either. code-stick is the in-between: install once on a USB, then run the agent from the stick on whatever laptop is in front of you. Host stays clean.

Under the hood it's [opencode](https://opencode.ai) (terminal coding agent) talking to [Ollama](https://ollama.com) (local model runner), both pre-built for every target, both serving from the USB on `127.0.0.1:11434`. Quit the agent, the Ollama process dies, the host has no residue.

Install + first launch

npx code-stick install            # auto-detects USB; pick a model interactively

Plug the stick into any supported machine, double-click the launcher for that OS:

  • start-windows.bat
  • start-mac.command
  • start-linux.sh

opencode runs in the terminal talking to a USB-local Ollama on `127.0.0.1:11434`. Quitting opencode kills the Ollama process. Nothing is left behind on the host.

Models

The recommended default is **Qwen2.5-Coder 7B** — fits a 32 GB stick, runs on 8 GB RAM, best all-rounder for code. Other curated options scale up