@doist/twist-cli 2.1.0 → 2.3.0

package/dist/lib/skills/content.d.ts

@@ -1,5 +1,5 @@
 export declare const SKILL_NAME = "twist-cli";
 export declare const SKILL_DESCRIPTION = "Twist messaging CLI for team communication";
-export declare const SKILL_CONTENT = "# Twist CLI Skill\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser)\ntw auth token <your-api-token>   # Save API token manually\ntw auth status                   # Verify authentication\ntw auth logout                   # Remove saved token\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\n```\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread reply <ref> \"content\"  # Post a comment\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,456   # Notify specific user IDs\ntw thread done <ref>             # Archive thread (mark done)\n```\n\nDefault `--notify` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user IDs.\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation done <ref>                # Archive conversation\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg delete <ref>              # Delete a conversation message\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <ids> # Limit to conversations (comma-separated)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <id> # Filter by channel IDs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\n```\n\n## Users & Channels\n\n```bash\ntw user                          # Show current user info\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List workspace channels\n```\n\n## Reactions\n\n```bash\ntw react thread <id> \uD83D\uDC4D          # Add reaction to thread\ntw react comment <id> +1         # Add reaction (shortcode)\ntw react message <id> heart      # Add reaction to DM message\ntw unreact thread <id> \uD83D\uDC4D        # Remove reaction\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Global Options\n\n```bash\n--no-spinner       # Disable loading animations\n--progress-jsonl   # Machine-readable progress events (JSONL to stderr)\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
-export declare const SKILL_FILE_CONTENT = "---\nname: twist-cli\ndescription: Twist messaging CLI for team communication\n---\n\n# Twist CLI Skill\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser)\ntw auth token <your-api-token>   # Save API token manually\ntw auth status                   # Verify authentication\ntw auth logout                   # Remove saved token\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\n```\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread reply <ref> \"content\"  # Post a comment\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,456   # Notify specific user IDs\ntw thread done <ref>             # Archive thread (mark done)\n```\n\nDefault `--notify` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user IDs.\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation done <ref>                # Archive conversation\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg delete <ref>              # Delete a conversation message\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <ids> # Limit to conversations (comma-separated)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <id> # Filter by channel IDs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\n```\n\n## Users & Channels\n\n```bash\ntw user                          # Show current user info\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List workspace channels\n```\n\n## Reactions\n\n```bash\ntw react thread <id> \uD83D\uDC4D          # Add reaction to thread\ntw react comment <id> +1         # Add reaction (shortcode)\ntw react message <id> heart      # Add reaction to DM message\ntw unreact thread <id> \uD83D\uDC4D        # Remove reaction\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Global Options\n\n```bash\n--no-spinner       # Disable loading animations\n--progress-jsonl   # Machine-readable progress events (JSONL to stderr)\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
+export declare const SKILL_CONTENT = "# Twist CLI Skill\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser)\ntw auth token <your-api-token>   # Save API token manually\ntw auth status                   # Verify authentication\ntw auth logout                   # Remove saved token\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\ntw completion install            # Install shell completions\n```\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread reply <ref> \"content\"  # Post a comment\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,id:456   # Notify specific user IDs\ntw thread done <ref>             # Archive thread (mark done)\n```\n\nDefault `--notify` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user ID refs.\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation done <ref>                # Archive conversation\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg delete <ref>              # Delete a conversation message\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\n```\n\n## Users & Channels\n\n```bash\ntw user                          # Show current user info\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List workspace channels\n```\n\n## Reactions\n\n```bash\ntw react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntw react comment <ref> +1        # Add reaction (shortcode)\ntw react message <ref> heart     # Add reaction to DM message\ntw unreact thread <ref> \uD83D\uDC4D       # Remove reaction\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntw completion install            # Install tab completions (prompts for shell)\ntw completion install bash       # Install for specific shell\ntw completion install zsh\ntw completion install fish\ntw completion uninstall          # Remove completions\n```\n\n## Global Options\n\n```bash\n--no-spinner       # Disable loading animations\n--progress-jsonl   # Machine-readable progress events (JSONL to stderr)\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
+export declare const SKILL_FILE_CONTENT = "---\nname: twist-cli\ndescription: Twist messaging CLI for team communication\n---\n\n# Twist CLI Skill\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser)\ntw auth token <your-api-token>   # Save API token manually\ntw auth status                   # Verify authentication\ntw auth logout                   # Remove saved token\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\ntw completion install            # Install shell completions\n```\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread reply <ref> \"content\"  # Post a comment\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,id:456   # Notify specific user IDs\ntw thread done <ref>             # Archive thread (mark done)\n```\n\nDefault `--notify` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user ID refs.\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation done <ref>                # Archive conversation\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg delete <ref>              # Delete a conversation message\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\n```\n\n## Users & Channels\n\n```bash\ntw user                          # Show current user info\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List workspace channels\n```\n\n## Reactions\n\n```bash\ntw react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntw react comment <ref> +1        # Add reaction (shortcode)\ntw react message <ref> heart     # Add reaction to DM message\ntw unreact thread <ref> \uD83D\uDC4D       # Remove reaction\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntw completion install            # Install tab completions (prompts for shell)\ntw completion install bash       # Install for specific shell\ntw completion install zsh\ntw completion install fish\ntw completion uninstall          # Remove completions\n```\n\n## Global Options\n\n```bash\n--no-spinner       # Disable loading animations\n--progress-jsonl   # Machine-readable progress events (JSONL to stderr)\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
 //# sourceMappingURL=content.d.ts.map

