Asimi is an open-source, multi-model, single-daemon harness. It governs your projects by an imperial court so your codebase moves with intent, not chaos.
Asimi's one job is the continuous harmonization of the Three Realms
Your wants, edicts, documents and tests. Intent is subjective and often ambiguous, so it is never obeyed blindly: the court raises 正名 and asks the ruler as guessing is treason.
The ruler states intent; the court rectifies names
Production code, shaped by the Forge (工部) and maintained by git.
The Forge shapes the code
Tests pass or fail; CI renders verdicts; logs record events. Heaven is immutable, binary, and absolute. It does not suggest, signal, or negotiate — it judges.
Asimi uses webhooks to listen and handle tian events
Receives your intent, rectifies names(正名), and drafts edicts.
Advises, reviews code against the Imperial Code, and holds the Chancellor's Seal.
Plans complex campaigns — battle plans for medium and large epics, covering multiple edicts.
Writes clean concise code — produces manifests with the implementation details.
Runs tests and renders the binary verdict: pass or fail.
No minister is fully trusted — if the Forge fakes a test, the Judge catches it. No change reaches Heaven without passing every seal, including yours.
An edict ascends from Earth to Heaven through the seal chain:
Judge's Seal — no tests were changed and the change is well tested and the tests pass
Chancellor's Seal — the code is simply using the right names and adheres to the Imperial Code
Ruler's Seal — your final approval; the edict ascends to Heaven
Based on the fittest dev tool ever made. If you know ex/vi/vim/neovim, you already know Asimi.
Agent's shell runs in its own container. Your host system stays protected while the models works freely.
Support for any OpenAI API v1 compatible services. Use your preferred model.
Asimi's rituals are extendable and customizable. Create your own workflows or customize how edicts ascend.
All special files live under the .agents directory. TOML-based config keeps it clean and documented.
Get up and running in minutes
First, install these two great tools:
# macOS (Homebrew)
brew install podman just# Fedora / RHEL
sudo dnf install podman just# Debian / Ubuntu
sudo apt update
sudo apt install podman justOr install separately:
Podman - like Docker but safer
Just - to collect all scripts in a Justfile
# One-line installer
curl -fsSL https://asimi.dev/installer | bash# Add the tap and install
brew tap afittestide/tap
brew install asimi# Install with Go 1.25+
go install github.com/afittestide/asimi@latest# Download from releases
github.com/afittestide/asimi-cli/releases/latest
# Copy to your bin directory
cp asimi /usr/local/bin/
chmod +x /usr/local/bin/asimiUpdates, tutorials, and insights from the Asimi team
Since version 0.5.0 Asimi has had a sandbox and superior UX based on vim. Mimicking ex/vi/vim/neovim paid off and my …
Asimi version 0.4.0 is out and I’ve got time to post. This one comes following a discussion about coding agents in …
Git changed how we build software. Now coding agents are changing how we use git.
Before, it was just me, myself & I …
Asimi is built in the open and grows by its contributors. Whether you write code, prose, or bug reports, there is a place for you in the court.