@krodak/clickup-cli 1.1.0 → 1.3.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -210,7 +210,7 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | Feature                 | Command              | Status             |
 | ----------------------- | -------------------- | ------------------ |
 | Add/remove tag on task  | `cup tag <id>`       | :white_check_mark: |
-| List space tags         | `cup tags <spaceId>` | :construction:     |
+| List space tags         | `cup tags <spaceId>` | :white_check_mark: |
 | Create/delete space tag |                      | :construction:     |
 
 ### Time Tracking
@@ -222,8 +222,8 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | Timer status   | `cup time status`              | :white_check_mark: |
 | Log time entry | `cup time log <id> <duration>` | :white_check_mark: |
 | List entries   | `cup time list`                | :white_check_mark: |
-| Update entry   | `cup time update <id>`         | :construction:     |
-| Delete entry   | `cup time delete <id>`         | :construction:     |
+| Update entry   | `cup time update <id>`         | :white_check_mark: |
+| Delete entry   | `cup time delete <id>`         | :white_check_mark: |
 
 ### Workspace
 
@@ -232,7 +232,7 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | List spaces  | `cup spaces`            | :white_check_mark: |
 | List lists   | `cup lists <spaceId>`   | :white_check_mark: |
 | Check auth   | `cup auth`              | :white_check_mark: |
-| List folders | `cup folders <spaceId>` | :construction:     |
+| List folders | `cup folders <spaceId>` | :white_check_mark: |
 | List members | `cup members`           | :construction:     |
 
 ### Goals & Key Results
@@ -245,13 +245,14 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 ### Docs
 
-| Feature           | Command                              | Status             |
-| ----------------- | ------------------------------------ | ------------------ |
-| Search docs       | `cup docs [query]`                   | :white_check_mark: |
-| View page content | `cup doc <docId> <pageId>`           | :white_check_mark: |
-| Create doc        | `cup doc-create <title>`             | :white_check_mark: |
-| Create page       | `cup doc-page-create <docId> <name>` | :white_check_mark: |
-| Edit page         | `cup doc-page-edit <docId> <pageId>` | :white_check_mark: |
+| Feature          | Command                              | Status             |
+| ---------------- | ------------------------------------ | ------------------ |
+| Search docs      | `cup docs [query]`                   | :white_check_mark: |
+| View doc / page  | `cup doc <docId> [pageId]`           | :white_check_mark: |
+| All page content | `cup doc-pages <docId>`              | :white_check_mark: |
+| Create doc       | `cup doc-create <title>`             | :white_check_mark: |
+| Create page      | `cup doc-page-create <docId> <name>` | :white_check_mark: |
+| Edit page        | `cup doc-page-edit <docId> <pageId>` | :white_check_mark: |
 
 ### Attachments
 

package/dist/index.js

@@ -371,6 +371,17 @@ var ClickUpClient = class {
     }
     return entries;
   }
+  async updateTimeEntry(teamId, timeEntryId, updates) {
+    const data = await this.request(
+      `/team/${teamId}/time_entries/${timeEntryId}`,
+      { method: "PUT", body: JSON.stringify(updates) }
+    );
+    return data.data;
+  }
+  async getSpaceTags(spaceId) {
+    const data = await this.request(`/space/${spaceId}/tag`);
+    return data.tags ?? [];
+  }
   async deleteTimeEntry(teamId, timeEntryId) {
     await this.request(`/team/${teamId}/time_entries/${timeEntryId}`, {
       method: "DELETE"
@@ -443,6 +454,21 @@ var ClickUpClient = class {
       body: JSON.stringify(updates)
     });
   }
+  async getDoc(workspaceId, docId) {
+    return this.requestV3(`/workspaces/${workspaceId}/docs/${docId}`);
+  }
+  async getDocPageListing(workspaceId, docId) {
+    const data = await this.requestV3(
+      `/workspaces/${workspaceId}/docs/${docId}/pagelisting`
+    );
+    return data.pages ?? [];
+  }
+  async getDocPages(workspaceId, docId) {
+    const data = await this.requestV3(
+      `/workspaces/${workspaceId}/docs/${docId}/pages?content_format=text/md`
+    );
+    return data.pages ?? [];
+  }
 };
 
 // src/config.ts
