CLI Reference

Install the CLI first if you have not set it up yet:

npm


npm install -g @beeai/cli

Verify installation:


bee version

Authentication

`bee login`

Authenticate with your Bee account.


bee login
bee login --qr
bee login --token <token>
bee login --token-stdin

`bee status`

Check your authentication status.


bee status

`bee logout`

Clear your stored credentials.


bee logout

User Data

`bee me`

Fetch your user profile information.

markdown


bee me

Example output


# Profile
 
- timezone: America/Los_Angeles
- first_name: Alex
- last_name: Rivera

`bee today`

Get today’s brief including calendar events and emails.

markdown


bee today

Example output


# Today Brief
 
- timezone: America/Los_Angeles
- calendar_events: (none)
- emails: (none)

`bee now`

Fetch recent conversations with utterances. See Agentic Now for agent-focused guidance.

markdown


bee now

Example output


# Now
 
- timezone: America/Los_Angeles
 
## Conversation 987654
> To read the full conversation, run: `bee conversations get 987654`
 
- start_time: 2026-02-10 09:00 [3 hours ago]
- end_time: 2026-02-10 09:25 [2 hours ago]
- state: COMPLETED
 
Roadmap planning for Q1 milestones
 
Utterances
- Alex: Let's lock scope for the next sprint.
- Sam: I will draft the release checklist today.

`bee changed`

Retrieve recently changed entities. See Agentic Sync for details.

markdown


bee changed
bee changed --cursor <cursor>

Example output


# Changed
 
From: 2026-02-09 13:43 [1 day ago]
Until: 2026-02-10 13:43 [0 seconds ago]
Next Cursor: v1-1770759786297
 
# Confirmed Facts
- Prefers morning meetings
 
-----
 
# Pending Facts
- Steve is confused about where current AMIs come from in his deployment pipeline
- Steve needs cloud-init functionality to touch functions on the fly during deployment
 
-----
 
# Conversations
- timezone: America/Los_Angeles
 
### Conversation 6531525
- start_time: 2026-02-10 10:14 [3 hours ago]
- end_time: 2026-02-10 10:54 [3 hours ago]

Facts

Manage your personal facts and preferences.

`bee facts list`

List your facts.

markdown


bee facts list
bee facts list --limit 50
bee facts list --cursor <cursor>
bee facts list --unconfirmed

Example output


# Confirmed Facts
 
- User prefers morning standups.
- User keeps project notes in markdown.
 
-----
 
## Pagination
 
- next_cursor: v1-1762285321128-6777613

`bee facts get`

Retrieve a specific fact by ID.

markdown


bee facts get <id>

`bee facts create`

Create a new fact.

markdown


bee facts create --text "Prefers morning meetings"

Example output


# Fact 9001
 
- timezone: America/Los_Angeles
- created_at: 2026-02-10 12:30 [just now]
- confirmed: false
- text: Prefers morning meetings

`bee facts update`

Update an existing fact.

markdown


bee facts update <id> --text "Updated fact"
bee facts update <id> --text "Updated fact" --confirmed true

Example output


# Fact 9001
 
- timezone: America/Los_Angeles
- created_at: 2026-02-10 12:30 [5 minutes ago]
- confirmed: true
- text: Updated fact

`bee facts delete`

Delete a fact.

markdown


bee facts delete <id>

Example output


Deleted fact 9001.

Todos

Manage your todos.

`bee todos list`

List your todos.

markdown


bee todos list
bee todos list --limit 50
bee todos list --cursor <cursor>

Example output


# Todos
 
## Open
 
### Todo 1001
- timezone: America/Los_Angeles
- created_at: 2026-02-10 08:30 [4 hours ago]
- alarm_at: n/a
- completed: false
- text: Draft release notes
 
## Completed
- (none)

`bee todos get`

Retrieve a specific todo by ID.

markdown


bee todos get <id>

`bee todos create`

Create a new todo.

markdown


bee todos create --text "Review the roadmap"
bee todos create --text "Review the roadmap" --alarm-at 2026-02-11T09:00:00Z

Example output


# Todo 1002
 
