Trash & recovery

Nothing in BEAM disappears in one step. Deleted items go to trash and can be restored; the workspace snapshots itself locally every half hour; undo reverts the last change. Permanent removal always takes a second, explicit action.

trash

Aliases: none
Purpose: List trashed items.
Syntax:

>trash

Flags: none
Examples:

>trash

See also: restore, purge, empty

restore

Aliases: none
Purpose: Restore items from trash.
Syntax:

>restore #ID
>restore all

Flags: none
Examples:

>restore #17
>restore all

See also: trash, purge

purge

Aliases: none
Purpose: Permanently remove trashed items.
Syntax:

>purge #ID
>purge all

Flags: none
Examples:

>purge #17

See also: trash, empty

Permanent. A purged item cannot be restored.

empty

Aliases: none
Purpose: Empty the trash.
Syntax:

>empty trash

Flags: none
Examples:

>empty trash

See also: trash, purge

undo

Aliases: none
Purpose: Revert the last change.
Syntax:

>undo

Flags: none
Examples:

>undo

See also: trash, snapshots

Shows how many more steps of undo remain.

snapshots

Aliases: snapshot
Purpose: List, restore, or clear local data snapshots.
Syntax:

>snapshots
>snapshots restore <slot>
>snapshots clear

Flags: none
Examples:

>snapshots
>snapshots restore 2

See also: sync, undo

BEAM keeps five rolling snapshots of your workspace on this device, taken at load, at unlock, and every 30 minutes. Each slot shows its age and task counts. restore backs up the current state first, then loads the slot. clear drops the ring to reclaim local storage — live data is untouched and snapshots start accumulating again.

clear

Aliases: cls, sweep
Purpose: Clear the terminal screen, or hide tasks from the active view.
Syntax:

>clear
>clear <task>
>clear done
>clear all done

Flags: none
Examples:

>clear
>clear done

See also: unclear, show

Bare clear just clears the screen. Clearing tasks hides them without deleting; bulk forms confirm first.

unclear

Aliases: none
Purpose: Bring a cleared task back into view.
Syntax:

>unclear #N
>unclear <title>

Flags: none
Examples:

>unclear #17

See also: clear, show

show

Aliases: none
Purpose: List cleared tasks in the current project.
Syntax:

>show cleared

Flags: none
Examples:

>show cleared

See also: clear, unclear