@@ -2091,7 +2117,7 @@ function bashCompletion(name) {
     cword=$COMP_CWORD
   fi
 
-  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comment-delete comments replies reply activity lists spaces inbox assigned open search summary overdue assign depend link attach move field delete tag checklist time docs doc doc-create doc-page-create doc-page-edit config completion"
+  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comment-delete comments replies reply activity lists spaces inbox assigned open search summary overdue assign depend link attach move field delete tag tags checklist time docs doc doc-create doc-pages doc-page-create doc-page-edit folders config completion"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -2221,6 +2247,15 @@ function bashCompletion(name) {
     doc)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
+    doc-pages)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    tags)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    folders)
+      COMPREPLY=($(compgen -W "--name --json" -- "$cur"))
+      ;;
     doc-create)
       COMPREPLY=($(compgen -W "-c --content --json" -- "$cur"))
       ;;
@@ -2291,10 +2326,13 @@ _${name}() {
     'link:Add or remove a link between two tasks'
     'attach:Upload a file attachment to a task'
     'docs:List workspace docs'
-    'doc:View a doc page'
+    'doc:View a doc or doc page'
     'doc-create:Create a new doc'
+    'doc-pages:List all pages in a doc with content'
     'doc-page-create:Create a page in a doc'
     'doc-page-edit:Edit a doc page'
+    'tags:List tags in a space'
+    'folders:List folders in a space'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
   )
@@ -2628,6 +2666,22 @@ _${name}() {
             '2:page_id:' \\
             '--json[Force JSON output]'
           ;;
+        doc-pages)
+          _arguments \\
+            '1:doc_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        tags)
+          _arguments \\
+            '1:space_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        folders)
+          _arguments \\
+            '1:space_id:' \\
+            '--name[Filter by folder name]:text:' \\
+            '--json[Force JSON output]'
+          ;;
         doc-create)
           _arguments \\
             '1:title:' \\
@@ -2725,10 +2779,13 @@ complete -c ${name} -n __fish_use_subcommand -a reply -d 'Reply to a comment'
 complete -c ${name} -n __fish_use_subcommand -a link -d 'Add or remove a link between two tasks'
 complete -c ${name} -n __fish_use_subcommand -a attach -d 'Upload a file attachment to a task'
 complete -c ${name} -n __fish_use_subcommand -a docs -d 'List workspace docs'
-complete -c ${name} -n __fish_use_subcommand -a doc -d 'View a doc page'
+complete -c ${name} -n __fish_use_subcommand -a doc -d 'View a doc or doc page'
 complete -c ${name} -n __fish_use_subcommand -a doc-create -d 'Create a new doc'
+complete -c ${name} -n __fish_use_subcommand -a doc-pages -d 'List all pages in a doc with content'
 complete -c ${name} -n __fish_use_subcommand -a doc-page-create -d 'Create a page in a doc'
 complete -c ${name} -n __fish_use_subcommand -a doc-page-edit -d 'Edit a doc page'
+complete -c ${name} -n __fish_use_subcommand -a tags -d 'List tags in a space'
+complete -c ${name} -n __fish_use_subcommand -a folders -d 'List folders in a space'
 complete -c ${name} -n __fish_use_subcommand -a config -d 'Manage CLI configuration'
 complete -c ${name} -n __fish_use_subcommand -a completion -d 'Output shell completion script'
 
@@ -2886,6 +2943,13 @@ complete -c ${name} -n '__fish_seen_subcommand_from docs' -l json -d 'Force JSON
 
 complete -c ${name} -n '__fish_seen_subcommand_from doc' -l json -d 'Force JSON output'
 
+complete -c ${name} -n '__fish_seen_subcommand_from doc-pages' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from tags' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from folders' -l name -d 'Filter by folder name'
+complete -c ${name} -n '__fish_seen_subcommand_from folders' -l json -d 'Force JSON output'
+
 complete -c ${name} -n '__fish_seen_subcommand_from doc-create' -s c -l content -d 'Initial content'
 complete -c ${name} -n '__fish_seen_subcommand_from doc-create' -l json -d 'Force JSON output'
 
