---
name: 0-finance-cli
description: Keep the 0 Finance CLI aligned with product capabilities.
compatibility: opencode
---
## 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
1. Identify the product capability being exposed.
2. Add or update the matching CLI command in `packages/cli/src/index.ts`.
3. Update CLI docs in `packages/docs/cli/` (installation + reference).
4. Update product docs or landing pages if the CLI entrypoint changes.
5. 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.
