Circleback How-To

Appearance

Circleback CLI ​

Fresh   Published 2026-04-18

Access Circleback data from the command line, or give your AI agents the conversation context they need to get things done. Have an agent follow up on action items from this morning's standup, or draft a spec based on your last product review.

Setup ​

Install the CLI:

bash
npm install -g @circleback/cli

Authenticate with your Circleback account:

bash
circleback login

This opens a browser window to log in. Once authenticated, you are ready to go. The data commands use the cb binary.

What you can do ​

CommandDescription
cb meetings [search]Find meetings by keyword, date range, tag, attendee, or domain
cb meetings read <ids...>Detailed meeting info: notes, attendees, action items, insights, tags, duration
cb transcripts <search>Search across all meeting transcripts to find where something was mentioned
cb transcripts read <ids...>Full transcript for one or more meetings, with speaker labels and timestamps
cb action-items [search]Find action items by keyword, status (pending or done), assignee, tag, or date range
cb calendarSearch upcoming and past calendar events, including attendees and meeting links
cb emails [search]Search connected email accounts for threads by keyword, sender, recipient, or date range
cb people <names...>Look up people by name to see profile and interaction history across meetings
cb companies <terms...>Look up companies by name to find their domain and related meetings
cb tagsList all tags in your workspace, useful for filtering meetings, transcripts, or action items
cb support [search]Search Circleback support documentation for help and how-to guides

Examples ​

Meetings ​

bash
cb meetings search "product review"          # find by topic
cb meetings search --last 7                   # last 7 days
cb meetings search --from 2026-04-01 --to 2026-04-18
cb meetings read 12345                         # full details of one meeting
cb meetings read 12345 67890                   # multiple at once

Transcripts ​

bash
cb transcripts search "pricing change"         # find where it was said
cb transcripts read 12345                       # full transcript
cb transcripts read 12345 67890                 # multiple transcripts

Action items ​

bash
cb action-items search --status pending         # your incomplete items
cb action-items search "follow up"              # by keyword
cb action-items search --status done            # completed items

Calendar ​

bash
cb calendar search --from 2026-04-18 --to 2026-04-25

Emails ​

bash
cb emails search "quarterly report"
cb emails search "participant:sarah@company.com"
cb emails search "from:ceo@company.com"
cb emails search "project update after:2026-01-01 before:2026-04-01"

People and companies ​

bash
cb people search "Sarah Kerrigan"
cb companies search "Acme"

Tags and support ​

bash
cb tags list
cb support search "recording in-person meetings"

JSON output ​

All commands support --json for raw JSON output, useful for scripting, piping into other tools, or feeding data to AI agents.

bash
cb meetings search "standup" --last 7 --json