cli example workflows.md
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs; this page is available as Markdown.
Additional Workflows
These examples are starting points. Replace workspace IDs, entity IDs, dates, and filters with the client context you are reviewing.
Find the right client context
kick workspaces list
kick --workspace <workspace-id> whoami
Use this when you are switching between clients or checking whether a token is workspace-bound.
Review transactions that need attention
kick --workspace <workspace-id> transactions find --since 2026-01-01 --until 2026-01-31 --limit 25
kick --workspace <workspace-id> transactions find --since 2026-01-01 --until 2026-01-31 --fields id,date,amount,counterparty,bank_description --output json
Use --fields to keep output focused when another tool or agent needs to read the result.
Pull reports for review
kick reports profit-loss --entity 123 --start-date 2026-01-01 --end-date 2026-01-31 --basis cash --cycle month
kick reports balance-sheet --entity 123 --start-date 2026-01-01 --end-date 2026-01-31 --basis cash --output json
kick reports trial-balance --entity 123 --start-date 2026-01-01 --end-date 2026-01-31 --basis cash --output json
Use JSON output when another tool or script needs to read the result.
Inspect activity before changing anything
kick --workspace <workspace-id> activity list --resource-type transaction --changed-fields categoryId --limit 10
kick --workspace <workspace-id> activity logs --resource-type transaction --limit 10 --output json
For deeper review:
kick --workspace <workspace-id> activity details --date 2026-04-01T00:00:00.000Z --source-type transaction_bulk_update --grouped --output json
Pipe output to another tool
The CLI writes data to stdout and diagnostics to stderr, so stdout can be piped safely:
kick --workspace <workspace-id> transactions find --limit 10 --output json | jq '.[0].id'
For agent workflows, prefer compact structured output:
kick --workspace <workspace-id> transactions find --limit 25 --output json-compact
Preview supported write actions
Preview-first commands return a confirmation token. Review the preview, then pass the token or use the documented confirmation flag only when you are ready.
Do not automate confirmation unless the workflow has been reviewed and approved by your firm.