@aident-ai/cli

@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 --json

The 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/cli

Get Started

aident setup
aident doctor
aident --help

Use --oob for browserless auth environments:

aident login --oob

Packages

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 --json

Common 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":"user@example.com"}'
aident vault status --integrationId github_tools
aident audit recent --limit 20

Configuration

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 packages

Environment 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