AIVory Code · Free and open source
Your coding agents are the units. You give the orders.
AIVory Code turns every Claude Code, Codex CLI and Gemini CLI session on your computer into one live board. Agents work, stop to ask you something, or crash. Your job: keep them all moving. From your desk, from your phone, or from a pixel-art village.
- Needs you
- Working
- Blocked
- Idle
winget install Aivory.AivoryCode
Installs the desktop app aivory and the service aivoryd. Start the app with aivory.
Build your own theme or add-on
Like it? A star helps other developers find AIVory Code.
MIT license, no account, no paid tier. Windows 11 is supported. The macOS and Linux builds are a preview.
Choose your look
Eight so far. Yours is next.Command. A pixel-art building game. Your agents are workers who construct your features.
What happens when an agent needs you
One task, start to finish. You type it in the Dispatch box: @billing add refund tests with codex.
-
aivoryd starts the run
aivoryd is a small service on your computer. It starts the Codex CLI that you installed, with your own login, in your billing repo.
codex · billing · working
-
Codex stops to ask
Codex wants to run the tests and asks first. aivoryd sees the open question and moves the session to Needs you.
Allow codex to run cargo test -p billing?
-
You answer
The question waits at the top of the board, with the command and the choices. You click Allow.
AllowDeny
-
Codex keeps going
aivoryd hands your answer to Codex. The tests run, and the session goes back to Working.
codex · billing · working
Sessions that you start in your own terminal show up on the board too. aivoryd reads the files that Claude Code, Codex and Gemini write to ~/.claude, ~/.codex and ~/.gemini, and it never writes to them. No account and no server of ours sit in this path.
Build the next level.
Eight looks are only the start. Make a theme that turns the board into your own world, or an add-on that plugs into the daemon API. No permission needed, no review queue, and the work stays yours.
Themes
Data files, no code.
Tokens, screen layouts, strings and art in TOML and JSON. The validator checks every save, so a broken theme cannot break the app.
$ aivoryd theme init my-theme
$ aivoryd theme dev my-theme
$ aivoryd theme pack my-theme
Add-ons
One open API, any language.
JSON-RPC 2.0 over a local pipe, a WebSocket or iroh. The desktop and phone apps use the same API, so your add-on can do what they do.
$ aivoryd serve --demo --endpoint try
$ aivoryd call warroom/snapshot --endpoint try
Theme idea
A board game: codebases are fields, agents are pieces, and a question is your turn.
The board is real. It reads the sessions you already have.
You keep your agents and your logins. A small background service, aivoryd, reads the session files that the agent CLIs write anyway. It starts new runs with the CLIs that you installed. The apps only show what the service knows.
Session stores
Written by the agent CLIs. AIVory Code never writes to them.
~/.claudeClaude Code~/.codexCodex CLI~/.geminiGemini CLI
aivoryd
Runs on your computer and starts with it.
- Derives the state of each sessionlive
- Runs claude, codex and geminiyour login
- Autopilot: parks idle runs, starts queued tasksoff by default
Displays
Clients of the service. Open as many as you like.
- Desktop appWindows, macOS, Linux
- iPhone and Apple Watchcoming soon
- Androidcoming soon
One question per screen.
Every screen answers one question. The screens guide explains each one in detail.
Who works, who waits, who is stuck? All sessions of all codebases, live, with the token spend and a run log.
Give orders from the couch.*
An agent that waits for a yes does nothing. The phone app shows the same questions as the Inbox, and your answer goes straight to your computer.
- Pair once with a QR codeScan the code in the desktop app. No account, no cloud login.
- At home or from anywhereThe phone talks to
aivorydover an end-to-end encrypted link. At home it goes direct. From other networks it uses a public relay that cannot read your data. No server of ours. - Five seconds to change your mindEach answer waits five seconds before it leaves the phone, so a wrong tap is easy to undo. Risky answers ask for Face ID or your fingerprint.
- Talk instead of typeHold the mic button and dictate a reply or a new task.
The phone apps collect no data. Read the app privacy policy.
claude · billing · waits 2 min
Allow Claude to run this command?
sqlx migrate run --database-url $STAGING_DB
Allowed.
Sends in 5 s
Your code stays on your computer.
AIVory Code is local-first. These rules are in the source code, and anyone can check them.
Read-only session stores
The service reads
~/.claude,~/.codexand~/.gemini. No code writes to them.Your login, never your token
The service runs the agent CLIs with your own login. No code reads, stores or forwards a login token.
No server at Aivory
There is no account and no cloud backend. Tasks, settings and paired devices stay in a folder on your computer.
Open source, MIT
The service and the desktop app are on GitHub. Read the code, build it yourself, or change it.
Free to play. No in‑app purchases.
No paid tier, no limits, no account. Paul built AIVory Code to keep up with his own agents and wants everybody to have it. Found a bug or missing a feature? Open an issue. Pull requests are welcome.
AIVory Code costs nothing. If you like it, a star is the best way to say thanks.
Questions
Which coding agents does it support?
Claude Code, Codex CLI and Gemini CLI. AIVory Code finds the sessions they already wrote on your computer, and it can start new runs with the CLIs you installed.
Does it cost anything?
No. AIVory Code is free and MIT licensed, with no paid tier. You still pay your agent providers as before. The app shows your token spend and usage windows, so you see that cost in one place.
Is my code sent anywhere?
No. The service runs on your computer and reads the local session files. Aivory runs no server for it. The phone app talks only to your own computer.
Can I answer a session that I started in a terminal?
You see it in the War room with its state and transcript. To answer its questions from the app, start the session from AIVory Code or resume it there. A question that belongs to a terminal process can only be answered in that terminal.
What does Autopilot do?
Autopilot parks idle sessions and starts queued tasks when a slot is free. It is off by default, and you turn it on in the War room.
Can I make my own theme or add-on?
Yes, and we hope you do. A theme is a folder of data files, and no code runs. An add-on is any program that talks to the daemon API. Publish it in your own GitHub repo with your own license. Start with Build themes and add-ons.
Does it run on macOS and Linux?
Windows 11 is the supported platform. The macOS and Linux builds come from the same code and install with Homebrew, but they are a preview and need more testing. Bug reports are very welcome.
Where do I get help?
Read the AIVory Code documentation, open an issue on GitHub, or write to us from the contact page.
Install it, and start your first real shift.
One command. It reads the sessions you already have, so the War room is full at the first start.
winget install Aivory.AivoryCode
Installs the desktop app aivory and the service aivoryd. Start the app with aivory.