OpenClaude — Portable AI Coding Agent

Run a full-featured AI coding agent from a USB drive or any folder — no installation required.
Plug in. Launch. Code. Take it anywhere.

🎥 Watch the Setup & Demo Video:

What Is This?

OpenClaude Multi-Platform is a fully portable AI coding agent powered by the open-source OpenClaude engine. It bundles a self-contained Node.js runtime, a smart system-prompt proxy for local models, and a web-based dashboard — all configurable from a single START.bat (Windows) or start.sh (Linux/macOS).

Everything runs strictly inside the project folder. No files are written to the host machine.

Key Features

| Feature | Details | |---|---| | 6 AI Providers | NVIDIA NIM · OpenRouter · Google Gemini · Anthropic Claude · OpenAI · Ollama (offline) | | Zero Footprint | All data, keys, and logs stay inside data/ — nothing touches the host system | | Local Speed Proxy | Trims system prompts by up to 90% before sending to Ollama, dramatically improving response time on CPU-only hardware | | Auto-Update Cache | Checks for engine updates once per day (skips the network call on repeat launches) | | Session Resume | Resume any interrupted session with RESUME.bat | | Web Dashboard | ChatGPT-style browser UI with agent mode, tool cards, and thinking visualisation | | Limitless Mode | Optional full-autonomy mode — the agent runs without asking for approval | | Cross-Platform | Shared data/ folder works across Windows, Linux, and macOS |

Quick Start

Windows

.\START.bat

On first run it automatically downloads Node.js (~25 MB) and the OpenClaude engine (~5 MB), then walks you through provider selection. Every subsequent launch skips setup and goes straight to the menu.

Linux / macOS

chmod +x start.sh
./start.sh

First-time setup requires internet. After that, only API calls need a connection (or none at all if you use Ollama offline mode).

Project Structure

OpenClaude-Multi-Platform/
│
├── START.bat                  Windows entry point — handles everything
├── start.sh                   Linux/macOS entry point
├── RESUME.bat                 Resume a previous session by ID (Windows)
│
├── data/                      All persistent data (shared across platforms)
│   ├── ai_settings.env        Active provider, model, and API key
│   ├── openclaude/            Session history and agent memory
│   ├── ollama/                Local Ollama binary and model storage
│   └── proxy.log              Speed proxy activity log (silent background)
│
├── engine/                    Node.js runtime + OpenClaude npm package
│   ├── node-win-x64/          Bundled Node.js (Windows)
│   └── node_modules/
│       └── @gitlawb/openclaude/
│
├── tools/                     Helper scripts
│   ├── local-proxy.js         System-prompt trimming proxy for local models
│   ├── setup_local_models.ps1 Ollama model downloader (Windows)
│   ├── setup_loc