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,
    },
    Plan {
        format: String,
    },
    Event(EventCommands),
    Search {
        query: String,
        tasks: bool,
        events: bool,
        limit: Option<i64>,
        offset: Option<i64>,
    },
    Doctor,
    Init {
        at: Option<String>,
        force: bool,
    },
    McpServer {
        dashboard_port: Option<u16>,
    },
    SessionRestore {
        include_events: usize,
        workspace: Option<String>,
    },
    Dashboard(DashboardCommands),
    Setup {
        target: Option<String>,
        scope: String,
        force: bool,
        config_path: Option<String>,
    },
    Add {
        name: String,
        spec: Option<String>,
        parent: Option<i64>,
        priority: Option<String>,
    },
    Start {
        id: i64,
        with_events: bool,
    },
    Done,
    Log {
        event_type: String,
        data: String,
        task_id: Option<i64>,
    },
    Next {
        format: String,
    },
    List {
        status: Option<String>,
        parent: Option<String>,
        sort_by: Option<String>,
        limit: Option<i64>,
        offset: Option<i64>,
    },
    Context {
        task_id: Option<i64>,
    },
    Get {
        id: i64,
        with_events: bool,
    },
    Logs {
        mode: Option<String>,
        level: Option<String>,
        since: Option<String>,
        until: Option<String>,
        limit: Option<usize>,
        follow: bool,
        export: String,
    },
}

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

Plan

Create or update task structures declaratively

Reads a JSON plan from stdin and creates/updates tasks atomically. Supports hierarchical nesting and name-based dependencies.

Example: echo ‘{“tasks”: [{“name”: “Task A”, “children”: [{“name”: “Task B”}]}]}’ | ie plan

Fields

format: String

Output format (text or json)

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)

offset: Option<i64>

Result offset for pagination (default: 0)

Doctor

Check system health and dependencies

Init

Initialize a new Intent-Engine project

Creates a .intent-engine directory with database in the current working directory. Use –at to specify a different location.

Examples: ie init # Initialize in current directory ie init –at /my/project # Initialize at specific directory

Fields

at: Option<String>

Custom directory to initialize (default: current directory)

force: bool

Re-initialize even if .intent-engine already exists

McpServer

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

Fields

dashboard_port: Option<u16>

Dashboard port to connect to (default: 11391)

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

force: bool

Overwrite existing configuration

config_path: Option<String>

Custom config file path (advanced)

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’)

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 ie ls –limit 20 –offset 0 # Paginate results ie ls –sort-by priority # Sort by priority

Fields

status: Option<String>

Filter by status (todo, doing, done)

parent: Option<String>

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

sort_by: Option<String>

Sort by (id, priority, time, focus)

limit: Option<i64>

Maximum number of tasks to return (default: 100)

offset: Option<i64>

Offset for pagination (default: 0)

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

Logs

Query and view application logs

Examples: ie logs # Show recent logs from all modes ie logs –mode dashboard # Show dashboard logs only ie logs –level error –since 1h # Show errors from last hour ie logs –follow # Real-time log monitoring

Fields

mode: Option<String>

Filter by application mode (dashboard, mcp-server, cli)

level: Option<String>

Filter by log level (error, warn, info, debug, trace)

since: Option<String>

Show logs since duration (e.g., “1h”, “24h”, “7d”)

until: Option<String>

Show logs until timestamp (ISO8601 format)

limit: Option<usize>

Maximum number of log entries to show

follow: bool

Follow logs in real-time (like tail -f)

export: String

Export format (text or json)

Trait Implementations

impl Clone for Commands

fn clone(&self) -> Commands

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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