Skip to content
Bkper
app.header.homeapp.header.docsapp.header.apps
Open Bkper

Bkper CLI Agent

Use the built-in terminal agent shipped with the Bkper CLI for local, context-rich Bkper workflows.

The Bkper CLI includes a built-in terminal AI agent. Use it when you want an agent to work with local files, shell commands, scripts, tests, and Bkper CLI context in the same workspace.

This page explains the agent workflow. The canonical install, authentication, and command reference lives at Bkper CLI.

Use it when

  • You want an agent to inspect local project files or AGENTS.md.
  • You need shell commands, pipes, scripts, tests, or exported CSVs.
  • You are building a repeatable report, import, cleanup, or integration.
  • You want deterministic checks instead of raw AI answers for financial outputs.

For hosted assistants without local tool access, use Bkper MCP Server. For the full decision guide, see CLI vs MCP.

Quick start

  1. Authenticate the CLI with Bkper

    bkper auth login

  2. Start the terminal agent

    bkper

    or:

    bkper agent

  3. Connect model access

    On first launch, type /login inside the agent. bkper auth login connects the CLI to Bkper. /login connects the interactive agent to an AI/model provider.

Safe workflow

Ask the agent to work in small, reviewable steps:

  1. Read the relevant files, docs, or Bkper data.
  2. Explain the plan before making changes.
  3. Show exact commands for any write or batch operation.
  4. Wait for your confirmation before mutating Bkper data.
  5. Verify numeric results through Bkper APIs, scripts, tests, or reports.

Starter prompts

Explain the account types in this Bkper book and list anything that looks unusual.
Find possible duplicate transactions from last month. Do not modify anything; show me the query and reasoning first.
Write a script that exports a monthly profit and loss report from Bkper balances. Keep the calculation deterministic and add a simple test fixture.
Review unchecked transactions from this month and suggest what needs attention. Do not post, check, or edit transactions.
Prepare an exploratory tax worksheet for 2025 from my Bkper data. Use Bkper as the source of truth and mark assumptions explicitly.

Watch walkthroughs

Optional walkthroughs:

Security

The agent runs with your local workspace access and the Bkper permissions of the account used by bkper auth login. Before using it with real data, read Agent Security.

Reference

Use Bkper CLI for canonical installation, authentication, CLI command reference, and current agent behavior.