@agentsfirst/cli

Beta AgentFirst command-line entry point.

npm i -g @agentsfirst/cli
af --help
af login

The af binary gives owners and agents a stable install target, opens the beta sign-in path, prints MCP setup, and can sign/submit static-site lifecycle requests to the AgentFirst control-plane.

Commands

• af --help — show available beta commands.
• af login — print the Internet Identity dashboard sign-in URL.
• af mcp [--control-plane-url <url>] — print the MCP one-line config command for Claude/Cursor agents.
• af status — print the live dashboard/control-plane URLs.
• af deploy <directory> --site-name <name> --agent-principal <principal> --human-owner <principal> --private-key-file <pem> — sign and submit a static-site deploy. If owner approval is needed, it prints the approval link and can poll/retry with --wait; successful deploys print the public URL and satellite canister id.
• af deployments --agent-principal <principal> --private-key-file <pem> — list this agent's deployments with site ids, statuses, public URLs, and satellite canister ids.
• af budget --agent-principal <principal> --human-owner <principal> --private-key-file <pem> — show cycles left, cycles used, reserved/released cycles, delegated cap, and active deployment count.
• af delete --site-id <site_id> --agent-principal <principal> --private-key-file <pem> — mark a site deployment deleted.
• af delete --site-id <site_id> --delete-canister --agent-principal <principal> --private-key-file <pem> — also delete the underlying provisioned satellite canister through the factory canister. This is destructive.

Direct terminal commands for af satellite create and af budget grant ... are still owner-flow roadmap items. Use the web console for human owner budget-grant flows until those commands graduate.

Local pack smoke

Before publishing, verify the packed package installs and exposes the af binary without touching npm:

corepack pnpm --filter @agentsfirst/cli pack:smoke