The Archive · CLI reference · Commands

talos tasks

The task board: add, update, complete, dependencies, evidence, agents, schedules.

Reference for TALOS CLI 0.3.3 generated from the npm package · released

TALOS CLI 0.5.2 is out; this page still describes 0.3.3 and updates with the next build.

A task has a title, a description, a priority (low, normal, high) and a status (todo, doing, done). It can depend on other tasks, point to the sessions that prove it done, be assigned to an agent session and be attached to an automation.

OperationWhat it does
listdefault Lists the tasks.
add Adds a task.
update Changes the title, description or priority of a task.
complete Sets the status of a task; without a status, marks it done.
delete Deletes a task.
depend Makes a task depend on another.
undepend Removes a dependency.
evidence Attaches a session as evidence that the task is done.
unevidence Detaches an evidence session.
assign Assigns the task to an agent session.
unassign Removes the assignment.
schedule Attaches the task to an automation, which runs it on schedule.
unschedule Detaches the automation.

Without an operation, talos tasks runs list.

Lists the tasks.

talos tasks list

Adds a task.

talos tasks add <title> <description> [--priority low|normal|high]

Arguments

title
Title.
description
What has to be done.

Options

--priority <value> default normal
Default normal. Valueslownormalhigh

Changes the title, description or priority of a task.

talos tasks update <id> [--title <text>] [--description <text>] [--priority low|normal|high]

Arguments

id
The id talos tasks list shows.

Options

--title <value>
New title.
--description <value>
New description.
--priority <value>
New priority. Valueslownormalhigh

Sets the status of a task; without a status, marks it done.

talos tasks complete <id> [todo|doing|done]

Arguments

id
Task id.
statusoptional
todo, doing or done (default).

Deletes a task.

talos tasks delete <id>

Arguments

id
The id talos tasks list shows.

Makes a task depend on another.

talos tasks depend <task-id> <dependency-id>

Arguments

task-id
A task id, as talos tasks list shows it.
dependency-id
The id of the task it depends on.

Removes a dependency.

talos tasks undepend <task-id> <dependency-id>

Arguments

task-id
A task id, as talos tasks list shows it.
dependency-id
The id of the task it depends on.

Attaches a session as evidence that the task is done.

talos tasks evidence <task-id> <session-id>

Arguments

task-id
A task id, as talos tasks list shows it.
session-id
A session id, as talos session list shows it.

Detaches an evidence session.

talos tasks unevidence <task-id> <session-id>

Arguments

task-id
A task id, as talos tasks list shows it.
session-id
A session id, as talos session list shows it.

Assigns the task to an agent session.

talos tasks assign <task-id> <agent-session-id>

Arguments

task-id
A task id, as talos tasks list shows it.
agent-session-id
The id of the agent session.

Removes the assignment.

talos tasks unassign <task-id> <agent-session-id>

Arguments

task-id
A task id, as talos tasks list shows it.
agent-session-id
The id of the agent session.

Attaches the task to an automation, which runs it on schedule.

talos tasks schedule <task-id> <automation-id>

Arguments

task-id
A task id, as talos tasks list shows it.
automation-id
An automation id, as talos automation list shows it.

Detaches the automation.

talos tasks unschedule <task-id> <automation-id>

Arguments

task-id
A task id, as talos tasks list shows it.
automation-id
An automation id, as talos automation list shows it.

Type to search the guides.