@@ -3296,10 +3360,76 @@ function formatDocsMarkdown(docs) {
 }
 
 // src/commands/doc.ts
+import chalk8 from "chalk";
+async function getDocInfo(config, docId) {
+  const client = new ClickUpClient(config);
+  const [doc, pages] = await Promise.all([
+    client.getDoc(config.teamId, docId),
+    client.getDocPageListing(config.teamId, docId)
+  ]);
+  return { doc, pages };
+}
+function formatDocInfo(doc, pages, indent = 0) {
+  const lines = [];
+  if (indent === 0) {
+    lines.push(`${chalk8.bold(doc.name)} ${chalk8.dim(doc.id)}`);
+    if (pages.length === 0) {
+      lines.push("  (no pages)");
+    }
+  }
+  for (const page of pages) {
+    const prefix = "  ".repeat(indent + 1);
+    lines.push(`${prefix}${page.name} ${chalk8.dim(page.id)}`);
+    if (page.pages && page.pages.length > 0) {
+      lines.push(formatDocInfo(doc, page.pages, indent + 1));
+    }
+  }
+  return lines.join("\n");
+}
+function formatDocInfoMarkdown(doc, pages, indent = 0) {
+  const lines = [];
+  if (indent === 0) {
+    lines.push(`# ${doc.name}`);
+    lines.push(`ID: ${doc.id}`);
+    lines.push("");
+    if (pages.length === 0) {
+      lines.push("No pages.");
+      return lines.join("\n");
+    }
+    lines.push("## Pages");
+  }
+  for (const page of pages) {
+    const prefix = "  ".repeat(indent);
+    lines.push(`${prefix}- **${page.name}** (${page.id})`);
+    if (page.pages && page.pages.length > 0) {
+      lines.push(formatDocInfoMarkdown(doc, page.pages, indent + 1));
+    }
+  }
+  return lines.join("\n");
+}
 async function getDocPage(config, docId, pageId) {
   const client = new ClickUpClient(config);
   return client.getDocPage(config.teamId, docId, pageId);
 }
+async function getAllDocPages(config, docId) {
+  const client = new ClickUpClient(config);
+  return client.getDocPages(config.teamId, docId);
+}
+function formatDocPages(pages) {
+  if (pages.length === 0) return "No pages found";
+  return pages.map((p) => {
+    const header = `# ${p.name}
+`;
+    return header + (p.content ?? "");
+  }).join("\n\n---\n\n");
+}
+function formatDocPagesMarkdown(pages) {
+  if (pages.length === 0) return "No pages found";
+  return pages.map((p) => {
+    const header = `# ${p.name}`;
+    return header + "\n\n" + (p.content ?? "");
+  }).join("\n\n---\n\n");
+}
 async function createDoc(config, title, content) {
   if (!title.trim()) throw new Error("Doc title cannot be empty");
   const client = new ClickUpClient(config);
@@ -3319,8 +3449,44 @@ async function editDocPage(config, docId, pageId, updates) {
   return client.editDocPage(config.teamId, docId, pageId, updates);
 }
 
+// src/commands/folders.ts
+import chalk9 from "chalk";
+async function listFolders(config, spaceId, nameFilter) {
+  const client = new ClickUpClient(config);
+  const folders = await client.getFolders(spaceId);
+  let filtered = folders;
+  if (nameFilter) {
+    const lower = nameFilter.toLowerCase();
+    filtered = folders.filter((f) => f.name.toLowerCase().includes(lower));
+  }
+  const results = [];
+  for (const folder of filtered) {
+    const lists = await client.getFolderLists(folder.id);
+    results.push({ id: folder.id, name: folder.name, lists });
+  }
+  return results;
+}
+function formatFolders(folders) {
+  if (folders.length === 0) return "No folders found";
+  return folders.map((f) => {
+    const header = `${chalk9.bold(f.name)} ${chalk9.dim(f.id)}`;
+    if (f.lists.length === 0) return header;
+    const listLines = f.lists.map((l) => `  ${l.name} ${chalk9.dim(l.id)}`);
+    return [header, ...listLines].join("\n");
+  }).join("\n\n");
+}
+function formatFoldersMarkdown(folders) {
+  if (folders.length === 0) return "No folders found";
+  return folders.map((f) => {
+    const header = `- **${f.name}** (${f.id})`;
+    if (f.lists.length === 0) return header;
+    const listLines = f.lists.map((l) => `  - ${l.name} (${l.id})`);
+    return [header, ...listLines].join("\n");
+  }).join("\n");
+}
+
 // src/commands/time.ts
-import chalk8 from "chalk";
+import chalk10 from "chalk";
 async function startTimer(config, taskId, description) {
   const client = new ClickUpClient(config);
   return client.startTimeEntry(config.teamId, taskId, description);
@@ -3349,6 +3515,20 @@ async function listTimeEntries(config, opts) {
     taskId: opts?.taskId
   });
 }
