@doist/twist-cli 1.11.0 → 2.1.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## 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 msg unread                    # List unread conversations\ntw msg <conversation-ref>        # View conversation (shorthand for view)\ntw msg view <conversation-ref>   # View conversation messages\ntw msg reply <ref> \"content\"     # Send a message\ntw msg done <ref>                # Archive conversation\n```\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**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 msg unread --json\ntw msg view <conversation-id>\ntw msg 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## 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 msg unread                    # List unread conversations\ntw msg <conversation-ref>        # View conversation (shorthand for view)\ntw msg view <conversation-ref>   # View conversation messages\ntw msg reply <ref> \"content\"     # Send a message\ntw msg done <ref>                # Archive conversation\n```\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**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 msg unread --json\ntw msg view <conversation-id>\ntw msg 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\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";
 //# 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,0tJA0IzB,CAAA;AAED,eAAO,MAAM,kBAAkB,gzJAKd,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,0+LA6KzB,CAAA;AAED,eAAO,MAAM,kBAAkB,gkMAKd,CAAA"}

package/dist/lib/skills/content.js

@@ -15,6 +15,20 @@ tw workspaces                    # List available workspaces
 tw workspace use <ref>           # Set current workspace
 \`\`\`
 
+## View by URL
+
+\`\`\`bash
+tw view <url>                    # View any Twist entity by URL
+\`\`\`
+
+Routes automatically based on URL structure:
+- Message URL → \`tw msg view\`
+- Conversation URL → \`tw conversation view\`
+- Thread+comment URL → \`tw thread view\` (comment ID extracted from URL)
+- Thread URL → \`tw thread view\`
+
+All target command flags pass through (e.g. \`--json\`, \`--raw\`, \`--full\`).
+
 ## Inbox
 
 \`\`\`bash
@@ -48,13 +62,26 @@ Default \`--notify\` is EVERYONE_IN_THREAD. Options: EVERYONE, EVERYONE_IN_THREA
 ## Conversations (DMs/Groups)
 
 \`\`\`bash
-tw msg unread                    # List unread conversations
-tw msg <conversation-ref>        # View conversation (shorthand for view)
-tw msg view <conversation-ref>   # View conversation messages
-tw msg reply <ref> "content"     # Send a message
-tw msg done <ref>                # Archive conversation
+tw conversation unread                    # List unread conversations
+tw conversation <conversation-ref>        # View conversation (shorthand for view)
+tw conversation view <conversation-ref>   # View conversation messages
+tw conversation reply <ref> "content"     # Send a message
+tw conversation done <ref>                # Archive conversation
 \`\`\`
 
+Alias: \`tw convo\` works the same as \`tw conversation\`.
+
+## Conversation Messages
+
+\`\`\`bash
+tw msg <message-ref>             # View a message (shorthand for view)
+tw msg view <message-ref>        # View a single conversation message
+tw msg update <ref> "content"    # Edit a conversation message
+tw msg delete <ref>              # Delete a conversation message
+\`\`\`
+
+Alias: \`tw message\` works the same as \`tw msg\`.
+
 ## Search
 
 \`\`\`bash
@@ -118,6 +145,14 @@ Commands accept flexible references:
 
 ## Common Workflows
 
+**View by URL (auto-routes to the right command):**
+\`\`\`bash
+tw view https://twist.com/a/1585/ch/100/t/200          # View thread
+tw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment
+tw view https://twist.com/a/1585/msg/400                 # View conversation
+tw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON
+\`\`\`
+
 **Check inbox and respond:**
 \`\`\`bash
 tw inbox --unread --json
@@ -134,9 +169,9 @@ tw thread view <thread-id>
 
 **Check DMs:**
 \`\`\`bash
-tw msg unread --json
-tw msg view <conversation-id>
-tw msg reply <id> "Got it, thanks!"
+tw conversation unread --json
+tw conversation view <conversation-id>
+tw conversation reply <id> "Got it, thanks!"
 \`\`\`
 `;
 export const SKILL_FILE_CONTENT = `---

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0I5B,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6K5B,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": "1.11.0",
+    "version": "2.1.0",
     "description": "TypeScript CLI for Twist",
     "type": "module",
     "main": "dist/index.js",