> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anarlog.so/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI for agents

> Use structured Anarlog CLI output as an agent-friendly MCP fallback.

Use the global `--json` flag whenever an agent consumes CLI output.

A successful response contains `schema_version`, `command`, `data`, and optional `pagination`. Read results from `data`. Follow `pagination.next_offset` only when you need another page.

Meeting reads default to the local database. Use `meetings --source cloud` after `anarlog auth login` to read opted-in Cloud snapshots, or `meetings --source auto` to use Cloud only when the local database is absent.

## Resolve meeting context

```bash theme={null}
anarlog --json meetings list --query "weekly planning" --limit 10
anarlog --json meetings get MEETING_ID
anarlog --json meetings --source cloud list --query "weekly planning" --limit 10
```

Search is case-insensitive across meeting titles and IDs. If several meetings match, ask the user to choose one.

## Read the smallest useful surface

```bash theme={null}
anarlog --json meetings note MEETING_ID --kind note
anarlog --json meetings note MEETING_ID --kind summary
anarlog --json meetings history MEETING_ID --limit 10 --offset 0
```

Use `meetings get` when participants or action items matter. Use `meetings note` when note content alone is enough.

## Stage an edit

```bash theme={null}
anarlog --json proposals create --meeting MEETING_ID --kind summary --content "Replacement markdown"
anarlog --json proposals list --meeting MEETING_ID
anarlog --json proposals show PROPOSAL_ID
anarlog --json proposals decline PROPOSAL_ID
```

<Note>
  The create command returns a pending proposal. Do not claim the meeting changed. Open the meeting in the desktop app to apply it, or decline it from the CLI or desktop app. Only pending proposals can be declined.
</Note>

## Transcripts

```bash theme={null}
anarlog --json meetings transcript MEETING_ID --limit 200 --offset 0
```

Transcript limits are measured in words. A page defaults to 200 words and caps at 500. Stop paging once you have enough evidence.

## Diagnose setup

```bash theme={null}
anarlog --json doctor
```

The report includes the CLI version, resolved database path, read-only connection status, and schema readiness. When `ready` is false, the command still prints the report to standard output and exits with status 1.

## Exports

Only export a complete meeting when the user explicitly requests a file:

```bash theme={null}
anarlog meetings export MEETING_ID --format markdown --output meeting.md
anarlog meetings export MEETING_ID --format json --output meeting.json
anarlog meetings --source cloud export MEETING_ID --format json --output meeting.json
```

<Warning>
  Export refuses to replace an existing file. Use `--force` only after the user explicitly approves overwriting that exact path.
</Warning>

See the [CLI reference](/reference/cli) for every option.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.