+async function updateTimeEntry(config, timeEntryId, opts) {
+  if (!opts.description && !opts.duration) {
+    throw new Error("Provide --description or --duration to update");
+  }
+  const client = new ClickUpClient(config);
+  const updates = {};
+  if (opts.description) updates.description = opts.description;
+  if (opts.duration) updates.duration = parseTimeEstimate(opts.duration);
+  return client.updateTimeEntry(config.teamId, timeEntryId, updates);
+}
+async function deleteTimeEntry(config, timeEntryId) {
+  const client = new ClickUpClient(config);
+  await client.deleteTimeEntry(config.teamId, timeEntryId);
+}
 function formatTimeEntry(entry) {
   const lines = [];
   const taskName = entry.task?.name ?? "No task";
@@ -3356,8 +3536,8 @@ function formatTimeEntry(entry) {
   const isRunning = entry.duration < 0;
   const elapsed = isRunning ? Date.now() - Number(entry.start) : entry.duration;
   const durationStr = formatDuration(elapsed);
-  const status = isRunning ? chalk8.green("RUNNING") : "";
-  lines.push(`${chalk8.bold(taskName)} ${chalk8.dim(taskId)} ${status}`);
+  const status = isRunning ? chalk10.green("RUNNING") : "";
+  lines.push(`${chalk10.bold(taskName)} ${chalk10.dim(taskId)} ${status}`);
   lines.push(
     `  ${durationStr} - ${formatTimestamp(entry.start)}${entry.description ? ` - ${entry.description}` : ""}`
   );
@@ -3381,6 +3561,21 @@ function formatTimeEntriesMarkdown(entries) {
   return entries.map(formatTimeEntryMarkdown).join("\n");
 }
 
+// src/commands/tags.ts
+import chalk11 from "chalk";
+async function listSpaceTags(config, spaceId) {
+  const client = new ClickUpClient(config);
+  return client.getSpaceTags(spaceId);
+}
+function formatTags(tags) {
+  if (tags.length === 0) return "No tags found";
+  return tags.map((t) => chalk11.bold(t.name)).join(", ");
+}
+function formatTagsMarkdown(tags) {
+  if (tags.length === 0) return "No tags found";
+  return tags.map((t) => `- ${t.name}`).join("\n");
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -3923,6 +4118,48 @@ timeCmd.command("list").description("List recent time entries (default: last 7 d
     }
   })
 );
+timeCmd.command("update <timeEntryId>").description("Update a time entry").option("-d, --description <text>", "New description").option("--duration <duration>", 'New duration (e.g. "2h", "30m")').option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (timeEntryId, opts) => {
+      const config = loadConfig();
+      const entry = await updateTimeEntry(config, timeEntryId, {
+        description: opts.description,
+        duration: opts.duration
+      });
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(entry, null, 2));
+      } else if (isTTY()) {
+        console.log(formatTimeEntry(entry));
+      } else {
+        console.log(formatTimeEntryMarkdown(entry));
+      }
+    }
+  )
+);
+timeCmd.command("delete <timeEntryId>").description("Delete a time entry").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (timeEntryId, opts) => {
+    const config = loadConfig();
+    await deleteTimeEntry(config, timeEntryId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ deleted: timeEntryId }));
+    } else {
+      console.log(`Deleted time entry ${timeEntryId}`);
+    }
+  })
+);
+program.command("tags <spaceId>").description("List tags in a space").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (spaceId, opts) => {
+    const config = loadConfig();
+    const tags = await listSpaceTags(config, spaceId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(tags, null, 2));
+    } else if (isTTY()) {
+      console.log(formatTags(tags));
+    } else {
+      console.log(formatTagsMarkdown(tags));
+    }
+  })
+);
 program.command("docs [query]").description("List workspace docs (optionally filter by name)").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (query, opts) => {
     const config = loadConfig();
@@ -3936,16 +4173,53 @@ program.command("docs [query]").description("List workspace docs (optionally fil
     }
   })
 );
