@agentdocumentformat/cli
v0.8.3
Published
ADF CLI: the ADF (Agent Document Format) daemon, command line and terminal app. Run your agents headless: `adf daemon`, then `adf`.
Maintainers
Readme
@agentdocumentformat/cli
The ADF CLI: run ADF (Agent Document Format) agents from a terminal, with
no desktop app. An ADF agent is a single .adf file: config, memory, files
and history in one portable document. For the desktop app, ADF Studio, see
the releases.
adf: the terminal app. Your fleet of agents in one screen: chat with any agent or any of its loops, approve tool calls, edit files, schedule inner loops (side loops), watch live events.adf <command>: one-shot commands for scripts (adf help).adf daemon: the background daemon that runs the agents.adfstarts it for you; it keeps running after you quit.
Install
Requires Node.js 22 or newer. Native modules (SQLite, OS keychain) come prebuilt for Windows, macOS (arm64, x64) and Linux (x64, arm64, glibc).
npm i -g @agentdocumentformat/cli
adfEEXIST on install? Remove the old package first:
npm uninstall -g agent-document-format.
Upgrade: npm i -g @agentdocumentformat/cli@latest, then
adf daemon restart.
Quickstart
In the terminal app (a welcome checklist opens on first run):
/identity create # your owner identity: 12 words, the same as in ADF Studio
/login chatgpt # or /login grok, /login claude, or /provider add for an API key
/new # create an agent; its chat opens
/loop new consolidator # optional: an inner loop that tidies memory nightlyOr with one-shot commands:
adf identity new
adf auth login chatgpt
adf new agent-1 --start
adf chat agent-1 "hello"
adf events agent-1Daemon: adf daemon status | stop | restart | logs -f | token. Studio and
the CLI share settings and the owner identity on one machine; adf does not
start a daemon while Studio is running.
Docs
- ADF CLI
- Getting started
- Terminal app
- Reference: every command, flag, slash command and key
- Remote daemon
- Troubleshooting
- Daemon HTTP API
License
MIT
