Skip to content

Getting Started ​

rimo is the command-line interface for the Rimo platform. It lets you search, fetch, and ask questions about your meeting notes from the terminal — or wire it into AI agents like Claude Code, Codex, and Cursor.

Install ​

Linux / macOS

bash
curl -fsSL https://rimo.app/cli/install.sh | sh

Windows (PowerShell)

powershell
irm https://rimo.app/cli/install.ps1 | iex

Verify:

bash
rimo version

For manual installs, upgrades, and uninstall instructions, see Installation.

Log in ​

bash
rimo auth login

This opens your browser. Sign in and approve the request — your tokens are stored securely by your OS credential store, never in a file.

On headless machines (SSH, CI):

bash
rimo auth login --no-browser

Your first commands ​

bash
# List your notes
rimo note list

# Fetch a single note (metadata as JSON)
rimo note get <note_id>

# Fetch a note's transcript as plain text
rimo note get <note_id> --transcript

# Search notes by meaning
rimo note search "Q3 release plan"

# Ask a question, get an AI-synthesised answer
rimo note ask "what did we decide about pricing?"

Output format ​

Every command prints JSON to stdout by default — with no TTY detection, so the output is identical in a terminal, in a pipe, and in CI. That is what makes rimo predictable in scripts:

bash
rimo note list | jq '.notes[].title'
rimo note list --fields id,title,created_at

When you want to read a result rather than parse it, add --pretty for a table:

bash
rimo note list --pretty

It is opt-in and never automatic, so nothing you already script changes.

A few commands print plain text instead: rimo version, rimo upgrade, rimo note ask, and rimo note get with content flags. Errors are always JSON.

See Output & Errors for the full contract.

Next steps ​