Documentation

Put an agent to work on PocketBase.

Install the CLI, connect a PocketBase instance, and use bounded reads or immutable plan/apply mutations. Start locally before adding staging or production.

Start here

Install and connect

Install the binary and agent skill, generate a PocketBase token, and verify the connection.

 Trust model

Understand the safety boundary

See how credentials, plans, access grants, concurrency checks, and audits work together.

 Reference

Find the right command

Browse the implemented read and mutation families, output contract, and deferred capabilities.

 Repository docs

Read implementation notes

Authentication, compatibility, threat model, contributing, release, and security policies.

What is pb-agent?

pb-agent is a local command-line gateway between AI coding agents and PocketBase. It gives agents a versioned JSON contract for inspection and a constrained mutation workflow for records, collections, batches, and backups. Safety policy is enforced in the binary rather than delegated to an agent prompt.

Current status pb-agent is pre-release software with a PocketBase 0.39.8 compatibility baseline. Run pb-agent doctor against each target instance before relying on a capability.