-program.command("doc <docId> <pageId>").description("View a doc page").option("--json", "Force JSON output even in terminal").action(
+program.command("doc <docId> [pageId]").description("View a doc (metadata + page tree) or a specific page").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (docId, pageId, opts) => {
     const config = loadConfig();
-    const page = await getDocPage(config, docId, pageId);
+    if (pageId) {
+      const page = await getDocPage(config, docId, pageId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(page, null, 2));
+      } else {
+        if (page.name) console.log(`# ${page.name}
+`);
+        console.log(page.content ?? "");
+      }
+    } else {
+      const { doc, pages } = await getDocInfo(config, docId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify({ ...doc, pages }, null, 2));
+      } else if (isTTY()) {
+        console.log(formatDocInfo(doc, pages));
+      } else {
+        console.log(formatDocInfoMarkdown(doc, pages));
+      }
+    }
+  })
+);
+program.command("doc-pages <docId>").description("List all pages in a doc with content").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (docId, opts) => {
+    const config = loadConfig();
+    const pages = await getAllDocPages(config, docId);
     if (shouldOutputJson(opts.json ?? false)) {
-      console.log(JSON.stringify(page, null, 2));
+      console.log(JSON.stringify(pages, null, 2));
+    } else if (isTTY()) {
+      console.log(formatDocPages(pages));
     } else {
-      if (page.name) console.log(`# ${page.name}
-`);
-      console.log(page.content ?? "");
+      console.log(formatDocPagesMarkdown(pages));
+    }
+  })
+);
+program.command("folders <spaceId>").description("List folders in a space (with their lists)").option("--name <partial>", "Filter folders by partial name match").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (spaceId, opts) => {
+    const config = loadConfig();
+    const folders = await listFolders(config, spaceId, opts.name);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(folders, null, 2));
+    } else if (isTTY()) {
+      console.log(formatFolders(folders));
+    } else {
+      console.log(formatFoldersMarkdown(folders));
     }
   })
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -52,8 +52,11 @@ All commands support `--help` for full flag details.
 | `cup lists <spaceId> [--name partial] [--json]`                                                     | Lists in a space (including folder lists)          |
 | `cup open <query> [--json]`                                                                         | Open task in browser by ID or name                 |
 | `cup auth [--json]`                                                                                 | Check authentication status                        |
+| `cup folders <spaceId> [--name partial] [--json]`                                                   | Folders in a space (with their lists)              |
+| `cup tags <spaceId> [--json]`                                                                       | List tags available in a space                     |
 | `cup docs [query] [--json]`                                                                         | List workspace docs (optionally filter by name)    |
-| `cup doc <docId> <pageId> [--json]`                                                                 | View a doc page (markdown content)                 |
+| `cup doc <docId> [pageId] [--json]`                                                                 | View doc metadata + page tree, or a specific page  |
+| `cup doc-pages <docId> [--json]`                                                                    | All pages in a doc with content                    |
 
 ### Write
 
@@ -85,6 +88,8 @@ All commands support `--help` for full flag details.
 | `cup time status [--json]`                                                                                                                                                          | Show currently running timer                               |
 | `cup time log <taskId> <duration> [-d desc] [--json]`                                                                                                                               | Log manual time entry (e.g. "2h", "30m")                   |
 | `cup time list [--days n] [--task id] [--json]`                                                                                                                                     | List recent time entries                                   |
