Lists & Projects

BEAM organizes work as projects containing lists containing tasks. These commands create, inspect, and retire the containers. Destructive operations confirm before running.

list

Aliases: none
Purpose: Show, create, or delete lists in the active project.
Syntax:

>list
>list "Name"
>list rm <name-or-#>

Flags: none
Examples:

>list
>list "Slide work"
>list rm "Slide work"

See also: lists, move, project

With no arguments, shows the active project's lists with active/done counts. With a name, creates the list (or opens it if it already exists).

lists

Aliases: none
Purpose: Show all lists in the active project.
Syntax:

>lists

Flags: none
Examples:

>lists

See also: list, projects

project

Aliases: none
Purpose: Show, create, delete, or configure projects.
Syntax:

>project
>project "Name"
>project rm <name> [--force]
>project link <name> <url> ["title"]
>project unlink <name> <index-or-url>
>project links <name>
>project instructions [show|set "..."|clear]

Flags:

>--force    skip the delete confirmation

Examples:

>project "Tuesday talk"
>project instructions set "Answers about this project should assume a 30-minute talk slot."
>project rm "Old sandbox"

See also: projects, archive, list

project instructions attaches standing guidance the AI reads whenever it works inside that project. Deleting a project cascades to its lists and tasks (they land in trash) and asks you to confirm first unless --force.

projects

Aliases: none
Purpose: List all projects.
Syntax:

>projects

Flags: none
Examples:

>projects

See also: project, archives