Purpose

Keep the 0 Finance CLI agent-native: every user-facing capability in 0 Finance should be mirrored in the CLI. If a feature is added to the product, add the corresponding CLI command and update docs.

When to Use

Use this skill whenever modifying the CLI in packages/cli (the agent-bank package) or adding new commands, flags, or authentication flows.

Workflow

• Identify the product capability being exposed.

• Add or update the matching CLI command in packages/cli/src/index.ts .

• Update CLI docs in packages/docs/cli/ (installation + reference).

• Update product docs or landing pages if the CLI entrypoint changes.

• Verify the CLI output examples match actual responses.

Testing

Run commands from packages/cli using either Bun or pnpm:

• bun --cwd packages/cli run dev -- <command args>

• pnpm --filter agent-bank exec tsx src/index.ts <command args>

Common Issues

• pnpm --filter agent-bank dev -- ... injects a literal -- argument, which Commander treats as end-of-options; use pnpm --filter agent-bank exec tsx src/index.ts ... instead.

• pnpm exec prints an extra undefined line on non-zero exits; this is a pnpm quirk. Use finance or Bun for cleaner stderr if needed.

Documentation Requirements

• Update packages/docs/cli/reference.mdx when a command or option changes.

• Update packages/docs/cli/installation.mdx when auth or install steps change.

• Keep packages/docs/index.mdx quick start in sync with the CLI.

Completion Criteria

• CLI functionality matches the product capability.

• Docs reflect the latest CLI behavior.

• If the CLI is user-facing, update the landing quick-start copy.