Installing agents
Adding an ACP agent from the registry, or pointing Cydonia at a command you already have.
Cydonia runs any agent that speaks ACP. An agent is a program Cydonia launches and talks to over stdio.
From the registry
Settings › Agents lists the ACP registry. Installing one downloads and
unpacks it under ~/.local/share/, and writes an entry into settings.toml
pointing at the unpacked executable.
By hand
Write the entry yourself in ~/.config/cydonia/settings.toml:
[[agents]]
name = "my-agent"
command = "path/to/agent"
args = ["--acp"]
# env = { KEY = "VALUE" }A hand-written entry has no registry id and is never touched by the installer.
Pinning
npx, bunx and pnpx resolve a package name against the registry on every launch, so npx pkg@latest is a different program each time. An entry run through one of them is loaded only when every package it names carries a version starting with a digit. One that does not stays in settings.toml but is left out of the agents Cydonia offers, with no notice. Pin the version:
[[agents]]
name = "pinned-agent"
command = "npx"
args = ["[email protected]"]Running one
An installed agent is reachable from a session. ⌘N talks to whichever agent the project last used; ⌥⌘N starts a session on the next one. See Sessions.