Beaver Agent CLI

This package ships the beaver / beaver-agent command-line entry point for Beaver Agent, a local-first AI workflow engine with observable runs, SQLite-backed state, and human approval gates.

Install

npm i -g beaver-agent
BEAVER_AUTO_INIT=1 beaver start

Then open http://127.0.0.1:4588.

Without a global install:

BEAVER_AUTO_INIT=1 npx beaver-agent start

The CLI stores local state, artifacts, and encrypted secrets under ~/.beaver by default. No model API key is required for the dashboard demo or the zero-config human approval template.

Release checks

Before publishing a new version, maintainers should:

• publish the package to npm,
• run beaver --help, beaver doctor, and a local start smoke test,
• confirm the packed manifest has no unresolved workspace:* runtime dependencies.

The repository includes pnpm run verify:npm-package, which builds, packs, installs, starts, and probes the package in a disposable npm project.

Reference

• CLI Reference
• Configuration Reference
• API Reference
• Plugin SDK Reference