Tasks

Commands for creating, editing, completing, and organizing tasks. These are the bread-and-butter commands — they run instantly, with no AI call.

Most commands accept a task by #ID or by title. Titles match fuzzily; if a title matches more than one task, BEAM tells you instead of guessing.

add

Aliases: none
Purpose: Create a task.
Syntax:

>add <task title> [due <date>] [to <list>]

Flags: none (dates, priority, and list placement are read from the phrasing itself)
Examples:

>add buy milk due tomorrow
>add draft investor update to Work
>add fix login bug high priority

See also: subtask, edit, done

add runs your input through the natural-language parser, so dates ("due Friday"), priorities ("high priority"), and list placement ("to Work") come from plain phrasing. Anything it can't parse becomes the task title verbatim. (To create lists or projects, use create list <name> / create project <name> — add is for tasks.)

done

Aliases: complete, finish
Purpose: Complete a task.
Syntax:

>done <name-or-id>
>done all

Flags: none
Examples:

>done #17
>done buy milk
>done all

See also: delete, work

done all completes every active task and asks you to confirm first.

edit

Aliases: update, set
Purpose: Change a task's title, priority, or due date.
Syntax:

>edit <name-or-id> [--title "New title"] [--priority high] [--due tomorrow]
>edit #N title <new title>
>edit #N priority <low|medium|high>

Flags:

>--title <text>       new task title
>--priority <level>   low, medium, or high
>--due <date>         natural-language date ("tomorrow", "next Friday")

Examples:

>edit #5 --due tomorrow
>edit #5 title Ship the beta
>edit standup priority high

See also: rename, move, tag

Both forms work: flags, or plain phrasing ("edit #5 priority high").

move

Aliases: none
Purpose: Move a task to a different list.
Syntax:

>move <task> to <list>

Flags: none
Examples:

>move #12 to Backlog
>move standup notes to Work

See also: copy, edit

rename

Aliases: none
Purpose: Rename a task.
Syntax:

>rename <task> to <new name>

Flags: none
Examples:

>rename #8 to Q3 board deck

See also: edit

work

Aliases: start, focus, begin, activate
Purpose: Set a task as active — the one you're working on now.
Syntax:

>work on <name-or-id>
>work <name-or-id>

Flags: none
Examples:

>work on #3
>start investor deck

See also: stop, now

The active task is pinned as your current focus and surfaces first in views like now.

stop

Aliases: park, unfocus
Purpose: Clear the active task.
Syntax:

>stop

Flags: none
Examples:

>stop

See also: work

tasks

Aliases: none
Purpose: List your tasks.
Syntax:

>tasks

Flags: none
Examples:

>tasks

See also: today, queue, search

subtask

Aliases: sub
Purpose: Add a subtask under a parent task.
Syntax:

>subtask <parent-name-or-id> "Title" [--priority high]
>add subtask to #N <title>

Flags:

>--priority <level>   low, medium, or high

Examples:

>subtask #4 "Write the outline"
>add subtask to #4 collect screenshots due Friday

See also: subs, promote

Subtasks accept the same date and priority phrasing as add.

subs

Aliases: subtasks
Purpose: Show a task's subtasks.
Syntax:

>subs <name-or-id>

Flags: none
Examples:

>subs #4

See also: subtask, promote

promote

Aliases: none
Purpose: Promote a subtask to a top-level task.
Syntax:

>promote <name-or-id>

Flags: none
Examples:

>promote #9

See also: subtask, subs

tag

Aliases: none
Purpose: Set a task's color tag.
Syntax:

>tag <task> <color>

Flags: none
Examples:

>tag #6 red
>tag standup blue

See also: untag

Colors: red, orange, yellow, green, blue, purple, gray — or none to clear.

untag

Aliases: none
Purpose: Remove a color tag from a task.
Syntax:

>untag <task> <color>

Flags: none
Examples:

>untag #6 red

See also: tag

delete

Aliases: remove, rm
Purpose: Delete a task. Deleted tasks go to the trash and can be restored.
Syntax:

>delete <name-or-id>
>delete all done

Flags: none
Examples:

>delete #14
>delete all done

See also: done, trash, restore

delete all done clears every completed task in one pass.

copy

Aliases: cp, dup, duplicate
Purpose: Duplicate a task into another list.
Syntax:

>copy #N to "List Name"
>copy <task> to "List"

Flags: none
Examples:

>copy #7 to "Next Week"

See also: move

comment

Aliases: none
Purpose: Add a comment to a task. Comments are for people (yourself included); notes are your working scratchpad.
Syntax:

>comment <task> <text>

Flags: none
Examples:

>comment standup "looks good"
>comment #11 "blocked on legal review"

See also: comments, note

comments

Aliases: none
Purpose: Show a task's comments.
Syntax:

>comments <task>

Flags: none
Examples:

>comments #11

See also: comment

note

Aliases: none
Purpose: Keep working notes on a task — add, view, append, or clear.
Syntax:

>note #N "text"
>note #N
>note #N append "text"
>note #N clear

Flags: none
Examples:

>note #3 "password is in the vault"
>note #3 append "rotated 7/2"
>note #3

See also: notes, comment

note #N with no text shows the current notes.

notes

Aliases: none
Purpose: Same command as note — both forms work everywhere.
Syntax:

>notes #N

Flags: none
Examples:

>notes #3

See also: note

link

Aliases: none
Purpose: Attach an external URL to a task.
Syntax:

>link <name-or-id> <url> ["title"]

Flags: none
Examples:

>link #5 https://docs.google.com/doc/abc "Q3 planning doc"

See also: links, unlink

unlink

Aliases: none
Purpose: Remove a link from a task.
Syntax:

>unlink <name-or-id> <index-or-url>
>unlink <name-or-id> --all

Flags:

>--all    remove every link on the task

Examples:

>unlink #5 1
>unlink #5 --all

See also: link, links

Use the index shown by links, or paste the URL itself.

links

Aliases: none
Purpose: Show all links on a task.
Syntax:

>links <name-or-id>

Flags: none
Examples:

>links #5

See also: link, unlink

create

Aliases: new
Purpose: Create a task, list, or project explicitly.
Syntax:

>create <task title>
>create list <name>
>create project <name>

Flags: none
Examples:

>create draft the intro slide
>create list Slide work
>create project Tuesday talk

See also: add, list, project

create <title> behaves like add. The list and create project subcommands are the explicit way to make containers — add always makes a task.

task

Aliases: none
Purpose: Task management with explicit subcommands and flags.
Syntax:

>task add "Title" [--priority high] [--due tomorrow] [--tags a,b]
>task list
>task link <name-or-id> <url>
>task unlink <name-or-id> <index-or-url>
>task links <name-or-id>

Flags:

>--priority <low|medium|high>    set priority on creation
>--due <date>                    set a due date on creation
>--tags <a,b>                    comma-separated tags on creation

Examples:

>task add "Confirm AV setup" --priority high --due thursday
>task list

See also: add, edit

The power form of add — everything is an explicit flag instead of parsed phrasing. Useful when a title would otherwise be misread as a date or priority.