itack 0.1.2

Git-backed issue tracker for multi-agent coordination
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174

//! Clap argument definitions.

use clap::{Parser, Subcommand};
use clap_complete::Shell;

use crate::core::Status;

/// Git-backed issue tracker for multi-agent coordination.
#[derive(Parser, Debug)]
#[command(name = "itack")]
#[command(author, version, about, long_about = None)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Initialize a new itack project in the current git repository
    Init,

    /// Create a new issue
    Create {
        /// Issue title
        title: String,

        /// Epic/category for grouping
        #[arg(short, long)]
        epic: Option<String>,

        /// Issue body/description
        #[arg(short, long)]
        body: Option<String>,

        /// Custom git commit message (defaults to "Create issue #N: <title>")
        #[arg(short, long)]
        message: Option<String>,

        /// Issue IDs this issue depends on (comma-separated)
        #[arg(short, long, value_delimiter = ',')]
        depends_on: Vec<u32>,
    },

    /// Show issue details
    Show {
        /// Issue ID
        id: u32,

        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Open issue in editor
    Edit {
        /// Issue ID
        id: u32,

        /// Set the issue body directly (skips editor)
        #[arg(short, long)]
        body: Option<String>,

        /// Custom git commit message (defaults to "Edit issue #N")
        #[arg(short, long)]
        message: Option<String>,
    },

    /// Mark issue as done
    Done {
        /// Issue ID
        id: u32,
    },

    /// Mark issue as wont-fix
    WontFix {
        /// Issue ID
        id: u32,
    },

    /// Claim an issue for an assignee
    Claim {
        /// Issue ID
        id: u32,

        /// Assignee name
        assignee: String,

        /// Session ID (e.g., Claude Code session working on this issue)
        #[arg(short, long)]
        session: Option<String>,
    },

    /// Release a claimed issue
    Release {
        /// Issue ID
        id: u32,
    },

    /// Add dependencies to an issue
    Depend {
        /// Issue ID
        id: u32,

        /// Dependency issue IDs to add
        deps: Vec<u32>,
    },

    /// Remove dependencies from an issue
    Undepend {
        /// Issue ID
        id: u32,

        /// Dependency issue IDs to remove
        deps: Vec<u32>,
    },

    /// Set the session for an issue
    SetSession {
        /// Issue ID
        id: u32,

        /// Session name (e.g., ccx session name)
        session: String,
    },

    /// List issues
    List {
        /// Filter by status
        #[arg(short, long)]
        status: Option<Status>,

        /// Filter by epic
        #[arg(short, long)]
        epic: Option<String>,

        /// Filter by assignee
        #[arg(short, long)]
        assignee: Option<String>,

        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Show project board overview
    Board {
        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Check database health and issue synchronization
    Doctor,

    /// Search for issues by query
    Search {
        /// Search query
        query: String,

        /// Search across all git branches (uses git grep)
        #[arg(short, long)]
        all_branches: bool,

        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Generate shell completions
    Completions {
        /// Shell to generate completions for
        shell: Shell,
    },
}