Package Exports

@circleback/cli/dist/client/jsonRpc.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@circleback/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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 by numeric ID
cb meetings read 12345

# Read by linkId (from the meeting URL, e.g. circleback.ai/meetings/Vd6Pz_kWqLm3xY-c8RhTn)
cb meetings read Vd6Pz_kWqLm3xY-c8RhTn

# Search transcripts
cb transcripts "pricing discussion"

# Search emails
cb emails "from:alice@example.com 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 (numeric IDs or linkIds, max 50)
`cb transcripts <search>`	Search transcript content
`cb transcripts read <ids...>`	Read full transcripts (numeric IDs or linkIds, max 50)
`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.

Meeting identifiers

cb meetings read and cb transcripts read accept up to 50 IDs in either form:

Numeric ID — the integer ID returned in search results (e.g. 12345)
linkId — the short alphanumeric slug from a meeting URL (e.g. Vd6Pz_kWqLm3xY-c8RhTn from circleback.ai/meetings/Vd6Pz_kWqLm3xY-c8RhTn)

Both forms can be mixed in a single call: cb meetings read 12345 Vd6Pz_kWqLm3xY-c8RhTn

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:alice@example.com"
cb emails "to:bob@example.com after:2026-01-01"
cb emails "participant:carol@example.com 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)

@circleback/cli