- timezone: America/Los_Angeles
- created_at: 2026-02-10 12:40 [just now]
- alarm_at: 2026-02-11 01:00 [in 12 hours]
- completed: false
- text: Review the roadmap

`bee todos update`

Update an existing todo.

markdown


bee todos update <id> --text "Updated todo"
bee todos update <id> --completed true
bee todos update <id> --alarm-at 2026-02-11T09:00:00Z
bee todos update <id> --clear-alarm

Example output


# Todo 1002
 
- timezone: America/Los_Angeles
- created_at: 2026-02-10 12:40 [10 minutes ago]
- alarm_at: n/a
- completed: true
- text: Updated todo

`bee todos delete`

Delete a todo.

markdown


bee todos delete <id>

Example output


Deleted todo 1002.

Conversations

Access your conversation history.

`bee conversations list`

List conversations.

markdown


bee conversations list
bee conversations list --limit 20
bee conversations list --cursor <cursor>

`bee conversations get`

Retrieve a specific conversation by ID.

markdown


bee conversations get <id>

Daily Summaries

Access daily summaries.

`bee daily list`

List daily summaries.

markdown


bee daily list
bee daily list --limit 20
bee daily list --cursor <cursor>

`bee daily get`

Retrieve a specific daily summary by ID.

markdown


bee daily get <id>

Journals

Access your journals.

`bee journals list`

List journals.

markdown


bee journals list
bee journals list --limit 20
bee journals list --cursor <cursor>

`bee journals get`

Retrieve a specific journal by ID.

markdown


bee journals get <id>

Search

Search your developer data. See Search for default vs neural guidance.

`bee search`

Search conversation data by text query.

markdown


bee search --query "project roadmap"
bee search --query "project roadmap" --limit 20
bee search --query "What do you know about me?" --neural
bee search --query "project roadmap" --neural --limit 10

Utility Commands

`bee sync`

Export your Bee data to local markdown files. See Sync documentation for details.


bee sync
bee sync --output ~/my-bee-data
bee sync --only facts

`bee stream`

Stream real-time events from Bee. See Realtime Sync for details.


# Human-readable with colors (default)
bee stream
 
# Human-readable, token-optimized for inference (no colors)
bee stream --agent
 
# Structured JSON output
bee stream --json
 
# Optional event filtering
bee stream --types new-utterance,update-conversation --agent
bee stream --types new-utterance,update-conversation --json

`bee proxy`

Start a local HTTP API proxy. See API documentation for details. Authenticate with bee login before starting it.


bee proxy
bee proxy --port 8080

`bee ping`

Check connectivity to Bee servers.


bee ping
bee ping --count 5

`bee version`

Display the CLI version.

markdown


bee version

Global Options

These options are available at the top-level command:

Option	Description
`--help`	Show help
`--version`	Show version number

Run bee <command> --help for detailed information about any command.

CLI Reference

npm

yarn

Authentication

bee login

bee status

bee logout

User Data

bee me

markdown

json

Example output

bee today

markdown

json

Example output

bee now

markdown

json

Example output

bee changed

markdown

json

Example output

Facts

bee facts list

markdown

json

Example output

bee facts get

markdown

json

bee facts create

markdown

json

Example output

bee facts update

markdown

json

Example output

bee facts delete

markdown

json

Example output

Todos

bee todos list

markdown

json

Example output

bee todos get

markdown

json

bee todos create

markdown

json

Example output

bee todos update

markdown

json

Example output

bee todos delete

markdown

json

Example output

Conversations

bee conversations list

markdown

json

bee conversations get

markdown

json

Daily Summaries

bee daily list

markdown

json

bee daily get

markdown

json

Journals

bee journals list

`bee login`

`bee status`

`bee logout`

`bee me`

`bee today`

`bee now`

`bee changed`

`bee facts list`

`bee facts get`

`bee facts create`

`bee facts update`

`bee facts delete`

`bee todos list`

`bee todos get`

`bee todos create`

`bee todos update`

`bee todos delete`

`bee conversations list`

`bee conversations get`

`bee daily list`

`bee daily get`

`bee journals list`

`bee journals get`

`bee search`

`bee sync`

`bee stream`

`bee proxy`

`bee ping`

`bee version`