Enum Commands 

pub enum Commands {
    Task(TaskCommands),
    Current {
        set: Option<i64>,
        command: Option<CurrentAction>,
    },
    Report {
        since: Option<String>,
        status: Option<String>,
        filter_name: Option<String>,
        filter_spec: Option<String>,
        format: String,
        summary_only: bool,
    },
    Event(EventCommands),
    Search {
        query: String,
        tasks: bool,
        events: bool,
        limit: Option<i64>,
    },
    Doctor,
    McpServer,
    SessionRestore {
        include_events: usize,
        workspace: Option<String>,
    },
    Dashboard(DashboardCommands),
    Setup {
        target: Option<String>,
        scope: String,
        dry_run: bool,
        force: bool,
        diagnose: bool,
        config_path: Option<String>,
        project_dir: Option<String>,
    },
    Add {
        name: String,
        spec: Option<String>,
        parent: Option<i64>,
        priority: Option<String>,
    },
    Start {
        id: i64,
        with_events: bool,
    },
    Done,
    Switch {
        id: i64,
        with_events: bool,
    },
    Log {
        event_type: String,
        data: String,
        task_id: Option<i64>,
    },
    Next {
        format: String,
    },
    List {
        status: Option<String>,
        parent: Option<String>,
    },
    Context {
        task_id: Option<i64>,
    },
    Get {
        id: i64,
        with_events: bool,
    },
}

Variants

Task(TaskCommands)

Task management commands

Current

Workspace state management

Fields

set: Option<i64>

Set the current task ID (for backward compatibility)

command: Option<CurrentAction>

Report

Generate analysis and reports

Fields

since: Option<String>

Time duration (e.g., “7d”, “2h”, “30m”)

status: Option<String>

Filter by status

filter_name: Option<String>

Filter by name pattern (FTS5)

filter_spec: Option<String>

Filter by spec pattern (FTS5)

format: String

Output format

summary_only: bool

Return summary only

Event(EventCommands)

Event logging commands

Search

Unified search across tasks and events

Fields

query: String

Search query (supports FTS5 syntax like “JWT AND authentication”)

tasks: bool

Search in tasks (default: true)

events: bool

Search in events (default: true)

limit: Option<i64>

Maximum number of results (default: 20)

Doctor

Check system health and dependencies

McpServer

Start MCP server for AI assistants (JSON-RPC stdio)

SessionRestore

Restore session context for AI agents (Focus Restoration - Phase 1)

This command returns all context needed to restore work continuity:

• Current focused task
• Parent task and siblings progress
• Child tasks status
• Recent events (decisions, blockers, notes)
• Suggested next commands

Designed for SessionStart hooks to inject context at the beginning of new sessions.

Fields

include_events: usize

Number of recent events to include (default: 3)

workspace: Option<String>

Workspace path (default: current directory)

Dashboard(DashboardCommands)

Dashboard management commands

Setup

Unified setup command for AI tool integrations

This command provides a unified interface for setting up intent-engine integration with various AI assistant tools. It handles both hook installation and MCP server configuration in one step.

Features:

• User-level or project-level installation
• Atomic setup with rollback on failure
• Built-in connectivity testing
• Diagnosis mode for troubleshooting

Fields

target: Option<String>

Target tool to configure (claude-code, gemini-cli, codex)

scope: String

Installation scope: user (default, recommended), project, or both

dry_run: bool

Show what would be done without actually doing it

force: bool

Overwrite existing configuration

diagnose: bool

Run diagnosis on existing setup instead of installing

config_path: Option<String>

Custom config file path (advanced)

project_dir: Option<String>

Project directory for INTENT_ENGINE_PROJECT_DIR env var

Add

Add a new task (alias for ‘task add’)

Fields

name: String

Task name

spec: Option<String>

Detailed specification (markdown)

parent: Option<i64>

Parent task ID

priority: Option<String>

Priority (critical, high, medium, low)

Start

Start a task and set focus (alias for ‘task start’)

Fields

id: i64

Task ID

with_events: bool

Include events summary

Done

Complete the current focused task (alias for ‘task done’)

Switch

Switch to a different task (alias for ‘task switch’)

Fields

id: i64

Task ID

with_events: bool

Include events summary

Log

Record an event for current task (alias for ‘event add’)

Fields

event_type: String

Event type (decision, blocker, milestone, note)

data: String

Event data/description

task_id: Option<i64>

Task ID (optional, uses current task if not specified)

Next

Get the next recommended task (alias for ‘task pick-next’)

Fields

format: String

Output format (text or json)

List

List tasks with filters (alias for ‘task list’)

Examples: ie ls # List all tasks ie ls todo # List todo tasks ie ls doing # List doing tasks ie ls done # List done tasks

Fields

status: Option<String>

Filter by status (todo, doing, done)

parent: Option<String>

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

Context

Get task context (alias for ‘task context’)

Fields

task_id: Option<i64>

Task ID (optional, uses current task if omitted)

Get

Get task details (alias for ‘task get’)

Fields

id: i64

Task ID

with_events: bool

Include events summary

Trait Implementations

impl FromArgMatches for Commands

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 Commands

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