Enum TaskCommands 

pub enum TaskCommands {
    Add {
        name: String,
        parent: Option<i64>,
        spec_stdin: bool,
    },
    Get {
        id: i64,
        with_events: bool,
    },
    Update {
        id: i64,
        name: Option<String>,
        parent: Option<i64>,
        status: Option<String>,
        complexity: Option<i32>,
        priority: Option<i32>,
        spec_stdin: bool,
    },
    Del {
        id: i64,
    },
    Find {
        status: Option<String>,
        parent: Option<String>,
    },
    Start {
        id: i64,
        with_events: bool,
    },
    Done,
    PickNext {
        format: String,
    },
    SpawnSubtask {
        name: String,
        spec_stdin: bool,
    },
    Switch {
        id: i64,
    },
    Search {
        query: String,
    },
}

Variants

Add

Add a new task

Fields

name: String

Task name

parent: Option<i64>

Parent task ID

spec_stdin: bool

Read spec from stdin

Get

Get a task by ID

Fields

id: i64

Task ID

with_events: bool

Include events summary

Update

Update a task

Fields

id: i64

Task ID

name: Option<String>

New task name

parent: Option<i64>

New parent task ID

status: Option<String>

New status

complexity: Option<i32>

Task complexity (1-10)

priority: Option<i32>

Task priority

spec_stdin: bool

Read spec from stdin

Del

Delete a task

Fields

id: i64

Task ID

Find

Find tasks with filters

Fields

status: Option<String>

Filter by status

parent: Option<String>

Filter by parent ID (use “null” for no parent)

Start

Start a task (atomic: update status + set current)

Fields

id: i64

Task ID

with_events: bool

Include events summary

Done

Complete the current focused task (atomic: check children + update status + clear current) This command only operates on the current_task_id. It will:

• Check all subtasks are done

• Update the task status to done

• Clear the current_task_id

  Prerequisites: A task must be set as current (via current --set <ID>)

PickNext

Intelligently recommend the next task to work on

This command uses a context-aware priority model to recommend a single task:

1. First priority: Subtasks of the current focused task (depth-first)
2. Second priority: Top-level tasks (breadth-first)

The command is non-interactive and does not modify task status.

Fields

format: String

Output format (text or json)

SpawnSubtask

Create a subtask under current task and switch to it

Fields

name: String

Subtask name

spec_stdin: bool

Read spec from stdin

Switch

Switch to a specific task (atomic: update to doing + set current)

Fields

id: i64

Task ID

Search

Search tasks by content using full-text search

Fields

query: String

Search query (supports FTS5 syntax like “bug AND NOT critical”)

Trait Implementations

impl FromArgMatches for TaskCommands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for TaskCommands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand