Getting Started with AIVory Code

AIVory Code is a free, local-first control room for coding agents. This page shows how to install it and how to start it.

Install

Windows

Windows 11 is the supported platform. Run this command in a terminal:

winget install Aivory.AivoryCode

macOS and Linux

The macOS and Linux builds are a preview. They build in CI, but nobody has tested them yet. Run this command:

brew install aivorynet/tap/aivory-code

Both commands install aivory (the desktop app) and aivoryd (the daemon).

The SmartScreen note

The builds have no code signature yet. winget installs without the SmartScreen prompt, and Homebrew formulas do not get the macOS quarantine flag.

If you download the installer or the archive from the releases page yourself, Windows SmartScreen shows a warning at the first start. Select More info, then Run anyway. On macOS, right-click the app and select Open.

First Start

1. Install and log in to at least one agent CLI: claude, codex or gemini.
2. Run aivory.
3. The war room shows the sessions that the agents already have on this computer.

If no daemon runs, the desktop app starts aivoryd for you. The daemon keeps running when you close the app. See Daemon.

What the App Reads

• The session stores of your agents: ~/.claude, ~/.codex and ~/.gemini. The app reads them and never writes to them.
• Nothing else of your agents. No code reads, stores or proxies a login token.

The daemon runs claude, codex and gemini with your own login. It keeps its own data (tasks, settings, paired devices) in a folder for your user. On Windows this is %LOCALAPPDATA%\aivory\code.

Try the Demo Mode

Demo mode shows the screens with sample data. You need no agent and no daemon.

aivory --demo

Add --demo-rich to show sample transcripts with markdown, diffs and todos:

aivory --demo --demo-rich

Next Steps