Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,7 @@ tdc thread reply <ref> # reply to a thread
tdc thread rename <ref> "New title" # rename a thread
tdc thread update <ref> "New body" # edit a thread's body (first post)
tdc conversation unread # list unread conversations
tdc conversation list # list conversations (--kind, --participant, --name, --state)
tdc conversation view <ref> # view conversation messages
tdc msg view <ref> # view a conversation message
tdc search "keyword" # search across workspace
Expand Down
16 changes: 13 additions & 3 deletions skills/comms-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,14 +90,15 @@ tdc thread view <ref> --raw # Show raw markdown
tdc thread create <channel-ref> "Title" "content" # Create a new thread
tdc thread create <channel-ref> "Title" "content" --json # Create and return as JSON
tdc thread create <channel-ref> "Title" "content" --json --full # Include all thread fields
tdc thread create <channel-ref> "Title" "content" --notify 123,456 # Notify specific users
tdc thread create <channel-ref> "Title" "content" --notify 123,456 # Notify specific users and/or groups by ID
tdc thread create <channel-ref> "Title" "content" --unarchive # Land thread in author's Inbox (overrides default Comms auto-archive)
tdc thread create <channel-ref> "Title" "content" --no-unarchive # Force archive even when userSettings.unarchiveNewThreads=true
tdc thread create <channel-ref> "Title" "content" --dry-run # Preview without posting
tdc thread create <channel-ref> "Title" --file ./a.png # Attach a file (repeatable; content optional)
tdc thread reply <ref> "content" # Post a comment (notifies EVERYONE_IN_THREAD by default)
tdc thread reply <ref> "content" --notify EVERYONE # Notify all workspace members
tdc thread reply <ref> "content" --notify 123,id:456 # Notify specific user IDs
tdc thread reply <ref> "content" --notify 123,id:456 # Notify specific users by ID
tdc thread reply <ref> "content" --notify 123,Cbzzm11ZeYZoJYD4a6rti # Notify a user and a group (group IDs are base58, not numeric)
tdc thread reply <ref> "content" --json # Post and return comment as JSON
tdc thread reply <ref> "content" --json --full # Include all comment fields
tdc thread reply <ref> "content" --close # Reply and close the thread
Expand Down Expand Up @@ -128,7 +129,7 @@ tdc thread update <ref> "New body" --json # Update and return { id, content } a
tdc thread update <ref> "New body" --json --full # Update and return full thread as JSON
```

Default `--notify` for reply is EVERYONE_IN_THREAD, which may notify more people than intended. Before posting, confirm with the user whether specific people should be notified instead (via `--notify <user-ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated ID refs.
Default `--notify` for reply is EVERYONE_IN_THREAD, which may notify more people than intended. Before posting, confirm with the user whether specific people should be notified instead (via `--notify <ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user and/or group IDs.

`--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.

Expand All @@ -153,6 +154,14 @@ tdc comment delete <comment-ref> --yes --json # Delete and return status

```bash
tdc conversation unread # List unread conversations
tdc conversation list # List active conversations (DMs and groups)
tdc conversation list --kind group # Only group conversations (3+ people)
tdc conversation list --kind direct # Only 1:1 conversations (and your self-DM)
tdc conversation list --participant "Jane" # Only conversations including these users (comma-separated)
tdc conversation list --name "release" # Filter by title substring (case-insensitive)
tdc conversation list --state archived # Archived conversations only (active|all|archived; default active)
tdc conversation list --snippet # Include the latest message snippet
tdc conversation list --limit 20 --json # Cap rows and output as JSON
tdc conversation <conversation-ref> # View conversation (shorthand for view)
tdc conversation view <conversation-ref> # View conversation messages
tdc conversation with <user-ref> # Find your 1:1 DM with a user
Expand Down Expand Up @@ -429,6 +438,7 @@ tdc thread view <thread-id>
**Check DMs:**
```bash
tdc conversation unread --json
tdc conversation list --kind group --json # find a group DM by participants/name
tdc conversation view <conversation-id>
tdc conversation with "Alice Example"
tdc conversation reply <id> "Got it, thanks!"
Expand Down
Loading
Loading