ADI Mono
What this is
Section titled “What this is”ADI is software you install and run on your own computer. It runs AI agents, and gives every
project, service, or dashboard it manages a real address — yourproject.adi — instead of a
terminal tab you have to keep open or a port number you have to remember. A local supervisor
keeps it all alive: restarting a service under its restart policy, waking an on-demand one the
moment something visits it, and stopping it again once its idle window passes. One page in your
browser, the control panel at app.adi, shows what’s running and lets you start, stop, and watch
it.
If you’re comfortable installing software on a machine you control and running a command in a terminal, ADI is for you. It isn’t a hosted product you sign into — there’s no account behind it sitting on someone else’s server.
The pieces, in the order you’d meet them
Section titled “The pieces, in the order you’d meet them”ADI is made of a small number of concepts that build on each other:
- Projects — the folder everything else is filed under.
- Agents — the AI workers: a model, a prompt, and what they’re allowed to touch.
- Tools — small CLIs you give an agent, so it doesn’t retype the same shell command.
- Tasks — the to-do list an agent and you both read and write.
- Triggers — what runs an agent automatically, on a webhook, a schedule, or an event.
- Secrets — the credentials an agent is explicitly allowed to see.
- Database — the shared SQLite store agents, tools, and dashboards read and write.
- Hive — the supervisor and front door that gives a long-running process a real
<name>.adiaddress. - Ports — how a hive service gets a port without anyone picking one by hand.
- DNS — why
.adinames resolve on your machine at all. - Dashboards — a small web app, hosted on hive, that an agent can build for you.
- Fleet — pairing another machine running ADI, to reach its services by name.
- Mesh — the peer-to-peer network fleet pairing rides on.
For an enterprise evaluating thisEnterprise interest
Section titled “For an enterprise evaluating this”The front door — the piece that answers every *.adi address — binds loopback addresses only,
and mints its own certificate authority so local services get real HTTPS: one cryptographically
constrained (RFC 5280 name constraints) to the .adi/localhost/127.0.0.0/8 namespace, so a
leaf it signs isn’t a certificate any real browser will accept for anything outside this
machine’s own names, however its key is handled. Services meant to stay up are supervised and
restarted under their own restart policy instead of left to quietly die, and the whole routing
table is one API call away rather than scattered across shell history and config files. See
Hive for the routing, HTTPS, and supervision detail, and Secrets for how a credential is
encrypted at rest and scoped to exactly the agent that needs it.
For the technically curiousExpert area
Section titled “For the technically curious”A service lives as a few lines of YAML in a project’s .adi/hive.yaml, and the CLI, adi-mono,
is the one command line every part of the system answers to. Under the hood there’s a DNS
resolver for the .adi zone (see DNS and the front door), a task tree, a code index (symbol
search, call graph, clone detection), knowledge bases with embedded semantic search, a fleet
layer that joins remote machines over iroh (see Fleet and Mesh), and a port manager that
leases ports instead of guessing at them (see Ports).
Where to start
Section titled “Where to start”Nothing installed yet: Installation gets you from a download to a control panel open in your browser. Already installed: read Projects, then Agents — those two explain most of what the panel shows you when you first open it. Setting something up to run unattended: Triggers and Secrets. Confused about why a hostname works at all: DNS and the front door. Connecting a second machine: Fleet.