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. Everything here is encrypted on your device like the rest of your workspace.

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 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 share 12
>doc split 12 --by headers

See also: docs, pull, folder

doc share makes the doc readable by anyone with the generated link — BEAM warns you before it does. doc unshare revokes the link. doc rm moves to trash; doc purge is permanent.

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.