@aident-ai/cli
v0.1.0
Published
Aident CLI — umbrella access to Loadout integrations, Playbook automation, Intern tools, and the Aident platform.
Readme
@aident-ai/cli
Agent-friendly access to Aident Loadout by default, with Playbook and Intern available as packages.
aident login
aident capabilities search --query "send email"
aident packages add playbook
aident playbooks list --jsonThe CLI is the only npm CLI package Aident ships. It is a thin wrapper around the public OpenAPI package APIs under
/api/openapi/..., so CLI behavior stays aligned with API and MCP behavior.
Install
npx -y @aident-ai/cli <command>
npm install -g @aident-ai/cliGet Started
aident setup
aident doctor
aident --helpUse --oob for browserless auth environments:
aident login --oobPackages
Loadout is always enabled by default. Add Playbook only when an agent needs to create, execute, or manage playbooks. Intern is admin-gated and should be used only by authenticated admin users.
aident --help
aident packages add playbook
aident packages list
aident --package playbook playbooks list --json
aident --packages playbook playbooks execute --playbookId pb_123 --jsonCommon Loadout Commands
aident capabilities search --query "send email"
aident capabilities get --name "gmail_tools.gmail_send_email"
aident capabilities execute --name "gmail_tools.gmail_send_email" --input '{"to":"[email protected]"}'
aident vault status --integrationId github_tools
aident audit recent --limit 20Configuration
Settings live in ~/.aident/config.json; OAuth credentials live in ~/.aident/credentials.json.
| Key | Default | Purpose |
| ---------- | ----------------------- | ----------------------------------------------------- |
| baseUrl | https://app.aident.ai | API host used for logins and command execution. |
| packages | ["loadout"] | Enabled packages. Loadout is always included locally. |
aident config show
aident config set baseUrl https://app.aident.ai
aident config set packages playbook
aident config unset packagesEnvironment overrides:
| Variable | Purpose |
| ----------------- | ----------------------------------------------------------- |
| AIDENT_TOKEN | Use this Bearer token directly; skips the credentials file. |
| AIDENT_BASE_URL | Override the API host for one invocation. |
| AIDENT_PACKAGE | Focus one package for one invocation. |
| AIDENT_PACKAGES | Enable add-on packages for one invocation, e.g. playbook. |
How It Works
Discovery fetches /api/openapi/{package}.json and reads the package command catalog embedded in the OpenAPI document.
Execution calls /api/openapi/{package}/{operationId} with the command arguments as JSON.
When multiple packages are enabled, the CLI fetches each package schema, merges the catalogs locally, and routes each command back to the package operation that contributed it. Unknown commands are not guessed across packages.
License
MIT