package/dist/lib/skills/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,+CAA+C,CAAA;AAE7E,eAAO,MAAM,aAAa,0+LA6KzB,CAAA;AAED,eAAO,MAAM,kBAAkB,gkMAKd,CAAA"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,+CAA+C,CAAA;AAE7E,eAAO,MAAM,aAAa,61MAwLzB,CAAA;AAED,eAAO,MAAM,kBAAkB,m7MAKd,CAAA"}

package/dist/lib/skills/content.js

@@ -13,6 +13,7 @@ tw auth status                   # Verify authentication
 tw auth logout                   # Remove saved token
 tw workspaces                    # List available workspaces
 tw workspace use <ref>           # Set current workspace
+tw completion install            # Install shell completions
 \`\`\`
 
 ## View by URL
@@ -53,11 +54,11 @@ tw thread view <ref> --since <date> # Comments newer than date
 tw thread view <ref> --raw       # Show raw markdown
 tw thread reply <ref> "content"  # Post a comment
 tw thread reply <ref> "content" --notify EVERYONE  # Notify all workspace members
-tw thread reply <ref> "content" --notify 123,456   # Notify specific user IDs
+tw thread reply <ref> "content" --notify 123,id:456   # Notify specific user IDs
 tw thread done <ref>             # Archive thread (mark done)
 \`\`\`
 
-Default \`--notify\` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user IDs.
+Default \`--notify\` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user ID refs.
 
 ## Conversations (DMs/Groups)
 
@@ -91,10 +92,10 @@ tw search "query" --author <ref> # Filter by author
 tw search "query" --to <ref>     # Messages sent to user
 tw search "query" --title-only   # Search thread titles only
 tw search "query" --mention-me   # Results mentioning current user
-tw search "query" --conversation <ids> # Limit to conversations (comma-separated)
+tw search "query" --conversation <refs> # Limit to conversations (comma-separated refs)
 tw search "query" --since <date> # Content from date
 tw search "query" --until <date> # Content until date
-tw search "query" --channel <id> # Filter by channel IDs (comma-separated)
+tw search "query" --channel <refs> # Filter by channel refs (comma-separated)
 tw search "query" --limit <n>    # Max results (default: 50)
 tw search "query" --cursor <cur> # Pagination cursor
 \`\`\`
@@ -111,14 +112,24 @@ tw channels                      # List workspace channels
 ## Reactions
 
 \`\`\`bash
-tw react thread <id> 👍          # Add reaction to thread
-tw react comment <id> +1         # Add reaction (shortcode)
-tw react message <id> heart      # Add reaction to DM message
-tw unreact thread <id> 👍        # Remove reaction
+tw react thread <ref> 👍         # Add reaction to thread
+tw react comment <ref> +1        # Add reaction (shortcode)
+tw react message <ref> heart     # Add reaction to DM message
+tw unreact thread <ref> 👍       # Remove reaction
 \`\`\`
 
 Supported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave
 
+## Shell Completions
+
+\`\`\`bash
+tw completion install            # Install tab completions (prompts for shell)
+tw completion install bash       # Install for specific shell
+tw completion install zsh
+tw completion install fish
+tw completion uninstall          # Remove completions
+\`\`\`
+
 ## Global Options
 
 \`\`\`bash

package/dist/lib/skills/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAAG,4CAA4C,CAAA;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6K5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,iBAAiB;;;EAG9B,aAAa,EAAE,CAAA"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAAG,4CAA4C,CAAA;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwL5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,iBAAiB;;;EAG9B,aAAa,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/twist-cli",
-    "version": "2.1.0",
+    "version": "2.3.0",
     "description": "TypeScript CLI for Twist",
     "type": "module",
     "main": "dist/index.js",
@@ -48,6 +48,7 @@
     ],
     "dependencies": {
         "@doist/twist-sdk": "2.0.2",
+        "@pnpm/tabtab": "0.5.4",
         "chalk": "5.6.2",
         "commander": "14.0.2",
         "marked": "15.0.12",