Discovery

Finding things, remembering things, and keeping a record of what you decided. Search and memory are the retrieval half; the Decision Ledger (decide / decisions) is the judgment half — a durable record of choices and the model positions that informed them.

search

Aliases: none
Purpose: Search tasks and docs.
Syntax:

>search <query>

Flags: none
Examples:

>search AV setup

See also: docs, memory, pull

Matches titles, tags, list and project names, and doc content.

decide

Aliases: none
Purpose: Record a decision — your choice, your reasoning, and the model positions behind it.
Syntax:

>decide <choice> --why <rationale> [--confidence <0-1>] [--review <date>] [--doc <title>] [--question <text>]

Flags:

>--why <rationale>      why you chose this (required)
>--confidence <0-1>     how confident you are
>--review <date>        when to revisit the decision
>--doc <title>          the saved council/debate doc that informed it
>--question <text>      the question decided, if not obvious from the doc

Examples:

>decide open with the story --why the demo can fail live --confidence 0.7
>decide skip the second rehearsal --why diminishing returns --doc "Council: rehearsal plan"

See also: decisions, council

Shows a receipt and records only after you confirm with y. If you omit --confidence, the confirmation asks for it (y 0.7) — BEAM never invents a confidence number for you. Point --doc at a saved council or debate doc and the dissenting model positions are captured alongside your choice.

decisions

Aliases: none
Purpose: Browse recorded decisions.
Syntax:

>decisions
>decisions search <query>
>decisions #N

Flags: none
Examples:

>decisions
>decisions search rehearsal
>decisions #12

See also: decide, council

Each entry shows your choice, a confidence band, and how many models dissented. #N filters to decisions linked to a task. The Decisions panel on the right shows the same record as a timeline. For the raw transcripts behind a decision, use council history / council search.

memory

Aliases: none
Purpose: What BEAM remembers about you and your work.
Syntax:

>memory
>memory <query>
>memory list [--category <name>]
>memory add "content" --category <preference|pattern|decision|goal|relationship>
>memory delete <number-or-text>
>memory assumptions
>memory test <ref> confirm|reject
>memory reset <patterns|preferences|assumptions|category|all>
>memory stats

Flags:

>--category <name>    filter or classify by category

Examples:

>memory
>memory add "prefers morning rehearsals" --category preference
>memory test 3 reject

See also: portrait, search

Memories accrue two ways: you add them explicitly, or BEAM extracts them from your side of AI conversations. Each carries a confidence zone (● established, ◐ likely, ○ tentative, ◌ untested); assumptions lists the untested ones and test lets you confirm or reject them, which adjusts confidence. reset clears confidence without deleting content. When encryption is on, memories are encrypted on your device like the rest of your workspace, with keys that stay on your device.

shelf

Aliases: none
Purpose: Frictionless capture for half-formed ideas.
Syntax:

>shelf
>shelf "idea"
>shelf this
>shelf promote <n>
>shelf drop <n>
>shelf clear

Flags: none
Examples:

>shelf "what if the demo runs on stage wifi — fallback?"
>shelf this
>shelf promote 2

See also: add, ask

shelf this shelves the last AI response. promote turns a shelved item into a real task when it's ready.

activity

Aliases: feed
Purpose: Recent activity in the workspace.
Syntax:

>activity

Flags: none
Examples:

>activity

See also: history

history

Aliases: none
Purpose: Recent command history.
Syntax:

>history

Flags: none
Examples:

>history

See also: activity

inspire

Aliases: none
Purpose: Print a random BEAM quote.
Syntax:

>inspire

Flags: none
Examples:

>inspire

See also: brief