Jcode — AI Coding Agent
Complete guide to jcode, the RAM-efficient open-source AI coding agent in Rust. Covers installation, prompt engineering, configuration, memory, swarms, and advanced workflows.
Jcode — AI Coding Agent
Jcode is an open-source (MIT) AI coding agent for the terminal, written in Rust by Solo Systems (backed by Combinator). It's built around three bets: massive parallelism, harness-over-model, and fully open dev tools.
In its published headless benchmark, jcode uses about 3.3 MB per additional session (51.3× less than Claude Code) and records a 19.1 ms time-to-first-input (183.9× faster than Claude Code). Run dozens of agents in parallel on consumer hardware.
Navigation
- Getting Started — Install, provider login, first session
- Prompt Engineering — Hill-climbable goals, confidence stepping, AGENTS.md conventions
- Configuration Reference —
config.toml, MCP, memory, swarms, remote gateway - Memory, Swarms & Self-Dev — Durable memory, multi-agent swarms, background tasks, self-dev mode
Quick Start
# macOS / Linux one-liner
curl -fsSL https://jcode.sh/install | bash
# macOS via Homebrew
brew tap 1jehuang/jcode
brew install jcode
# Windows 11 (PowerShell 5.1+)
irm https://jcode.sh/install.ps1 | iex
Log in with a provider you already pay for, then start a session:
jcode login --provider claude # Claude subscription
jcode login --provider openai # OpenAI / ChatGPT / Codex
jcode login --provider gemini # Google Gemini
jcode login --provider ollama # local Ollama server
cd my-project
jcode
What Makes Jcode Different
- RAM efficiency — ~3.3 MB extra per session vs ~169.3 MB for Claude Code in the project's headless benchmark. Parallel agents without a server farm.
- Memory — every turn is embedded as a semantic vector; related memories are recalled automatically from a graph via cosine similarity.
- Swarms — coordinated multi-agent teams with file-conflict detection and model routing via
.jcode/swarm-prompt.md. - Self-dev mode — tell jcode to enter self-dev mode and it edits, builds, tests, and reloads its own binary.
- MCP that never blocks startup — MCP tools are advertised from an on-disk schema cache, so the prompt cache stays warm.
- Background tasks —
run_in_backgroundtasks survive reloads, render live progress cards, and wake the agent on events. - Append-only context — a stable prompt prefix keeps the provider KV cache hot, cutting cost and latency.
Core Workflows
Run a single prompt non-interactively, resume by name, or serve persistently:
| Command | What it does |
|---|---|
jcode | Launch the interactive TUI |
jcode run "say hello" | Run a single prompt non-interactively |
jcode --resume fox | Resume a previous session by memorable name |
jcode serve | Run a persistent background server (daemon) |
jcode connect | Attach a client to a running server |
Project instructions live in AGENTS.md at the repo root; machine-wide instructions in ~/AGENTS.md. Both load into every session in scope.
Frequently Asked Questions
Related Resources
- Getting Started — install, configure, and begin your first session
- Prompt Engineering — hill-climbable goals, confidence stepping, todo discipline
- Configuration Reference —
config.toml, MCP, memory, swarms, remote gateway - Memory, Swarms & Self-Dev — advanced workflows
- Tool Comparison — jcode vs opencode vs pi vs Claude Code
Sources
Related Articles & Guides
Jcode — Getting Started
Install and configure jcode, the RAM-efficient open-source AI coding agent in Rust. Covers install, provider login, memory, swarms, and your first session.
Pi — Terminal AI Coding Agent
Complete guide to pi, Mario Zechner's minimal terminal coding agent. Covers installation, prompt engineering, context files, skills, and the lean-harness philosophy.
#ompOh My Pi (OMP): Install, Connect Providers, and Start Coding
Install Oh My Pi (OMP), connect Anthropic, OpenAI, or OpenCode Go, pick a model, and run a small inspect-change-verify-resume workflow.