Skip to content
Monologue
Esc
↑↓navigate↵open⌘Jpreview
On this page

Use the Monologue CLI

Search and retrieve Voice Notes from a terminal or local agent.

The Monologue CLI provides read-only access to your Voice Notes. It can list notes, search them, and retrieve a note’s summary or transcript.

Install and authenticate

On Mac, open Settings → Notes → Monologue CLI and copy the current install command. It installs the CLI and starts onboarding.

During onboarding:

  1. Create a Notes API key when prompted, or create one under Settings → Notes → API keys.
  2. Copy the key when Monologue shows it. The complete secret is shown only once.
  3. Paste it into monologue onboarding.
  4. Let the CLI verify the connection.

Store the key only on a device and in tools you trust. Do not put it in source control, a shared shell history, or a prompt sent to an unrelated service.

Find notes

Run monologue --help and monologue notes --help for the commands supported by your installed version. Common tasks include:

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes get NOTE_ID
monologue notes get NOTE_ID --field transcript

The CLI cannot create, edit, or delete notes.

Connect a local agent

Open Settings → Notes → Connect an AI Agent on Mac and copy the generated setup message. Paste it into the local agent you want to configure. Use this generated message instead of an older command from a guide, because supported agents and installation steps can change.

Revoke access

Revoke the CLI’s API key in Monologue or under Web app → Settings → API keys. Commands using that key stop working immediately. Create a new key and run onboarding again if you want to reconnect.

If you used the same key in more than one tool, revoking it disconnects all of them. Separate keys make future rotation safer.

Was this page helpful?