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