@task-mcp/cli 1.0.27 → 1.0.28

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 +7 -184
  2. package/dist/index.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,201 +1,24 @@
1
1
  # @task-mcp/cli
2
2
 
3
- Terminal dashboard for [@task-mcp/mcp-server](https://www.npmjs.com/package/@task-mcp/mcp-server).
4
-
5
- > **Note:** This CLI is a companion tool for task-mcp MCP server. It provides terminal visualization for tasks managed through Claude Code or other MCP clients. For full task management capabilities (create, update, dependencies, etc.), use the MCP server with Claude Code.
6
-
7
- ```
8
- ████████ █████ ███████ ██ ██ ███ ███ ██████ ██████
9
- ██ ██ ██ ██ ██ ██ ████ ████ ██ ██ ██
10
- ██ ███████ ███████ █████ ██ ████ ██ ██ ██████
11
- ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
12
- ██ ██ ██ ███████ ██ ██ ██ ██ ██████ ██
13
- ```
3
+ Terminal dashboard for [@task-mcp/mcp-server](https://www.npmjs.com/package/@task-mcp/mcp-server). Visualize task status, schedule, and bottlenecks.
14
4
 
15
5
  ## Requirements
16
6
 
17
- - **Bun** runtime (not Node.js)
7
+ - **Bun** runtime
18
8
 
19
9
  ## Installation
20
10
 
21
11
  ```bash
22
- # Install globally
23
12
  bun add -g @task-mcp/cli
24
-
25
- # Or run directly
26
- bunx @task-mcp/cli
27
- ```
28
-
29
- ## Quick Start
30
-
31
- ```bash
32
- # Show dashboard (default)
33
- task
34
-
35
- # Enter interactive mode
36
- task -i
37
- task interactive
38
-
39
- # Quick capture idea to inbox
40
- task inbox "Review API design tomorrow"
41
-
42
- # List pending tasks
43
- task list --status pending
44
- ```
45
-
46
- ## Commands
47
-
48
- ### Dashboard
49
-
50
- ```bash
51
- task # Show dashboard for current workspace
52
- task dashboard # Same as above
53
- task d # Alias
54
- task dashboard my-project # Show specific workspace
55
- ```
56
-
57
- ### Interactive Mode
58
-
59
- ```bash
60
- task -i # Start interactive mode
61
- task --interactive # Same as above
62
- task interactive # Full command
63
- task i # Alias
64
- ```
65
-
66
- Interactive mode provides a menu-driven interface:
67
- - **d** - Dashboard view
68
- - **p** - Projects management
69
- - **t** - Tasks with filters
70
- - **x** - Exit
71
-
72
- ### Task List
73
-
74
- ```bash
75
- task list # List active tasks
76
- task ls # Alias
77
- task list --all # Include completed/cancelled
78
- task list --status pending,in_progress
79
- task list --priority critical,high
80
- ```
81
-
82
- ### Workspaces
83
-
84
- ```bash
85
- task workspaces # List all workspaces
86
- task ws # Alias
87
- task workspaces --all # Include all workspaces
88
13
  ```
89
14
 
90
- ### Inbox
91
-
92
- Quick capture ideas and promote them to tasks later.
15
+ ## Usage
93
16
 
94
17
  ```bash
95
- # Quick capture
96
- task inbox "Fix login bug tomorrow"
97
- task inbox "Review PR #123 #dev !high"
98
-
99
- # Subcommands
100
- task inbox # List pending items
101
- task inbox list # Same as above
102
- task inbox list --all # Include promoted/discarded
103
- task inbox get <id> # Show item details
104
- task inbox promote <id> # Promote to task
105
- task inbox discard <id> # Discard item
106
- task inbox delete <id> # Permanently delete
107
- task inbox count # Show pending count
108
- ```
109
-
110
- **Natural language parsing:**
111
- - `#tag` - Add tags
112
- - `!priority` - Set priority (critical, high, medium, low)
113
- - `@context` - Add context (focus, office, home)
114
- - Date words: tomorrow, next week, monday, etc.
115
-
116
- ## Dashboard Widgets
117
-
118
- The dashboard displays 7 widgets:
119
-
120
- | Widget | Description |
121
- |--------|-------------|
122
- | **Overview** | Progress bar, status counts, priority breakdown |
123
- | **Schedule** | Overdue, today, this week task counts |
124
- | **Inbox** | Pending quick capture items |
125
- | **Work Queue** | Ready tasks, blocked tasks, bottlenecks, next task suggestion |
126
- | **Critical Path** | CPM analysis, path length, estimated duration |
127
- | **Analysis** | Complexity scores, tech stack distribution, risk levels |
128
- | **Hierarchy** | Task tree structure with subtasks |
129
-
130
- ## Options
131
-
132
- | Option | Description |
133
- |--------|-------------|
134
- | `-i, --interactive` | Start interactive mode |
135
- | `--status <status>` | Filter by status (comma-separated) |
136
- | `--priority <priority>` | Filter by priority (comma-separated) |
137
- | `--all` | Include completed/cancelled/archived |
138
- | `--project <id>` | Specify project for inbox promote |
139
-
140
- ### Status Values
141
- `pending`, `in_progress`, `blocked`, `completed`, `cancelled`
142
-
143
- ### Priority Values
144
- `critical`, `high`, `medium`, `low`
145
-
146
- ## Data Location
147
-
148
- The CLI reads data from the `.tasks/` directory created by the task-mcp MCP server:
149
-
150
- ```
151
- .tasks/
152
- ├── inbox.json # Quick capture items (global)
153
- └── {workspace}/ # Auto-detected from git repo name
154
- ├── tasks.json # V2 format with tags
155
- └── history.jsonl # Action history
156
- ```
157
-
158
- ## Configuration
159
-
160
- ### Environment Variables
161
-
162
- | Variable | Description | Default |
163
- |----------|-------------|---------|
164
- | `TASKS_DIR` | Custom path for task storage | `~/.tasks` |
165
-
166
- ### Storage Priority
167
-
168
- 1. `TASKS_DIR` environment variable (if set)
169
- 2. Default: `~/.tasks` (global)
170
-
171
- ### Examples
172
-
173
- ```bash
174
- # Use global storage (default)
175
- task
176
-
177
- # Use custom directory
178
- TASKS_DIR=/path/to/tasks task
179
- ```
180
-
181
- ## Examples
182
-
183
- ```bash
184
- # View all high-priority blocked tasks
185
- task list --status blocked --priority high
186
-
187
- # Start interactive mode for workspace exploration
188
- task -i
189
-
190
- # Capture idea and check inbox
191
- task inbox "Refactor auth module !critical #backend"
192
- task inbox list
193
-
194
- # Promote inbox item to task
195
- task inbox promote inb_abc123
196
-
197
- # Show dashboard for specific workspace
198
- task d my-project
18
+ task # Show dashboard
19
+ task -i # Interactive mode
20
+ task list # List tasks
21
+ task inbox "idea" # Quick capture
199
22
  ```
200
23
 
201
24
  ## License
package/dist/index.js CHANGED
@@ -588,7 +588,7 @@ async function inboxCountCmd() {
588
588
  // package.json
589
589
  var package_default = {
590
590
  name: "@task-mcp/cli",
591
- version: "1.0.27",
591
+ version: "1.0.28",
592
592
  description: "Zero-dependency CLI for task-mcp with Bun native visualization",
593
593
  type: "module",
594
594
  bin: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@task-mcp/cli",
3
- "version": "1.0.27",
3
+ "version": "1.0.28",
4
4
  "description": "Zero-dependency CLI for task-mcp with Bun native visualization",
5
5
  "type": "module",
6
6
  "bin": {