Documents

Docs are BEAM's long-form surface: notes you write, files you import, and answers the AI saves. Docs live in projects, optionally inside folders, and can be linked to tasks. When you turn on encryption (Settings → Encryption), docs are encrypted on your device with keys that stay on your device.

You can also create docs without a command: drag a PDF, DOCX, TXT, MD, RTF, or CSV file (or an image) anywhere onto the app. PDFs render page-for-page with the original preserved; scanned PDFs get a searchable text layer built on your device. Files up to 50 MB.

doc

Aliases: none
Purpose: Open, edit, organize, share, and manage documents.
Syntax:

>doc <id-or-title>
>doc edit <id>
>doc append <id> "text"
>doc prepend <id> "text"
>doc rename <id> "New Title"
>doc rm <id>
>doc rm <pattern*>
>doc restore <title>
>doc purge <title>
>doc link <id> <url> ["title"]
>doc link <id> --task <N>
>doc unlink <id> <index-or-url>
>doc split <id> [--by scenes|sections|headers|paragraphs]
>doc share <id>
>doc unshare <id>
>doc attach <doc> --task <task>
>doc detach <doc>
>doc pin <id>
>doc unpin <id>

Flags:

>--task <N>                              link or attach to a task instead of a URL
>--by <scenes|sections|headers|paragraphs>    how doc split divides the document

Examples:

>doc "Talk outline"
>doc append 12 "Closing: end on the audience question"
>doc rm mod*
>doc share 12
>doc split 12 --by headers

See also: docs, pull, folder

doc share mints a read-only public link. BEAM encrypts the document under a fresh key made just for that share, sends only the ciphertext to the server, and puts the key in the link itself after the # — so the share link carries its own key and the server stores only ciphertext. Two consequences worth knowing: link previews in Slack, iMessage and email will be blank, and the key is saved only on the device that created the link (another device can revoke the share but cannot rebuild its URL). Send the whole link, including the part after the #; without it the recipient sees "this link is missing its key". Anyone holding the link can read the document — that is what sharing means. doc unshare deletes the server copy, and the link stops working. doc rm moves to trash; doc purge is permanent, and it asks for a typed code rather than a y. Its match is a substring against trashed docs and it takes the first hit, so the confirm names the doc it resolved to and says how many others your words also matched — re-run with a more specific title to pick a different one. It also tells you the doc's share link dies with it. Afterwards BEAM re-reads the trash and reports what actually went. A * in the doc rm query bulk-trashes every doc whose title matches the pattern (doc rm mod* sweeps mod1 through mod110) — it shows the match count, asks y/n, and only ever moves docs to the trash, so the irreversible steps stay purge all and doc purge. Moving a shared doc to the trash does not revoke its link — the doc keeps its share, so unshare it first if you want the link dead now. Purging does revoke it, including the automatic 30-day purge of trashed items.

docs

Aliases: none
Purpose: List documents, or show the docs linked to a task or project.
Syntax:

>docs
>docs <task ref>
>docs in <project>

Flags: none
Examples:

>docs
>docs #5
>docs in "Tuesday talk"

See also: doc, search

pull

Aliases: fetch, get
Purpose: Print a document's content in the terminal.
Syntax:

>pull <doc title>

Flags: none
Examples:

>pull "Talk outline"

See also: doc, search

folder

Aliases: folders
Purpose: Organize docs into folders.
Syntax:

>folder new "Name"
>folder rename "Old" "New"
>folder rm "Name"
>folder list
>folder move "doc" "folder"
>folder unfiled "doc"

Flags: none
Examples:

>folder new "Research"
>folder move "Talk outline" "Research"

See also: doc, docs

Deleting a folder unfiles its docs; it never deletes them.

consolidate

Aliases: dedup, merge-docs
Purpose: Find overlapping docs and merge them, with your approval.
Syntax:

>consolidate
>consolidate --project
>consolidate --dry-run
>consolidate #42 #43

Flags:

>--project     limit the scan to the active project
>--dry-run     show the proposed clusters without merging anything

Examples:

>consolidate --dry-run
>consolidate #42 #43

See also: doc, docs

An AI pass clusters docs that cover the same ground, shows you the proposed merges as a review receipt, and only merges what you approve.

context

Aliases: none
Purpose: Manage persistent context the AI sees on every query.
Syntax:

>context
>context load [text|file] [--name X]
>context list
>context remove <name-or-#>
>context clear

Flags:

>--name <name>    label for the loaded context

Examples:

>context load text --name "style guide"
>context list
>context remove 1

See also: ask, project

Loaded context persists across sessions until you remove it. For per-project standing guidance, project instructions is usually the better tool.