+| `cup time update <timeEntryId> [-d desc] [--duration dur] [--json]`                                                                                                                 | Update a time entry                                        |
+| `cup time delete <timeEntryId> [--json]`                                                                                                                                            | Delete a time entry                                        |
 | `cup doc-create <title> [-c content] [--json]`                                                                                                                                      | Create a new doc                                           |
 | `cup doc-page-create <docId> <name> [-c content] [--parent-page pageId] [--json]`                                                                                                   | Create a page in a doc                                     |
 | `cup doc-page-edit <docId> <pageId> [--name text] [-c content] [--json]`                                                                                                            | Edit a doc page                                            |
@@ -121,7 +126,10 @@ All commands support `--help` for full flag details.
 | `cup overdue`               | Excludes closed tasks, sorted most overdue first                                                                                                                                                                                                          |
 | `cup open`                  | Tries task ID first, falls back to name search                                                                                                                                                                                                            |
 | `cup checklist`             | Full CRUD for task checklists: view, create, delete, add-item, edit-item, delete-item                                                                                                                                                                     |
-| `cup time`                  | Track time: start/stop timer, log entries, list history. Duration format: "2h", "30m", "1h30m"                                                                                                                                                            |
+| `cup tags`                  | List available tags in a space. Useful for discovering valid tag names before using `cup tag`                                                                                                                                                             |
+| `cup time`                  | Track time: start/stop timer, log entries, list history, update/delete entries. Duration format: "2h", "30m", "1h30m"                                                                                                                                     |
+| `cup time update`           | Update a time entry description or duration                                                                                                                                                                                                               |
+| `cup time delete`           | Delete a time entry                                                                                                                                                                                                                                       |
 | `cup comment-edit`          | Edit comment text and resolution status                                                                                                                                                                                                                   |
 | `cup comment-delete`        | Delete a comment                                                                                                                                                                                                                                          |
 | `cup replies` / `cup reply` | View and post threaded comment replies                                                                                                                                                                                                                    |
@@ -129,8 +137,10 @@ All commands support `--help` for full flag details.
 | `cup link` + custom IDs     | Both IDs must be the same type (both custom or both native). Mixing may not work                                                                                                                                                                          |
 | `cup link`                  | Link/unlink tasks (different from dependencies)                                                                                                                                                                                                           |
 | `cup attach`                | Upload files to tasks. Attachments shown in `cup task` detail view                                                                                                                                                                                        |
+| `cup folders`               | List folders in a space with their contained lists                                                                                                                                                                                                        |
 | `cup docs`                  | List and search workspace docs by name                                                                                                                                                                                                                    |
-| `cup doc`                   | View a doc page content (markdown)                                                                                                                                                                                                                        |
+| `cup doc`                   | View doc metadata + page tree (no pageId), or a specific page (with pageId)                                                                                                                                                                               |
+| `cup doc-pages`             | Dump all pages in a doc with full content                                                                                                                                                                                                                 |
 | `cup doc-create`            | Create a new doc with optional initial content                                                                                                                                                                                                            |
 | `cup doc-page-create`       | Create a page in a doc, optionally nested under a parent page                                                                                                                                                                                             |
 | `cup doc-page-edit`         | Edit a doc page name or content                                                                                                                                                                                                                           |
@@ -210,7 +220,9 @@ cup delete abc123def --confirm          # irreversible!
 ```bash
 cup docs                                       # list all docs
 cup docs "design"                              # search docs by name
+cup doc <docId>                                # doc metadata + page tree
 cup doc <docId> <pageId>                       # view page content
+cup doc-pages <docId>                          # all pages with content
 cup doc-create "Architecture Notes"            # create a doc
 cup doc-create "Notes" -c "# Draft"            # create with content
 cup doc-page-create <docId> "New Section"      # add page to doc
@@ -224,6 +236,8 @@ cup doc-page-edit <docId> <pageId> -c "# Updated content" # edit content
 ```bash
 cup spaces                           # all spaces
 cup spaces --name "Engineering"      # find space ID by name
+cup folders <spaceId>                # folders with their lists
+cup folders <spaceId> --name "sprint"  # filter folders by name
 cup lists <spaceId>                  # lists in a space (needs ID from cup spaces)
 cup sprints                          # all sprints across folders
 cup auth                             # verify token works