feat: add server-side search and parallel space traversal

README.md

@@ -1,82 +1,109 @@
-# @triptechtravel/clickup-cli
+# clickup-cli (nick-preda fork)
 
-A command-line tool for working with ClickUp tasks, comments, and sprints -- designed for developers who live in the terminal and use GitHub.
+A CLI for managing ClickUp from the terminal. Forked from [triptechtravel/clickup-cli](https://github.com/triptechtravel/clickup-cli) with extra features for daily use with AI agents (Claude Code) and automation.
 
-[![Release](https://img.shields.io/github/v/release/triptechtravel/clickup-cli)](https://github.com/triptechtravel/clickup-cli/releases)
-[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![CI](https://github.com/triptechtravel/clickup-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/triptechtravel/clickup-cli/actions/workflows/ci.yml)
-[![Go Report Card](https://goreportcard.com/badge/github.com/triptechtravel/clickup-cli)](https://goreportcard.com/report/github.com/triptechtravel/clickup-cli)
-[![Go Reference](https://pkg.go.dev/badge/github.com/triptechtravel/clickup-cli.svg)](https://pkg.go.dev/github.com/triptechtravel/clickup-cli)
+## What this fork adds
+
+| Feature | Command | Why |
+|---------|---------|-----|
+| **List all lists in a space** | `clickup list ls` | Find list IDs without digging through the UI |
+| **Send messages to Chat channels** | `clickup chat send <channel-id> "msg"` | Post reports, alerts, and notifications to Chat |
+| **Create tasks by list name** | `clickup task create --list-name "Issues"` | No need to look up numeric list IDs |
+| **Search with assignee filter** | `clickup task search "term" --assignee me` | Filter search results by assignee |
+| **Faster search** | Server-side search + parallel space traversal | Upstream only did client-side filtering |
 
 ## Install
 
 ```sh
-# Homebrew
-brew install triptechtravel/tap/clickup
-
-# Go
-go install github.com/triptechtravel/clickup-cli/cmd/clickup@latest
+# From source (recommended for this fork)
+git clone https://github.com/nick-preda/clickup-cli.git
+cd clickup-cli
+make install
 
-# Or download a binary from the releases page
+# Or directly with Go
+go install github.com/nick-preda/clickup-cli/cmd/clickup@latest
 ```
 
 ## Quick start
 
 ```sh
-clickup auth login        # authenticate with your API token
+clickup auth login         # authenticate with your API token
 clickup space select       # choose a default space
-clickup task view          # view the task from your current git branch
-clickup status set "done"  # fuzzy-matched status update
-clickup link pr            # link the current GitHub PR to the task
+clickup list ls            # see all lists and their IDs
+clickup task create --list-name "Issues" --name "Fix the bug" --priority 2
+clickup task search "bug"  # find tasks
+clickup chat send khpgh-10335 "Deploy done"  # post to a Chat channel
 ```
 
-See the [getting started guide](https://triptechtravel.github.io/clickup-cli/getting-started/) for a full walkthrough.
+## Daily workflow
+
+```sh
+# Find where to create a task
+clickup list ls
+# 900601764492  Issues      (no folder)
+# 900401327544  Nanea       (no folder)
+# 901510841332  Task        Gitlab
 
-## What it does
+# Create a task by name (no list-id needed)
+clickup task create --list-name "Issues" \
+  --name "[Bug] Fix login timeout" --priority 2
 
-- **Task management** -- view, create, edit, search, and bulk-edit tasks with custom fields, tags, points, and time estimates
-- **Git integration** -- auto-detects task IDs from branch names and links PRs, branches, and commits to ClickUp
-- **Sprint dashboard** -- `sprint current` shows tasks grouped by status; `task create --current` creates tasks in the active sprint
-- **Time tracking** -- log time, view per-task entries, or query workspace-wide timesheets by date range
-- **Comments & inbox** -- add comments with @mentions, view your recent mentions across the workspace
-- **Fuzzy status matching** -- set statuses with partial input (`"review"` matches `"code review"`)
-- **AI-friendly** -- `--json` output and explicit flags make it easy for AI agents to read and update tasks
-- **CI/CD ready** -- `--with-token`, exit codes, and JSON output for automation; includes GitHub Actions examples
+# Search your tasks
+clickup task search "login" --assignee me
 
-## Commands
+# Add a comment with @mentions
+clickup comment add 86abc123 "@Michela this is ready for review"
+
+# Send a report to a Chat channel
+clickup chat send khpgh-10335 "Daily report: all systems green"
+
+# View task from current git branch (auto-detected)
+clickup task view
+```
 
-Full command list with flags and examples: **[Command reference](https://triptechtravel.github.io/clickup-cli/commands/)**
+## All commands
 
-| Area | Key commands |
-|------|-------------|
-| **Tasks** | `task view`, `task create`, `task edit`, `task search`, `task recent` |
-| **Time** | `task time log`, `task time list` |
+| Area | Commands |
+|------|----------|
+| **Tasks** | `task view`, `task create`, `task edit`, `task search`, `task list`, `task recent`, `task delete` |
+| **Lists** | `list ls` |
+| **Chat** | `chat send` |
+| **Comments** | `comment add`, `comment list`, `comment edit`, `comment delete` |
 | **Status** | `status set`, `status list`, `status add` |
 | **Git** | `link pr`, `link sync`, `link branch`, `link commit` |
 | **Sprints** | `sprint current`, `sprint list` |
-| **Comments** | `comment add`, `comment list` |
-| **Workspace** | `inbox`, `member list`, `space select`, `tag list`, `field list` |
+| **Workspace** | `space list`, `space select`, `member list`, `inbox`, `tag list`, `field list` |
 
-## Documentation
+## Using with AI agents
 
-**[triptechtravel.github.io/clickup-cli](https://triptechtravel.github.io/clickup-cli/)**
+This CLI is designed to work well with Claude Code and other AI agents:
 
-- [Installation](https://triptechtravel.github.io/clickup-cli/installation/) -- Homebrew, Go, binaries, shell completions
-- [Getting started](https://triptechtravel.github.io/clickup-cli/getting-started/) -- first-time setup walkthrough
-- [Configuration](https://triptechtravel.github.io/clickup-cli/configuration/) -- config file, per-directory defaults, aliases
-- [Git integration](https://triptechtravel.github.io/clickup-cli/git-integration/) -- branch naming, GitHub linking strategy
-- [CI usage](https://triptechtravel.github.io/clickup-cli/ci-usage/) -- non-interactive auth, JSON output, scripting
-- [GitHub Actions](https://triptechtravel.github.io/clickup-cli/github-actions/) -- ready-to-use workflow templates
-- [AI agents](https://triptechtravel.github.io/clickup-cli/ai-agents/) -- integration with Claude Code, Copilot, Cursor
-- [Command reference](https://triptechtravel.github.io/clickup-cli/reference/clickup/) -- auto-generated flag and usage docs
+```sh
+# JSON output for programmatic use
+clickup list ls --json
+clickup task search "deploy" --json
+
+# AI agent can create tasks without knowing list IDs
+clickup task create --list-name "Issues" --name "task name"
+
+# AI agent can post to Chat channels
+clickup chat send <channel-id> "automated report here"
+```
 
-## Contributing
+## Configuration
+
+Config is stored in `~/.config/clickup/config.yml`:
+
+```yaml
+workspace: "20503057"        # your team/workspace ID
+space: "90060297766"         # default space for list ls, task create --list-name
+```
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, project structure, and guidelines.
+Set per-directory defaults with `directory_defaults` in the config file.
 
-## Author
+## Upstream docs
 
-Created by [Isaac Rowntree](https://github.com/isaacrowntree).
+For features inherited from upstream, see the [original documentation](https://triptechtravel.github.io/clickup-cli/).
 
 ## License
 

pkg/cmd/chat/chat.go

@@ -0,0 +1,19 @@
+package chat
+
+import (
+	"github.com/spf13/cobra"
+	"github.com/triptechtravel/clickup-cli/pkg/cmdutil"
+)
+
+// NewCmdChat returns the "chat" parent command.
+func NewCmdChat(f *cmdutil.Factory) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "chat",
+		Short: "Manage chat channels",
+		Long:  "Send messages to ClickUp Chat channels.",
+	}
+
+	cmd.AddCommand(NewCmdChatSend(f))
+
+	return cmd
+}

pkg/cmd/chat/send.go

@@ -0,0 +1,94 @@
+package chat
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+
+	"github.com/spf13/cobra"
+	"github.com/triptechtravel/clickup-cli/pkg/cmdutil"
+)
+
+type sendOptions struct {
+	factory   *cmdutil.Factory
+	channelID string
+	body      string
+	notifyAll bool
+}
+
+// NewCmdChatSend returns the "chat send" command.
+func NewCmdChatSend(f *cmdutil.Factory) *cobra.Command {
+	opts := &sendOptions{factory: f}
+
+	cmd := &cobra.Command{
+		Use:   "send <channel-id> <message>",
+		Short: "Send a message to a ClickUp Chat channel",
+		Long: `Post a message to a ClickUp Chat channel (view).
+
+The channel ID can be found in the Chat URL:
+  https://app.clickup.com/<workspace>/chat/r/<channel-id>
+
+For example, if the URL is:
+  https://app.clickup.com/20503057/chat/r/khpgh-10335
+then the channel ID is "khpgh-10335".`,
+		Example: `  # Send a message to a chat channel
+  clickup chat send khpgh-10335 "Deploy completed successfully"
+
+  # Send with notifications
+  clickup chat send khpgh-10335 "Urgent: server down" --notify`,
+		Args:              cobra.ExactArgs(2),
+		PersistentPreRunE: cmdutil.NeedsAuth(f),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			opts.channelID = args[0]
+			opts.body = args[1]
+			return sendRun(opts)
+		},
+	}
+
+	cmd.Flags().BoolVar(&opts.notifyAll, "notify", false, "Notify all channel members")
+
+	return cmd
+}
+
+func sendRun(opts *sendOptions) error {
+	ios := opts.factory.IOStreams
+	cs := ios.ColorScheme()
+
+	client, err := opts.factory.ApiClient()
+	if err != nil {
+		return err
+	}
+
+	url := fmt.Sprintf("https://api.clickup.com/api/v2/view/%s/comment", opts.channelID)
+
+	payload, err := json.Marshal(map[string]interface{}{
+		"comment_text": opts.body,
+		"notify_all":   opts.notifyAll,
+	})
+	if err != nil {
+		return fmt.Errorf("failed to marshal payload: %w", err)
+	}
+
+	req, err := http.NewRequest(http.MethodPost, url, bytes.NewReader(payload))
+	if err != nil {
+		return fmt.Errorf("failed to create request: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	resp, err := client.DoRequest(req)
+	if err != nil {
+		return fmt.Errorf("API request failed: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
+		respBody, _ := io.ReadAll(resp.Body)
+		return fmt.Errorf("API error (HTTP %d): %s", resp.StatusCode, string(respBody))
+	}
+
+	fmt.Fprintf(ios.Out, "%s Message sent to channel %s\n", cs.Green("!"), cs.Bold(opts.channelID))
+
+	return nil
+}

pkg/cmd/list/list.go

@@ -0,0 +1,19 @@
+package list
+
+import (
+	"github.com/spf13/cobra"
+	"github.com/triptechtravel/clickup-cli/pkg/cmdutil"
+)
+
+// NewCmdList returns the "list" parent command.
+func NewCmdList(f *cmdutil.Factory) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "list",
+		Short: "Manage lists",
+		Long:  "List and browse ClickUp lists within spaces and folders.",
+	}
+
+	cmd.AddCommand(NewCmdListLs(f))
+
+	return cmd
+}