CLI reference

Global syntax

anarlog [--base DIR] [--db-path FILE] [--json] <command>

Option	Environment variable	Behavior
`--base DIR`	`ANARLOG_BASE`	Use `DIR/app.db`.
`--db-path FILE`	`ANARLOG_DB_PATH`	Use an explicit SQLite file.
`--json`	—	Emit a versioned JSON response or machine-readable JSON error.

--db-path takes precedence over --base. Without either option, the CLI uses Anarlog’s platform application-data directory and recognized legacy locations. The Linux desktop package exposes the bundled command as anarlog-cli. Substitute anarlog-cli for anarlog in the examples below when using that package.

Account commands

anarlog auth login
anarlog auth status
anarlog auth logout

auth login prints a URL that can be opened in any browser, including one on another device. Sign in, choose Copy URL on the completion page, then paste the anarlog://auth/callback link into the hidden CLI prompt. The CLI verifies the session with Anarlog before saving it in the same local auth store as the desktop app. On Linux, the CLI uses Secret Service when it is available. Headless systems without Secret Service fall back to auth.cli.json in Anarlog’s local application-data directory with permissions limited to the current user. The desktop app reconciles that file into Secret Service when it becomes available. auth logout removes the local session; it does not delete the Anarlog account. auth status reports the signed-in account and whether the current access token has expired. The stored refresh token lets the desktop app refresh an expired access token when it starts.

Meeting commands

Command	Options	Result
`meetings list`	`-q, --query TEXT`, `--series-id ID`, `--limit 1..200`, `--offset NUMBER`	Meetings ordered by the application query layer. Defaults to 20 results.
`meetings get ID`	—	Metadata, canonical note, summaries, participants, and action items.
`meetings note ID`	`--kind note\|summary\|all`	The selected note documents. Defaults to `note`.
`meetings transcript ID`	`--limit 1..500`, `--offset NUMBER`	A bounded transcript word page. Defaults to 200 words from offset 0.
`meetings history ID`	`--limit 1..200`, `--offset NUMBER`	A page of meetings from the same recurring series. Defaults to 20 from offset 0.
`meetings export ID`	`--format markdown\|json`, `-o, --output FILE`, `--force`	A complete meeting export, including transcripts. Defaults to Markdown on stdout. Existing files require `--force`.

Proposal commands

These commands insert or inspect staged edits. They do not apply the edit to the meeting. Apply happens in the desktop app.

Command	Options	Result
`proposals create`	`--meeting ID`, `--kind summary\|memo`, `--target ID`, `--content TEXT` or `--content-file FILE`	Stages a pending replacement. `--target` is required when the meeting has multiple summaries.
`proposals list`	`--meeting ID`, `--status pending\|applied\|declined\|all`, `--limit 1..200`, `--offset NUMBER`	Proposals, newest first. Defaults to pending rows, 20 results.
`proposals show ID`	—	Proposal metadata and a unified diff.
`proposals decline ID`	—	Marks a pending proposal declined. The meeting is unchanged.

JSON response contract

Successful --json responses contain:

Field	Meaning
`schema_version`	CLI JSON contract version. Currently `1`.
`command`	Stable command identifier such as `meetings.list`.
`data`	Command result.
`pagination`	Page metadata when the command is paginated.

Pagination includes offset, limit, returned, optional total, and optional next_offset.

Doctor command

anarlog --json doctor

Checks the resolved database path, read-only access, and required schema without changing data. It exits with status 0 when ready is true and status 1 when ready is false.

MCP command

anarlog mcp

Starts the read-only MCP server over stdio. Do not write other output to the server’s stdout.

Help and version

anarlog --help
anarlog auth --help
anarlog meetings --help
anarlog meetings list --help
anarlog --version

Getting started

Using Anarlog

AI and privacy

CLI and agents

Recipes

Reference

Help

Global syntax

Account commands

Meeting commands

Proposal commands

JSON response contract

Doctor command

MCP command

Help and version

​Global syntax

​Account commands

​Meeting commands

​Proposal commands

​JSON response contract

​Doctor command

​MCP command

​Help and version

Global syntax

Account commands

Meeting commands

Proposal commands

JSON response contract

Doctor command

MCP command

Help and version