clickup-agent-cli 0.3.0 → 0.4.1

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "clickup",
       "source": "./",
       "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-      "version": "0.3.0",
+      "version": "0.4.1",
       "homepage": "https://github.com/henryreith/clickup-cli",
       "keywords": ["clickup", "project-management", "tasks", "time-tracking"],
       "category": "productivity"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup",
   "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "author": {
     "name": "Henry Reith"
   },

package/README.md

@@ -80,7 +80,7 @@ Every command supports multiple output formats:
 
 ## AI Agent Usage
 
-The CLI is built from the ground up for AI agents, following the "CLI as execution layer, skills as guidance layer" pattern. It ships as a Claude Code plugin with 23 agent skills, and works with any agent platform that can run bash commands.
+The CLI is built from the ground up for AI agents, following the "CLI as execution layer, skills as guidance layer" pattern. It ships as a Claude Code plugin with 25 agent skills, and works with any agent platform that can run bash commands.
 
 **vs ClickUp MCP:** This CLI covers the same operations as the official ClickUp MCP server (tasks, docs, time tracking, chat, members, hierarchy) plus more, while consuming far fewer tokens. A full skills hierarchy loads in ~150 tokens at session start vs injecting an entire API schema. Works in any agent platform that supports bash -- not just MCP-compatible hosts.
 
@@ -93,14 +93,14 @@ Install the ClickUp CLI as a Claude Code plugin for zero-friction access to all
 /plugin marketplace add henryreith/clickup-cli
 
 # Install the plugin
-/plugin install clickup@clickup-cli
+/plugin install clickup@clickup-agent-cli
 
 # Use skills directly
 /clickup:weekly-review 12345678
 /clickup:sprint-planning list-id-here
 ```
 
-Once installed, Claude Code auto-discovers all 23 skills and loads them on demand. Recipe skills like `/clickup:weekly-review` run in isolated subagents with full ClickUp CLI access.
+Once installed, Claude Code auto-discovers all 25 skills and loads them on demand. Recipe skills like `/clickup:weekly-review` run in isolated subagents with full ClickUp CLI access.
 
 ### Claude Agent SDK
 
@@ -112,7 +112,7 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 for await (const message of query({
   prompt: "Create a task for the login bug fix and assign to the backend team",
   options: {
-    plugins: [{ type: "local", path: "./node_modules/clickup-cli" }],
+    plugins: [{ type: "local", path: "./node_modules/clickup-agent-cli" }],
     allowedTools: ["Skill", "Bash"],
     settingSources: ["project"]
   }
@@ -133,7 +133,7 @@ clickup skill show clickup
 clickup skill show clickup-tasks
 
 # Or asks the CLI what fields are needed (~50 tokens in response)
-clickup schema tasks.create
+clickup schema task.create
 
 # For complex workflows, load a recipe skill
 clickup skill show clickup-weekly-review
@@ -141,8 +141,8 @@ clickup skill show clickup-weekly-review
 
 **Three skill tiers:**
 - **Root skill** - Index and router. What the CLI does, how to discover more.
-- **Sub-skills** (10) - Per-resource command reference. Tasks, spaces, comments, time tracking, chat, etc.
-- **Recipe skills** (12) - Multi-step workflow guides that accept natural language arguments. Scope any recipe to a specific team, department, or person.
+- **Sub-skills** (11) - Per-resource command reference. Tasks, spaces, comments, time tracking, chat, etc.
+- **Recipe skills** (13) - Multi-step workflow guides that accept natural language arguments. Scope any recipe to a specific team, department, or person.
 
 **Example recipe invocations:**
 ```bash
@@ -180,11 +180,34 @@ This creates `/marketing-weekly` alongside the built-in `/clickup:*` skills.
 | Platform | How to use |
 |----------|-----------|
 | Claude Code | Plugin via marketplace (see above) |
-| Claude Agent SDK | `plugins: [{ type: "local", path: "./node_modules/clickup-cli" }]` |
+| Claude Agent SDK | `plugins: [{ type: "local", path: "./node_modules/clickup-agent-cli" }]` |
 | Gemini CLI | `npm install -g clickup-agent-cli`, read skills via `clickup skill show` |
 | OpenAI Codex | `npm install -g clickup-agent-cli`, execute commands via bash |
 | Custom agents | `clickup skill list` for discovery, `clickup schema` for field info |
 
+### Bootstrap From Any Agent
+
+Any agent that can run shell commands can set up and use the CLI in five steps, no plugin system required:
+
+```bash
+# 1. Install
+npm install -g clickup-agent-cli
+
+# 2. Authenticate non-interactively (env var, or --token-file / --token per call)
+export CLICKUP_API_TOKEN=pk_your_token
+
+# 3. Verify auth and workspace
+clickup config validate
+
+# 4. Discover capabilities: the root skill indexes everything
+clickup skill show clickup          # start here (~150 tokens)
+clickup skill list                  # all 25 skills
+clickup skill show clickup-tasks    # per-resource command reference
+
+# 5. Discover exact fields before calling a command
+clickup schema task.create
+```
+
 ### Agent-Friendly Design
 
 - JSON is the default output when stdout is not a TTY
@@ -199,10 +222,10 @@ This creates `/marketing-weekly` alongside the built-in `/clickup:*` skills.
 
 ```bash
 # Discover what's available
-clickup schema tasks
+clickup schema task
 
 # Check what fields task create needs
-clickup schema tasks.create --format json
+clickup schema task.create --format json
 
 # Create a task (JSON output automatic in non-TTY)
 clickup task create --list-id 998877 --name "Review PR" --priority 2