@task-mcp/cli 1.0.19 → 1.0.21

package/README.md

@@ -1,6 +1,8 @@
 # @task-mcp/cli
 
-Zero-dependency CLI for task-mcp with beautiful terminal visualization.
+Terminal dashboard for [@task-mcp/mcp-server](https://www.npmjs.com/package/@task-mcp/mcp-server).
+
+> **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.
 
 ```
 ████████  █████  ███████ ██   ██     ███    ███  ██████ ██████
@@ -46,10 +48,10 @@ task list --status pending
 ### Dashboard
 
 ```bash
-task                      # Show dashboard for all projects
+task                      # Show dashboard for current workspace
 task dashboard            # Same as above
 task d                    # Alias
-task dashboard proj_123   # Show specific project
+task dashboard my-project # Show specific workspace
 ```
 
 ### Interactive Mode
@@ -77,12 +79,12 @@ task list --status pending,in_progress
 task list --priority critical,high
 ```
 
-### Projects
+### Workspaces
 
 ```bash
-task projects             # List active projects
-task p                    # Alias
-task projects --all       # Include archived
+task workspaces           # List all workspaces
+task ws                   # Alias
+task workspaces --all     # Include all workspaces
 ```
 
 ### Inbox
@@ -147,10 +149,38 @@ The CLI reads data from the `.tasks/` directory created by the task-mcp MCP serv
 
 ```
 .tasks/
-├── projects.json           # Project metadata
-├── inbox.json              # Quick capture items
-└── <project-id>/
-    └── tasks.json          # Tasks for each project
+├── inbox.json              # Quick capture items (global)
+└── {workspace}/            # Auto-detected from git repo name
+    ├── tasks.json          # V2 format with tags
+    └── history.jsonl       # Action history
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TASKS_DIR` | Custom path for task storage | `~/.tasks` |
+| `TASKS_LOCAL` | Set to "true" for project-local storage | - |
+
+### Storage Priority
+
+1. `TASKS_DIR` environment variable (if set)
+2. `TASKS_LOCAL=true` → `./tasks` (project-local)
+3. Default: `~/.tasks` (global)
+
+### Examples
+
+```bash
+# Use global storage (default)
+task
+
+# Use project-local storage
+TASKS_LOCAL=true task
+
+# Use custom directory
+TASKS_DIR=/path/to/tasks task
 ```
 
 ## Examples
@@ -159,7 +189,7 @@ The CLI reads data from the `.tasks/` directory created by the task-mcp MCP serv
 # View all high-priority blocked tasks
 task list --status blocked --priority high
 
-# Start interactive mode for project exploration
+# Start interactive mode for workspace exploration
 task -i
 
 # Capture idea and check inbox
@@ -167,10 +197,10 @@ task inbox "Refactor auth module !critical #backend"
 task inbox list
 
 # Promote inbox item to task
-task inbox promote inb_abc123 --project proj_xyz
+task inbox promote inb_abc123
 
-# Show dashboard for specific project
-task d proj_main
+# Show dashboard for specific workspace
+task d my-project
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@task-mcp/cli",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "Zero-dependency CLI for task-mcp with Bun native visualization",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -80,12 +80,12 @@ ${c.yellow("USAGE")}
   ${c.bold("task")} [command] [options]
 
 ${c.yellow("COMMANDS")}
-  ${c.cyan("dashboard")} [project-id]   Show project dashboard (default)
-  ${c.cyan("d")} [project-id]           Alias for dashboard
+  ${c.cyan("dashboard")} [workspace]    Show workspace dashboard (default)
+  ${c.cyan("d")} [workspace]            Alias for dashboard
   ${c.cyan("list")}                     List all tasks
   ${c.cyan("ls")}                       Alias for list
-  ${c.cyan("projects")}                 List all projects
-  ${c.cyan("p")}                        Alias for projects
+  ${c.cyan("workspaces")}               List all workspaces
+  ${c.cyan("ws")}                       Alias for workspaces
   ${c.cyan("inbox")} <subcommand>       Manage inbox (add/list/get/promote/discard)
   ${c.cyan("interactive")}              Start interactive mode
   ${c.cyan("i")}                        Alias for interactive
@@ -117,8 +117,8 @@ ${c.yellow("EXAMPLES")}
   ${c.dim("# List pending high-priority tasks")}
   task list --status pending --priority high
 
-  ${c.dim("# List all projects including archived")}
-  task projects --all
+  ${c.dim("# List all workspaces")}
+  task workspaces --all
 `);
 }