Use Almanac programmatically - Almanac

The Almanac CLI is the only public programmable interface today. It reads and writes the same Organization and Wiki as the web product.

One interface, three environments

Environment	Authentication	Recommended scope
Person at a terminal	`almanac login`	Link the current project
Coding agent	Installed login or managed Quill access	Link or explicit `--organization`
Automation	API key in `ALMANAC_TOKEN`	Explicit `ALMANAC_ORGANIZATION`

Start with the CLI:

uv tool install --upgrade the-almanac
almanac setup
almanac organizations
almanac link acme
almanac search "customer onboarding"

The hosted HTTP service is private infrastructure for the CLI, web product, and managed workers. API keys are CLI automation credentials, not a separate public API product.

Use the CLI

Work interactively or automate with JSON and stable exit codes.

Set up an agent

Install the same CLI guidance for Codex, Claude Code, and Quill.