@task-mcp/cli 1.0.26 → 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.
- package/README.md +7 -184
- package/dist/index.js +3 -3
- package/package.json +3 -3
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
|
|
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
|
-
|
|
91
|
-
|
|
92
|
-
Quick capture ideas and promote them to tasks later.
|
|
15
|
+
## Usage
|
|
93
16
|
|
|
94
17
|
```bash
|
|
95
|
-
#
|
|
96
|
-
task
|
|
97
|
-
task
|
|
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.
|
|
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: {
|
|
@@ -620,8 +620,8 @@ var package_default = {
|
|
|
620
620
|
directory: "packages/cli"
|
|
621
621
|
},
|
|
622
622
|
dependencies: {
|
|
623
|
-
"@task-mcp/mcp-server": "^1.0.
|
|
624
|
-
"@task-mcp/shared": "^1.0.
|
|
623
|
+
"@task-mcp/mcp-server": "^1.0.29",
|
|
624
|
+
"@task-mcp/shared": "^1.0.25"
|
|
625
625
|
},
|
|
626
626
|
devDependencies: {
|
|
627
627
|
"@types/bun": "^1.1.14",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@task-mcp/cli",
|
|
3
|
-
"version": "1.0.
|
|
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": {
|
|
@@ -32,8 +32,8 @@
|
|
|
32
32
|
"directory": "packages/cli"
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
-
"@task-mcp/mcp-server": "^1.0.
|
|
36
|
-
"@task-mcp/shared": "^1.0.
|
|
35
|
+
"@task-mcp/mcp-server": "^1.0.29",
|
|
36
|
+
"@task-mcp/shared": "^1.0.25"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
39
|
"@types/bun": "^1.1.14",
|