@krodak/clickup-cli 0.6.0 → 0.7.0

package/README.md

@@ -1,127 +1,97 @@
 # cu - ClickUp CLI
 
-A ClickUp CLI for AI agents and humans. Two operating modes: interactive tables with a task picker in terminals, raw JSON when piped.
+> A ClickUp CLI built for AI agents that also works well for humans. Outputs Markdown when piped (optimized for AI context windows), interactive tables when run in a terminal.
 
-## Requirements
-
-- Node 22+
-- A ClickUp personal API token (`pk_...` from https://app.clickup.com/settings/apps)
-
-## Install
-
-```bash
-npm install -g @krodak/clickup-cli
-```
-
-## Getting started
+[![npm](https://img.shields.io/npm/v/@krodak/clickup-cli)](https://www.npmjs.com/package/@krodak/clickup-cli)
+[![node](https://img.shields.io/node/v/@krodak/clickup-cli)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/@krodak/clickup-cli)](./LICENSE)
+[![CI](https://github.com/krodak/clickup-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/krodak/clickup-cli/actions/workflows/ci.yml)
 
 ```bash
-cu init
+npm install -g @krodak/clickup-cli   # or: brew tap krodak/tap && brew install clickup-cli
+cu init                               # walks you through API token + workspace setup
 ```
 
-Prompts for your API token, verifies it, auto-detects your workspace, and writes `~/.config/cu/config.json`.
-
-## Operating Modes
+You need a ClickUp personal API token (`pk_...` from https://app.clickup.com/settings/apps).
 
-### Interactive TTY mode (for humans)
+## Using with AI agents
 
-When run in a terminal (TTY detected), list commands (`cu tasks`, `cu initiatives`, `cu sprint`, `cu inbox`, `cu subtasks`, `cu overdue`) display:
+This is the primary use case. Install the tool, install the skill file, and your agent knows how to work with ClickUp.
 
-1. A formatted table with auto-sized columns showing task ID, name, status, type, list, and URL.
-2. An interactive checkbox picker (powered by @inquirer/prompts) - navigate with arrow keys, toggle selection with space, confirm with enter.
-3. For selected tasks, a rich detail view showing: name (bold/underlined), ID, status, type, list, assignees, priority, dates, estimate, tracked time, tags, parent, URL, and a description preview (first 3 lines).
-4. A prompt to open the selected tasks in the browser.
+### 1. Install the skill
 
-Pass `--json` to any list command to bypass interactive mode and get raw JSON output in a terminal.
+The repo includes a skill file at `skill/SKILL.md` that teaches agents all available commands and when to use them.
 
-### JSON piped mode (for AI agents and scripts)
-
-When output is piped (no TTY), all list commands output JSON arrays to stdout. No interactive UI is shown.
-
-- `cu task <id> --json` returns the full JSON response for a single task.
-- All list commands output JSON arrays.
-- Errors go to stderr with exit code 1.
-- Write commands (`update`, `create`, `comment`, `assign`) always output JSON regardless of mode.
-- Set `NO_COLOR` to disable color output.
-
-## For AI agents
-
-Always use the `--json` flag or pipe output to ensure you get JSON. Parse with `jq` or programmatically.
+**Claude Code:**
 
 ```bash
-# List my in-progress tasks
-cu tasks --status "in progress" --json | jq '.[] | {id, name}'
-
-# Get full task details as JSON
-cu task abc123 --json | jq '{id, name, status}'
+mkdir -p ~/.claude/skills/clickup
+cp skill/SKILL.md ~/.claude/skills/clickup/SKILL.md
+```
 
-# Check current sprint
-cu sprint --json | jq '.[] | select(.status != "done")'
+Then reference it in your `CLAUDE.md` or project instructions.
 
-# Create subtask under initiative
-INITIATIVE_ID=$(cu initiatives --json | jq -r '.[0].id')
-cu create -n "New subtask" -p "$INITIATIVE_ID"
+**OpenCode:**
 
-# Update status when done
-cu update abc123 -s "done"
+```bash
+mkdir -p ~/.config/opencode/skills/clickup
+cp skill/SKILL.md ~/.config/opencode/skills/clickup/SKILL.md
 ```
 
-Write commands (`update`, `create`, `comment`) always return JSON, no `--json` flag needed.
+**Codex / other agents:**
 
-## AI Agents Skill
+Copy the contents of `skill/SKILL.md` into your system prompt or project instructions. It's a standalone markdown document.
 
-A skill file is included at `skill/SKILL.md` that teaches AI agents how to use `cu`. Install it for your agent of choice:
+### 2. Talk to your agent
 
-### OpenCode
+Once the skill is installed, you just tell the agent what you need in plain language. It figures out which `cu` commands to run.
 
-```bash
-mkdir -p ~/.config/opencode/skills/clickup
-cp skill/SKILL.md ~/.config/opencode/skills/clickup/SKILL.md
 ```
+"Read the description of task <id>, do the work, then mark it in review and leave a comment with the commit hash."
 
-### Claude Code
+"Check all subtasks under initiative <id> and improve their descriptions based on what's in the codebase."
 
-```bash
-mkdir -p ~/.claude/skills/clickup
-cp skill/SKILL.md ~/.claude/skills/clickup/SKILL.md
-```
+"What's my standup summary? What did I finish yesterday, what's in progress, what's overdue?"
 
-Then reference it in your `CLAUDE.md` or project instructions.
+"Do exploratory work for task <id>, update the description with your findings, and flag blockers in a comment."
 
-### Codex
+"Create a subtask under <id> for the edge case we just found."
 
-Copy the contents of `skill/SKILL.md` into your Codex system prompt or project instructions file.
+"Check my sprint and tell me what's overdue."
+```
 
-### Other agents
+You don't need to learn the CLI commands yourself. The agent handles it.
 
-The skill file is a standalone markdown document. Feed it to any agent that supports custom instructions or tool documentation.
+### Why a CLI and not MCP?
 
-## Config
+A CLI + skill file has fewer moving parts. No extra server process, no protocol layer. The agent already knows how to run shell commands - the skill file just teaches it which ones exist. This matches what Peter Steinberger and the OpenClaw project have found: for tool-use with coding agents, CLI + instructions tends to work better than MCP in practice.
 
-### Config file
+### Scoped output
 
-`~/.config/cu/config.json` (or `$XDG_CONFIG_HOME/cu/config.json`):
+Most commands return only your tasks by default. `cu tasks`, `cu sprint`, `cu overdue`, `cu summary` all scope to what's assigned to you. `cu spaces --my` filters to spaces where you have tasks. This keeps output small and relevant - important when it's going into an agent's context window.
 
-```json
-{
-  "apiToken": "pk_...",
-  "teamId": "12345678"
-}
-```
+## Using from the terminal
 
-### Environment variables
+When you run `cu` in a terminal directly, you get an interactive mode with tables and a task picker.
 
-Environment variables override config file values:
+```bash
+cu tasks                          # interactive table with checkbox picker
+cu sprint                         # your sprint tasks, auto-detected
+cu summary                        # standup helper: completed / in progress / overdue
+cu overdue                        # tasks past their due date
+cu open "login bug"               # fuzzy search, opens in browser
+cu update abc123 -s "done"        # update status
+cu assign abc123 --to me          # assign yourself
+```
 
-| Variable       | Description                        |
-| -------------- | ---------------------------------- |
-| `CU_API_TOKEN` | ClickUp personal API token (`pk_`) |
-| `CU_TEAM_ID`   | Workspace (team) ID                |
+Pass `--json` to any read command to force JSON output instead of the default format.
 
-When both are set, the config file is not required. Useful for CI/CD and containerized agents.
+When output is piped (no TTY), all commands output **Markdown** by default - optimized for AI agent context windows. Pass `--json` to any command for JSON output. Set `CU_OUTPUT=json` environment variable to always get JSON when piped.
 
 ## Commands
 
+20 commands total. All support `--help` for full flag details.
+
 ### `cu init`
 
 First-time setup. Prompts for your API token, verifies it, auto-detects your workspace, and writes `~/.config/cu/config.json`.
@@ -140,7 +110,7 @@ cu tasks --status "in progress"
 cu tasks --name "login"
 cu tasks --list <listId>
 cu tasks --space <spaceId>
-cu tasks --json          # force JSON output
+cu tasks --json
 ```
 
 ### `cu initiatives`
@@ -192,9 +162,11 @@ Get task details. Pretty summary in terminal, JSON when piped.
 
 ```bash
 cu task abc123
-cu task abc123 --json    # full JSON response
+cu task abc123 --json
 ```
 
+**Note:** When piped, `cu task` outputs a structured Markdown summary of the task. For the full raw API response with all fields (custom fields, checklists, etc.), use `--json`.
+
 ### `cu subtasks <id>`
 
 List subtasks of a task or initiative.
@@ -274,7 +246,7 @@ List all lists in a space, including lists inside folders. Useful for discoverin
 
 ```bash
 cu lists <spaceId>
-cu lists <spaceId> --name "sprint"    # filter by partial name
+cu lists <spaceId> --name "sprint"
 cu lists <spaceId> --json
 ```
 
@@ -289,8 +261,8 @@ List spaces in your workspace. Useful for getting space IDs for the `--space` fi
 
 ```bash
 cu spaces
-cu spaces --name "eng"   # filter by partial name match (case-insensitive)
-cu spaces --my            # show only spaces you are a member of
+cu spaces --name "eng"
+cu spaces --my
 cu spaces --json
 ```
 
@@ -305,9 +277,9 @@ cu spaces --json
 Open a task in the browser. Accepts a task ID or partial name.
 
 ```bash
-cu open abc123                # open by task ID
-cu open "login bug"           # search by name, open first match
-cu open abc123 --json         # output task JSON instead of opening
+cu open abc123
+cu open "login bug"
+cu open abc123 --json
 ```
 
 If the query matches multiple tasks by name, all matches are listed and the first is opened.
@@ -318,7 +290,7 @@ Daily standup helper. Shows tasks grouped into: recently completed, in progress,
 
 ```bash
 cu summary
-cu summary --hours 48         # extend completed window to 48 hours
+cu summary --hours 48
 cu summary --json
 ```
 
@@ -329,25 +301,23 @@ cu summary --json
 
 ### `cu overdue`
 
-List tasks that are past their due date (excludes done/closed tasks).
+List tasks that are past their due date (excludes done/closed tasks). Sorted most overdue first.
 
 ```bash
 cu overdue
 cu overdue --json
 ```
 
-Tasks are sorted by due date ascending (most overdue first).
-
 ### `cu assign <id>`
 
 Assign or unassign users from a task. Supports `me` as shorthand for your user ID.
 
 ```bash
-cu assign abc123 --to 12345          # add assignee
-cu assign abc123 --to me             # assign yourself
-cu assign abc123 --remove 12345      # remove assignee
-cu assign abc123 --to me --remove 67890  # both at once
-cu assign abc123 --to me --json      # output updated task JSON
+cu assign abc123 --to 12345
+cu assign abc123 --to me
+cu assign abc123 --remove 12345
+cu assign abc123 --to me --remove 67890
+cu assign abc123 --to me --json
 ```
 
 | Flag                | Description                       |
@@ -361,9 +331,9 @@ cu assign abc123 --to me --json      # output updated task JSON
 Manage CLI configuration.
 
 ```bash
-cu config get apiToken        # print a config value
-cu config set teamId 12345    # set a config value
-cu config path                # print config file path
+cu config get apiToken
+cu config set teamId 12345
+cu config path
 ```
 
 Valid keys: `apiToken`, `teamId`. Setting `apiToken` validates the `pk_` prefix.
@@ -373,17 +343,35 @@ Valid keys: `apiToken`, `teamId`. Setting `apiToken` validates the `pk_` prefix.
 Output shell completion script. Supports `bash`, `zsh`, and `fish`.
 
 ```bash
-# Bash - add to ~/.bashrc
-eval "$(cu completion bash)"
+eval "$(cu completion bash)"                                    # Bash
+eval "$(cu completion zsh)"                                     # Zsh
+cu completion fish > ~/.config/fish/completions/cu.fish          # Fish
+```
 
-# Zsh - add to ~/.zshrc
-eval "$(cu completion zsh)"
+## Config
 
-# Fish - save to completions directory
-cu completion fish > ~/.config/fish/completions/cu.fish
+### Config file
+
+`~/.config/cu/config.json` (or `$XDG_CONFIG_HOME/cu/config.json`):
+
+```json
+{
+  "apiToken": "pk_...",
+  "teamId": "12345678"
+}
 ```
 
-Completions cover all commands, flags, and known values (priority levels, status names, config keys).
+### Environment variables
+
+Environment variables override config file values:
+
+| Variable       | Description                                                       |
+| -------------- | ----------------------------------------------------------------- |
+| `CU_API_TOKEN` | ClickUp personal API token (`pk_`)                                |
+| `CU_TEAM_ID`   | Workspace (team) ID                                               |
+| `CU_OUTPUT`    | Set to `json` to force JSON output when piped (default: markdown) |
+
+When both are set, the config file is not required. Useful for CI/CD and containerized agents.
 
 ## Development
 

package/dist/index.js

@@ -220,6 +220,11 @@ import chalk from "chalk";
 function isTTY() {
   return Boolean(process.stdout.isTTY);
 }
+function shouldOutputJson(forceJson) {
+  if (forceJson) return true;
+  if (process.env["CU_OUTPUT"] === "json") return true;
+  return false;
+}
 function cell(value, width) {
   if (value.length > width) return value.slice(0, width - 1) + "\u2026";
   return value.padEnd(width);
@@ -252,6 +257,128 @@ var TASK_COLUMNS = [
   { key: "list", label: "LIST" }
 ];
 
+// src/markdown.ts
+function escapeCell(value) {
+  return value.replace(/\|/g, "\\|");
+}
+function formatMarkdownTable(rows, columns) {
+  const header = "| " + columns.map((c) => c.label).join(" | ") + " |";
+  const divider = "| " + columns.map(() => "---").join(" | ") + " |";
+  const lines = [header, divider];
+  for (const row of rows) {
+    const cells = columns.map((c) => escapeCell(String(row[c.key] ?? "")));
+    lines.push("| " + cells.join(" | ") + " |");
+  }
+  return lines.join("\n");
+}
+var TASK_MD_COLUMNS = [
+  { key: "id", label: "ID" },
+  { key: "name", label: "Name" },
+  { key: "status", label: "Status" },
+  { key: "list", label: "List" }
+];
+function formatTasksMarkdown(tasks) {
+  if (tasks.length === 0) return "No tasks found.";
+  return formatMarkdownTable(tasks, TASK_MD_COLUMNS);
+}
+function formatCommentsMarkdown(comments) {
+  if (comments.length === 0) return "No comments found.";
+  return comments.map((c) => `**${c.user}** (${c.date})
+
+${c.text}`).join("\n\n---\n\n");
+}
+var LIST_MD_COLUMNS = [
+  { key: "id", label: "ID" },
+  { key: "name", label: "Name" },
+  { key: "folder", label: "Folder" }
+];
+function formatListsMarkdown(lists) {
+  if (lists.length === 0) return "No lists found.";
+  return formatMarkdownTable(lists, LIST_MD_COLUMNS);
+}
+var SPACE_MD_COLUMNS = [
+  { key: "id", label: "ID" },
+  { key: "name", label: "Name" }
+];
+function formatSpacesMarkdown(spaces) {
+  if (spaces.length === 0) return "No spaces found.";
+  return formatMarkdownTable(spaces, SPACE_MD_COLUMNS);
+}
+function formatGroupedTasksMarkdown(groups) {
+  const sections = groups.filter((g) => g.tasks.length > 0).map((g) => `## ${g.label}
+
+${formatMarkdownTable(g.tasks, TASK_MD_COLUMNS)}`);
+  if (sections.length === 0) return "No tasks found.";
+  return sections.join("\n\n");
+}
+function formatDate(ms) {
+  const d = new Date(Number(ms));
+  const year = d.getUTCFullYear();
+  const month = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function formatDuration(ms) {
+  const totalMinutes = Math.floor(ms / 6e4);
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  return `${hours}h ${minutes}m`;
+}
+function formatTaskDetailMarkdown(task) {
+  const lines = [`# ${task.name}`, ""];
+  const isInitiative2 = (task.custom_item_id ?? 0) !== 0;
+  const fields = [
+    ["ID", task.id],
+    ["Status", task.status.status],
+    ["Type", isInitiative2 ? "initiative" : "task"],
+    ["List", task.list.name],
+    ["URL", task.url],
+    [
+      "Assignees",
+      task.assignees.length > 0 ? task.assignees.map((a) => a.username).join(", ") : void 0
+    ],
+    ["Priority", task.priority?.priority],
+    ["Parent", task.parent ?? void 0],
+    ["Start Date", task.start_date ? formatDate(task.start_date) : void 0],
+    ["Due Date", task.due_date ? formatDate(task.due_date) : void 0],
+    [
+      "Time Estimate",
+      task.time_estimate != null && task.time_estimate > 0 ? formatDuration(task.time_estimate) : void 0
+    ],
+    [
+      "Time Spent",
+      task.time_spent != null && task.time_spent > 0 ? formatDuration(task.time_spent) : void 0
+    ],
+    ["Tags", task.tags && task.tags.length > 0 ? task.tags.map((t) => t.name).join(", ") : void 0],
+    ["Created", task.date_created ? formatDate(task.date_created) : void 0],
+    ["Updated", task.date_updated ? formatDate(task.date_updated) : void 0]
+  ];
+  for (const [label, value] of fields) {
+    if (value != null && value !== "") {
+      lines.push(`**${label}:** ${value}`);
+    }
+  }
+  if (task.description) {
+    lines.push("", "## Description", "", task.description);
+  }
+  return lines.join("\n");
+}
+function formatUpdateConfirmation(id, name) {
+  return `Updated task ${id}: "${name}"`;
+}
+function formatCreateConfirmation(id, name, url) {
+  return `Created task ${id}: "${name}" - ${url}`;
+}
+function formatCommentConfirmation(id) {
+  return `Comment posted (id: ${id})`;
+}
+function formatAssignConfirmation(taskId, opts) {
+  const parts = [];
+  if (opts.to) parts.push(`Assigned ${opts.to} to ${taskId}`);
+  if (opts.remove) parts.push(`Removed ${opts.remove} from ${taskId}`);
+  return parts.join("; ");
+}
+
 // src/interactive.ts
 import { execFileSync } from "child_process";
 import { checkbox, confirm, Separator } from "@inquirer/prompts";
@@ -439,10 +566,14 @@ async function fetchMyTasks(config, opts = {}) {
   return filtered.map(summarize);
 }
 async function printTasks(tasks, forceJson, config) {
-  if (forceJson || !isTTY()) {
+  if (shouldOutputJson(forceJson)) {
     console.log(JSON.stringify(tasks, null, 2));
     return;
   }
+  if (!isTTY()) {
+    console.log(formatTasksMarkdown(tasks));
+    return;
+  }
   if (tasks.length === 0) {
     console.log("No tasks found.");
     return;
@@ -671,13 +802,13 @@ async function runSprintCommand(config, opts) {
   const me = await client.getMe();
   const viewData = await client.getListViews(activeList.id);
   const listView = viewData.required_views?.list;
-  let sprintTasks;
+  let allTasks;
   if (listView) {
-    const allViewTasks = await client.getViewTasks(listView.id);
-    sprintTasks = allViewTasks.filter((t) => t.assignees.some((a) => a.id === me.id));
+    allTasks = await client.getViewTasks(listView.id);
   } else {
-    sprintTasks = await client.getMyTasksFromList(activeList.id);
+    allTasks = await client.getTasksFromList(activeList.id);
   }
+  const sprintTasks = allTasks.filter((t) => t.assignees.some((a) => Number(a.id) === me.id));
   const filtered = opts.status ? sprintTasks.filter((t) => t.status.status.toLowerCase() === opts.status.toLowerCase()) : sprintTasks;
   const summaries = filtered.map(summarize);
   await printTasks(summaries, opts.json ?? false, config);
@@ -700,7 +831,7 @@ async function postComment(config, taskId, text) {
 
 // src/commands/comments.ts
 import chalk3 from "chalk";
-function formatDate(timestamp) {
+function formatDate2(timestamp) {
   return new Date(Number(timestamp)).toLocaleString("en-US", {
     month: "short",
     day: "numeric",
@@ -720,10 +851,14 @@ async function fetchComments(config, taskId) {
   }));
 }
 function printComments(comments, forceJson) {
-  if (forceJson || !isTTY()) {
+  if (shouldOutputJson(forceJson)) {
     console.log(JSON.stringify(comments, null, 2));
     return;
   }
+  if (!isTTY()) {
+    console.log(formatCommentsMarkdown(comments));
+    return;
+  }
   if (comments.length === 0) {
     console.log("No comments found.");
     return;
@@ -732,7 +867,7 @@ function printComments(comments, forceJson) {
   for (let i = 0; i < comments.length; i++) {
     const c = comments[i];
     if (i > 0) console.log(separator);
-    console.log(`${chalk3.bold(c.user)}  ${chalk3.dim(formatDate(c.date))}`);
+    console.log(`${chalk3.bold(c.user)}  ${chalk3.dim(formatDate2(c.date))}`);
     console.log(c.text);
     if (i < comments.length - 1) console.log("");
   }
@@ -761,10 +896,14 @@ async function fetchLists(config, spaceId, opts = {}) {
   return results;
 }
 function printLists(lists, forceJson) {
-  if (forceJson || !isTTY()) {
+  if (shouldOutputJson(forceJson)) {
     console.log(JSON.stringify(lists, null, 2));
     return;
   }
+  if (!isTTY()) {
+    console.log(formatListsMarkdown(lists));
+    return;
+  }
   if (lists.length === 0) {
     console.log("No lists found.");
     return;
@@ -832,7 +971,7 @@ async function fetchInbox(config, days = 30) {
 async function printInbox(tasks, forceJson, config) {
   const now = Date.now();
   const groups = groupTasks(tasks, now);
-  if (forceJson || !isTTY()) {
+  if (shouldOutputJson(forceJson)) {
     const jsonGroups = {};
     for (const { key } of TIME_PERIODS) {
       if (groups[key].length > 0) {
@@ -842,6 +981,14 @@ async function printInbox(tasks, forceJson, config) {
     console.log(JSON.stringify(jsonGroups, null, 2));
     return;
   }
+  if (!isTTY()) {
+    const mdGroups = TIME_PERIODS.filter((p) => groups[p.key].length > 0).map((p) => ({
+      label: p.label,
+      tasks: groups[p.key]
+    }));
+    console.log(formatGroupedTasksMarkdown(mdGroups));
+    return;
+  }
   if (tasks.length === 0) {
     console.log("No recently updated tasks.");
     return;
@@ -873,7 +1020,11 @@ async function listSpaces(config, opts) {
     );
     spaces = spaces.filter((s) => mySpaceIds.has(s.id));
   }
-  if (!opts.json && isTTY()) {
+  if (shouldOutputJson(opts.json ?? false)) {
+    console.log(JSON.stringify(spaces, null, 2));
+  } else if (!isTTY()) {
+    console.log(formatSpacesMarkdown(spaces.map((s) => ({ id: s.id, name: s.name }))));
+  } else {
     const table = formatTable(
       spaces.map((s) => ({ id: s.id, name: s.name })),
       [
@@ -882,8 +1033,6 @@ async function listSpaces(config, opts) {
       ]
     );
     console.log(table);
-  } else {
-    console.log(JSON.stringify(spaces, null, 2));
   }
 }
 
@@ -938,7 +1087,7 @@ async function runAssignedCommand(config, opts) {
   const client = new ClickUpClient(config);
   const allTasks = await client.getMyTasks(config.teamId);
   const groups = groupByStatus(allTasks, opts.includeClosed ?? false);
-  if (opts.json || !isTTY()) {
+  if (shouldOutputJson(opts.json ?? false)) {
     const result = {};
     for (const group of groups) {
       result[group.status.toLowerCase()] = group.tasks.map((t) => toJsonTask(t, summarize(t)));
@@ -946,6 +1095,14 @@ async function runAssignedCommand(config, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
+  if (!isTTY()) {
+    const mdGroups = groups.map((g) => ({
+      label: g.status,
+      tasks: g.tasks.map((t) => summarize(t))
+    }));
+    console.log(formatGroupedTasksMarkdown(mdGroups));
+    return;
+  }
   if (groups.length === 0) {
     console.log("No tasks found.");
     return;
@@ -971,13 +1128,13 @@ async function openTask(config, query, opts = {}) {
     } catch {
     }
     if (task) {
-      if (opts.json) {
+      if (shouldOutputJson(opts.json ?? false)) {
         console.log(JSON.stringify(task, null, 2));
+      } else if (!isTTY()) {
+        console.log(formatTaskDetailMarkdown(task));
       } else {
-        if (isTTY()) {
-          console.log(task.name);
-          console.log(task.url);
-        }
+        console.log(task.name);
+        console.log(task.url);
         openUrl(task.url);
       }
       return task;
@@ -995,15 +1152,18 @@ async function openTask(config, query, opts = {}) {
     }
     console.log("Opening first match...");
   }
-  if (opts.json) {
+  if (shouldOutputJson(opts.json ?? false)) {
     const fullTask = await client.getTask(first.id);
     console.log(JSON.stringify(fullTask, null, 2));
     return fullTask;
   }
-  if (isTTY()) {
-    console.log(first.name);
-    console.log(first.url);
+  if (!isTTY()) {
+    const fullTask = await client.getTask(first.id);
+    console.log(formatTaskDetailMarkdown(fullTask));
+    return fullTask;
   }
+  console.log(first.name);
+  console.log(first.url);
   openUrl(first.url);
   return {
     id: first.id,
@@ -1017,7 +1177,7 @@ async function openTask(config, query, opts = {}) {
 }
 
 // src/commands/summary.ts
-var IN_PROGRESS_PATTERNS = ["in progress", "in review", "doing"];
+var IN_PROGRESS_PATTERNS = ["in progress", "in review", "code review", "doing"];
 function isCompletedRecently(task, cutoff) {
   if (!isDoneStatus(task.status.status)) return false;
   const updated = Number(task.date_updated);
@@ -1065,10 +1225,19 @@ async function runSummaryCommand(config, opts) {
   const client = new ClickUpClient(config);
   const allTasks = await client.getMyTasks(config.teamId);
   const result = categorizeTasks(allTasks, opts.hours);
-  if (opts.json || !isTTY()) {
+  if (shouldOutputJson(opts.json)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
+  if (!isTTY()) {
+    const mdGroups = [
+      { label: "Completed Recently", tasks: result.completed },
+      { label: "In Progress", tasks: result.inProgress },
+      { label: "Overdue", tasks: result.overdue }
+    ];
+    console.log(formatGroupedTasksMarkdown(mdGroups));
+    return;
+  }
   printSection("Completed Recently", result.completed);
   printSection("In Progress", result.inProgress);
   printSection("Overdue", result.overdue);
@@ -1600,8 +1769,10 @@ program.command("task <taskId>").description("Get task details").option("--json"
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await getTask(config, taskId);
-    if (opts.json || !isTTY()) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
+    } else if (!isTTY()) {
+      console.log(formatTaskDetailMarkdown(result));
     } else {
       const lines = [
         `ID:          ${result.id}`,
@@ -1622,10 +1793,10 @@ program.command("update <taskId>").description("Update a task").option("-n, --na
     const config = loadConfig();
     const payload = buildUpdatePayload(opts);
     const result = await updateTask(config, taskId, payload);
-    if (isTTY()) {
-      console.log(`Updated task ${result.id}: "${result.name}"`);
-    } else {
+    if (shouldOutputJson(false)) {
       console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(formatUpdateConfirmation(result.id, result.name));
     }
   })
 );
@@ -1633,10 +1804,10 @@ program.command("create").description("Create a new task").option("-l, --list <l
   wrapAction(async (opts) => {
     const config = loadConfig();
     const result = await createTask(config, opts);
-    if (isTTY()) {
-      console.log(`Created task ${result.id}: "${result.name}" - ${result.url}`);
-    } else {
+    if (shouldOutputJson(false)) {
       console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(formatCreateConfirmation(result.id, result.name, result.url));
     }
   })
 );
@@ -1657,10 +1828,10 @@ program.command("comment <taskId>").description("Post a comment on a task").requ
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await postComment(config, taskId, opts.message);
-    if (isTTY()) {
-      console.log(`Comment posted (id: ${result.id})`);
-    } else {
+    if (shouldOutputJson(false)) {
       console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(formatCommentConfirmation(result.id));
     }
   })
 );
@@ -1730,13 +1901,10 @@ program.command("assign <taskId>").description("Assign or unassign users from a
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await assignTask(config, taskId, opts);
-    if (opts.json || !isTTY()) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
     } else {
-      const parts = [];
-      if (opts.to) parts.push(`Assigned ${opts.to} to task ${taskId}`);
-      if (opts.remove) parts.push(`Removed ${opts.remove} from task ${taskId}`);
-      console.log(parts.join("; "));
+      console.log(formatAssignConfirmation(taskId, { to: opts.to, remove: opts.remove }));
     }
   })
 );

package/package.json

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