aitasks 1.0.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +26 -13
  2. package/dist/index.js +14892 -132
  3. package/package.json +4 -3
package/README.md CHANGED
@@ -21,12 +21,12 @@ bun install -g aitasks
21
21
  aitasks init
22
22
 
23
23
  # 2. Create a task
24
- aitasks create --title "Add JWT auth" --priority high --ac "POST /login returns token" --ac "Token expires in 1h"
24
+ aitasks create --title "Add JWT auth" --desc "Implement user authentication" --priority high --ac "POST /login returns token" --ac "Token expires in 1h"
25
25
 
26
- # 3. Agent picks up work
27
- aitasks next --agent claude-sonnet
26
+ # 3. Agent picks up work (one-liner with auto-claim)
27
+ aitasks next --claim --agent claude-sonnet
28
28
 
29
- # 4. Claim and start
29
+ # 4. Or claim and start separately
30
30
  aitasks claim TASK-001 --agent claude-sonnet
31
31
  aitasks start TASK-001 --agent claude-sonnet
32
32
 
@@ -41,6 +41,13 @@ aitasks check TASK-001 1 --evidence "token exp claim set to now+3600, confirmed
41
41
  aitasks done TASK-001 --agent claude-sonnet
42
42
  ```
43
43
 
44
+ **Pro tips:**
45
+ - Use `aitasks next --claim --agent <id>` to find, claim, and start in one command
46
+ - Bulk operations: `aitasks done TASK-001 TASK-002 TASK-003 --agent <id>`
47
+ - Pattern matching: `aitasks claim TASK-0* --agent <id>` claims all TASK-00x tasks
48
+ - Search: `aitasks search "auth"` finds tasks mentioning authentication
49
+ - Undo mistakes: `aitasks undo TASK-001`
50
+
44
51
  ---
45
52
 
46
53
  ## Environment Variables
@@ -73,7 +80,10 @@ export AITASKS_JSON=true
73
80
  | `aitasks list` | List all tasks, sorted by priority |
74
81
  | `aitasks list --status ready` | Filter by status (`ready`, `in_progress`, `done`, `blocked`, `needs_review`) |
75
82
  | `aitasks next` | Show the highest-priority unblocked ready task |
76
- | `aitasks show <id>` | Full detail on a specific task |
83
+ | `aitasks next --claim --agent <id>` | Auto-claim and start the best task |
84
+ | `aitasks show <id>` | Full detail on a specific task (includes time tracking) |
85
+ | `aitasks search <query>` | Full-text search across titles, descriptions, and notes |
86
+ | `aitasks deps <id>` | Show dependency tree (what blocks what) |
77
87
  | `aitasks board` | Kanban-style board view |
78
88
 
79
89
  ### Task Lifecycle
@@ -81,14 +91,17 @@ export AITASKS_JSON=true
81
91
  | Command | Description |
82
92
  |---|---|
83
93
  | `aitasks create` | Create a task (interactive if no flags given) |
84
- | `aitasks claim <id> --agent <id>` | Claim a task |
85
- | `aitasks start <id> --agent <id>` | Begin active work |
94
+ | `aitasks claim <id...> --agent <id>` | Claim task(s) - supports patterns like `TASK-0*` |
95
+ | `aitasks start <id...> --agent <id>` | Begin active work on task(s) |
86
96
  | `aitasks note <id> <text>` | Add an implementation note |
87
97
  | `aitasks check <id> <n> --evidence <text>` | Verify acceptance criterion n |
88
- | `aitasks done <id> --agent <id>` | Mark complete (all criteria must be verified) |
89
- | `aitasks review <id> --agent <id>` | Submit for human review |
98
+ | `aitasks done <id...> --agent <id>` | Mark task(s) complete (all criteria must be verified) |
99
+ | `aitasks review <id...> --agent <id>` | Submit for human review |
90
100
  | `aitasks reject <id> --reason <text>` | Reject and send back to in_progress |
91
101
  | `aitasks unclaim <id> --agent <id>` | Release a task back to the pool |
102
+ | `aitasks undo <id>` | Undo the last action on a task |
103
+
104
+ **Note:** Commands marked with `<id...>` support multiple task IDs and pattern matching (e.g., `TASK-0*`).
92
105
 
93
106
  ### Blocking
94
107
 
@@ -121,10 +134,10 @@ export AITASKS_JSON=true
121
134
  aitasks create \
122
135
  --title "My task" \
123
136
  --desc "Longer description" \
124
- --priority high \ # critical | high | medium | low (default: medium)
125
- --type feature \ # feature | bug | chore | docs
126
- --ac "Returns 200" \ # Acceptance criterion (repeatable)
127
- --parent TASK-001 # Parent task ID
137
+ --ac "Returns 200" \ # Acceptance criterion (repeatable, at least one required)
138
+ --priority high \ # critical | high | medium | low
139
+ --type feature \ # feature | bug | chore | spike
140
+ --parent TASK-001 # Parent task ID (optional)
128
141
  ```
129
142
 
130
143
  ---