Circleback CLI

Search and access your meetings, transcripts, emails, calendar events, and more from the terminal.

Installation

npm install -g @circleback/cli

Requires Node.js 18 or later. The package installs two binaries: circleback and cb (shorthand).

Quick start

# Authenticate via browser
cb login

# Search recent meetings
cb meetings

# Search by keyword
cb meetings "product review"

# Read full meeting details
cb meetings read 12345

# Search transcripts
cb transcripts "pricing discussion"

# Search emails
cb emails "from:[email protected] after:2026-01-01"

# Get raw JSON for scripting
cb meetings --json

Commands

| Command | Description | | ------------------------------ | --------------------------------------------------- | | cb login | Authenticate with Circleback via browser | | cb logout | Clear stored authentication tokens | | cb update | Update CLI to the latest version | | cb meetings [search] | Search meetings | | cb meetings read <ids...> | Read detailed meeting info, notes, and action items | | cb transcripts <search> | Search transcript content | | cb transcripts read <ids...> | Read full transcripts | | cb calendar | Search calendar events | | cb people <names...> | Search people by name | | cb companies <terms...> | Search companies by domain | | cb emails [search] | Search connected email accounts | | cb support [search] | Search Circleback support articles |

Run cb --help or cb <command> --help for full usage details.

Filtering

Meeting, transcript, and calendar searches support filtering by date range. Meeting and transcript searches also support filtering by tag, person, and company:

cb meetings --tags 1,2 --profiles 42 --domains acme.com
cb meetings --last 30              # Last 30 days
cb meetings --from 2026-01-01 --to 2026-03-01
cb calendar --last 7                # Next 7 days of events

Email search supports inline filter syntax:

cb emails "from:[email protected]"
cb emails "to:[email protected] after:2026-01-01"
cb emails "participant:[email protected] before:2026-06-01"

JSON output

Pass --json to any command to get raw JSON instead of formatted tables. Useful for piping to jq or integrating with other tools:

cb meetings "standup" --json | jq '.[].name'

Authentication

cb login    # Opens browser to authenticate
cb logout   # Clears stored tokens

Agents

The CLI is designed to work well with AI agents and tool-use systems:

• Every command accepts --json for structured, parseable output
• Commands follow a consistent <resource> <action> pattern
• All options have long-form names for clarity
• Error messages include actionable instructions
• Exit codes follow standard conventions (0 = success, 1 = error)

Links

• Circleback
• Support