Coding Agents

AI coding agents are the fastest way to go from idea to working Bkper integration. They can scaffold projects, write SDK code, debug issues, and iterate with you in real time — as long as they have the right context about the platform.

Use this page when you already have a preferred coding agent, or when you want to compare agent harnesses. If you want Bkper’s recommended first-party terminal workflow, start with Bkper CLI Agent.

New to AI?

If you’re new to how LLMs, context, and agents work, read AI Fundamentals first. It covers the mental model you need before building with AI.

Security

Coding agents run with your permissions. Follow each tool’s own sandboxing, credential, and permission guidance. For Bkper’s first-party terminal workflow, see CLI Agent Security.

Recommended default

If you don’t already have a preferred coding agent, start with Bkper CLI Agent. It ships with the Bkper CLI, has Bkper’s from-to accounting model and CLI context built in, and can work with local files, shell commands, scripts, and tests in the same local environment.

Use the rest of this page when you want to bring Bkper context into another agent such as Claude Code, Cursor, Codex, OpenCode, Pi, or AMP.

Other agents

Any coding agent can build effectively with Bkper when given the right context. Here are the ones we’ve used and recommend. The same approach also applies to general-purpose personal agents such as OpenClaw and Hermes Agent when they can run local tools.

Agent	Type	Models	What it is
Pi Agent	Terminal	15+ providers — Anthropic, OpenAI, Google, and more	Minimal, extensible harness — the engine behind Bkper CLI Agent
Claude Code	Terminal, Desktop, IDE	Claude models	Anthropic’s full-featured agent across all surfaces
OpenCode	Terminal, Desktop, IDE	75+ providers — free models included, works with Copilot and ChatGPT subscriptions	Open-source agent with the largest provider ecosystem
Codex	Terminal, Desktop, IDE	OpenAI — works with your ChatGPT plan	OpenAI’s open-source coding agent
AMP	Terminal	Multiple providers — works with Claude, OpenAI, and more	Open-source coding agent built for AI-native development workflows
Cursor	Terminal, Desktop, IDE	Multiple providers built in	AI-native code editor with a terminal agent

Each tool has its own way of loading project context. The next section explains how to provide Bkper knowledge to any of them.

Add Bkper context

Bkper CLI Agent has context built in. For other agents, you need to provide it.

Install the Bkper CLI plugin or skill

Install and authenticate the CLI first when the agent needs live Bkper access:

npm i -g bkper
bkper auth login

Then add Bkper context to your agent.

For Codex, add this repository as a plugin marketplace, then install the bkper-cli plugin from Codex’s plugin directory:

codex plugin marketplace add bkper/bkper-cli

For Claude Code, install the Bkper CLI plugin from this repository’s Claude marketplace:

/plugin marketplace add bkper/bkper-cli
/plugin install bkper-cli@bkper

For other external agents that support the Agent Skills standard and can run local shell commands, install the Bkper CLI skill:

npx skills add bkper/bkper-cli --skill bkper-cli

The Codex and Claude Code plugins package the same portable Bkper CLI skill for their native plugin flows. The skill gives other harnesses Bkper’s from-to accounting model, CLI references, SDK pointers, and safety guardrails for operating the local bkper CLI. Source on GitHub.

Direct Markdown access

If your agent doesn’t support skills, or if you only need general Bkper knowledge without local CLI operations, load context manually. Every page on bkper.com is available as clean Markdown — append .md to any URL:

https://bkper.com/docs/core-concepts.md
https://bkper.com/docs/api/bkper-js.md
https://bkper.com/docs/build.md

This strips navigation chrome and reduces token usage. See Docs for AI for all access methods.

Three URLs cover most Bkper development needs:

URL	What it covers
/platform/agents.md	Technical instincts, quality standards, domain sensibilities
/docs/core-concepts.md	The from-to model, account types, transactions, groups, queries
/docs/api/bkper-js.md	Full bkper-js SDK reference with TypeScript types

Use whichever combination your project needs.

Project-level context files

For project-specific knowledge — which book you’re working with, what accounts matter, what tags to use — add it to your agent’s context file (AGENTS.md, CLAUDE.md, or equivalent):

## Project context

- Book ID: abc123-def456
- Key accounts: Checking, Sales, Accounts Receivable
- Common tags: #invoice, #payment, #reconciled

## Rules

- All automated transactions must be created as drafts
- Use the #sync tag on all imported transactions

This gives the agent project-specific knowledge that no published doc can provide.

Next steps

• Your First App — build and deploy a full Bkper app (a great task to pair with an AI agent)
• CLI Scripting & Piping — automate data workflows with CLI pipes
• Apps Overview — understand the Bkper Platform architecture