Overview
A free, local-first coding 8gent for your terminal. Local models by default, no account, and it asks before it acts.
8gent Code is a coding 8gent that lives in your terminal. It reads your project, edits files and runs commands, in tabs, alongside you. It runs on local models by default: no account, no API key, and your code stays on your machine.
curl -fsSL https://8gent.dev/install.sh | sh
8gentThat downloads the newest release binary. It installs to ~/.local/bin, with no npm and no root. Update with 8gent update. Supported: macOS and Linux on x64 and arm64, and Windows through install.ps1. macOS on Apple Silicon is where the team runs it every day. See Install.
These docs describe main
Every command, key and path here is checked against 8gent-code main as of 30 September 2026. Pages mark what only main has.
Start here
Install
The one-line installer, a model.
First run
The living 8, then a short setup where Enter always takes the default.
Your first task
Ask, approve, stop, and give it more rope.
What is new
Permission modes on Shift+Tab
Plan, Ask, Guarded, Infinite. Per tab.
System One, on by default
A local checker. In Guarded mode it looks at every shell command before it runs.
Run without Ollama
llama-server as your local engine.
NO_COLOR
Colour off for the main screen, header, intro banner and music deck.
The DJ
Music in the footer, with title, artist and key.
The living 8
The new splash, and how to turn it off.