System & data

Health checks, sync, import/export, and integrations. Also home to the two commands with real teeth — sync force and reset — both of which make you confirm before anything happens.

A few low-level support utilities exist beyond these (logs, syslogs, flight, debug) — you'll generally only touch them when the team asks for diagnostics during a support conversation.

status

Aliases: none
Purpose: System health overview.
Syntax:

>status [backend|ai|usage]

Flags: none
Examples:

>status
>status ai

See also: ping, sync

Backend reachability, AI provider health, storage, and session details.

ping

Aliases: none
Purpose: Quick backend liveness check.
Syntax:

>ping

Flags: none
Examples:

>ping

See also: status

sync

Aliases: none
Purpose: Show sync status, or force-resolve a sync conflict.
Syntax:

>sync
>sync force

Flags: none
Examples:

>sync
>sync force

See also: snapshots, status, account

BEAM syncs continuously in the background; the status bar shows synced / syncing / pending. sync force overwrites the cloud with this device's state — it first shows a diagnostic receipt (local counts, guard status, any detected corruption) and requires a y to proceed. If the receipt warns about corruption, follow its recommendation rather than forcing.

export

Aliases: none
Purpose: Export your workspace data.
Syntax:

>export

Flags: none
Examples:

>export

See also: account, import

import

Aliases: none
Purpose: Import tasks and docs from files, other tools, or the clipboard.
Syntax:

>import
>import csv
>import todoist
>import text
>import photo
>import file
>import clipboard
>import history
>import undo

Flags: none
Examples:

>import csv
>import clipboard

See also: export, doc

CSV, Todoist JSON, pasted text, screenshots (text extracted on your device), and files. import history shows past imports; import undo reverts the last one. Dragging files onto the app is the faster path for documents.

mcp

Aliases: none
Purpose: Manage tool-server connections (Model Context Protocol).
Syntax:

>mcp
>mcp status
>mcp servers
>mcp connect <id>
>mcp disconnect <id>
>mcp tools

Flags: none
Examples:

>mcp status
>mcp tools

See also: drive, status

BEAM's built-in tools (tasks, docs, search, memories) are available to the AI on every account. External integrations — Google Drive, Docs, Calendar, GitHub — are enabled per-account during the private beta; if mcp servers shows none, your account doesn't have them yet.

drive

Aliases: none
Purpose: Browse Google Drive and link files to tasks.
Syntax:

>drive
>drive browse
>drive search "query"
>drive link #N "file"
>drive unlink #N <i>
>drive status

Flags: none
Examples:

>drive search "talk slides"
>drive link #5 "Tuesday deck"

See also: mcp, link

Requires a connected Google account; Google integrations are enabled per-account during the private beta.

migration

Aliases: none
Purpose: Show the latest local-storage hygiene audit.
Syntax:

>migration audit [--json]

Flags:

>--json    raw output

Examples:

>migration audit

See also: status

reset

Aliases: wipe
Purpose: Permanently wipe all BEAM data on this device.
Syntax:

>reset
>reset confirm

Flags: none
Examples:

>reset

See also: account, signout

Bare reset only warns and explains. The wipe requires typing reset confirm in full. It clears this device — cloud data survives and comes back on sign-in, unless you also run cloud deletion from account.