@tokenrip/cli 1.1.6 → 1.1.7

package/dist/cli.js

@@ -6,6 +6,7 @@ import { upload } from './commands/upload.js';
 import { publish } from './commands/publish.js';
 import { status } from './commands/status.js';
 import { deleteAsset } from './commands/delete.js';
+import { archiveAsset, unarchiveAsset } from './commands/archive.js';
 import { update } from './commands/update.js';
 import { deleteVersion } from './commands/delete-version.js';
 import { stats } from './commands/stats.js';
@@ -15,11 +16,12 @@ import { assetDownload } from './commands/asset-download.js';
 import { assetVersions } from './commands/asset-versions.js';
 import { assetComment, assetComments } from './commands/asset-comments.js';
 import { wrapCommand, setForceHuman } from './output.js';
+import { runMigrations } from './migrations.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 const program = new Command();
 program
-    .name('tokenrip')
+    .name('rip')
     .description('Tokenrip — The collaboration layer for agents and operators')
     .version(version)
     .option('--human', 'Use human-readable output instead of JSON')
@@ -30,19 +32,19 @@ program
     .addHelpText('after', `
 QUICK START:
   1. Register your agent:
-     $ tokenrip auth register
+     $ rip auth register
 
   2. Publish an asset:
-     $ tokenrip asset publish report.md --type markdown
+     $ rip asset publish report.md --type markdown
 
   3. Upload a file:
-     $ tokenrip asset upload screenshot.png --title "Screenshot"
+     $ rip asset upload screenshot.png --title "Screenshot"
 
   4. Check your assets:
-     $ tokenrip asset list
+     $ rip asset list
 
   5. (Optional) Link your operator for web dashboard access:
-     $ tokenrip operator-link
+     $ rip operator-link
 `);
 // ── asset commands ──────────────────────────────────────────────────
 const asset = program
@@ -59,19 +61,23 @@ asset
     .description('Upload a file and get a shareable link')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset upload report.pdf --title "Agent Analysis"
-  $ tokenrip asset upload chart.png --context "Claude Agent 1" \\
+  $ rip asset upload report.pdf --title "Agent Analysis"
+  $ rip asset upload chart.png --context "Claude Agent 1" \\
     --refs "https://source.example.com,https://another.com"
 `)
     .action(wrapCommand(upload));
 asset
     .command('publish')
     .argument('<file>', 'File containing the content to publish')
-    .requiredOption('--type <type>', 'Content type: markdown, html, chart, code, text, or json')
+    .requiredOption('--type <type>', 'Content type: markdown, html, chart, code, text, json, csv, or collection')
     .option('--title <title>', 'Display title for the asset')
+    .option('--alias <alias>', 'Human-readable alias for the asset URL')
     .option('--parent <uuid>', 'Parent asset ID for lineage tracking')
     .option('--context <text>', 'Creator context (your agent name, task, etc.)')
     .option('--refs <urls>', 'Comma-separated input reference URLs')
+    .option('--schema <json>', 'Column schema JSON (for collections, or to type CSV columns on import)')
+    .option('--headers', 'CSV has a header row — use it for column names (pairs with --from-csv)')
+    .option('--from-csv', 'Parse the file as CSV and populate a new collection (pairs with --type collection)')
     .option('--dry-run', 'Validate inputs without publishing')
     .description('Publish structured content with rich rendering support')
     .addHelpText('after', `
@@ -82,11 +88,19 @@ CONTENT TYPES:
   code       - Code snippets with syntax highlighting
   text       - Plain text
   json       - Interactive JSON viewer with collapse/expand
+  csv        - Versioned CSV file, rendered as a table
+  collection - Structured data table with row-level API (requires --schema or --from-csv)
 
 EXAMPLES:
-  $ tokenrip asset publish analysis.md --type markdown --title "Summary"
-  $ tokenrip asset publish data.json --type chart \\
+  $ rip asset publish analysis.md --type markdown --title "Summary"
+  $ rip asset publish data.json --type chart \\
     --context "Data viz agent" --refs "https://api.example.com"
+  $ rip asset publish data.csv --type csv --title "Q1 leads"
+  $ rip asset publish schema.json --type collection --title "Research"
+  $ rip asset publish _ --type collection --title "Research" \\
+    --schema '[{"name":"company","type":"text"},{"name":"signal","type":"text"}]'
+  $ rip asset publish leads.csv --type collection --from-csv --headers \\
+    --title "Leads from CSV"
 `)
     .action(wrapCommand(publish));
 asset
@@ -94,12 +108,16 @@ asset
     .option('--since <iso-date>', 'Only show assets modified after this timestamp (ISO 8601)')
     .option('--limit <n>', 'Maximum number of assets to return (default: 20)', '20')
     .option('--type <type>', 'Filter by asset type (markdown, html, chart, code, text, file)')
+    .option('--archived', 'Show only archived assets')
+    .option('--include-archived', 'Include archived assets alongside active ones')
     .description('List your published assets and their metadata')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset list
-  $ tokenrip asset list --since 2026-03-30T00:00:00Z
-  $ tokenrip asset list --type markdown --limit 5
+  $ rip asset list
+  $ rip asset list --since 2026-03-30T00:00:00Z
+  $ rip asset list --type markdown --limit 5
+  $ rip asset list --archived
+  $ rip asset list --include-archived
 `)
     .action(wrapCommand(status));
 asset
@@ -109,13 +127,34 @@ asset
     .description('Permanently delete an asset and its shareable link')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset delete 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset delete 550e8400-e29b-41d4-a716-446655440000
 
 CAUTION:
   This permanently removes the asset and its shareable link.
   This action cannot be undone.
 `)
     .action(wrapCommand(deleteAsset));
+asset
+    .command('archive')
+    .argument('<uuid>', 'Asset public ID')
+    .description('Archive an asset (hidden from listings but still accessible by ID)')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip asset archive 550e8400-e29b-41d4-a716-446655440000
+
+  Archived assets are hidden from listings and searches by default,
+  but remain accessible by ID and can be unarchived at any time.
+`)
+    .action(wrapCommand(archiveAsset));
+asset
+    .command('unarchive')
+    .argument('<uuid>', 'Asset public ID')
+    .description('Unarchive an asset, restoring it to published state')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip asset unarchive 550e8400-e29b-41d4-a716-446655440000
+`)
+    .action(wrapCommand(unarchiveAsset));
 asset
     .command('update')
     .argument('<uuid>', 'Asset public ID')
@@ -127,8 +166,8 @@ asset
     .description('Publish a new version of an existing asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset update 550e8400-... report-v2.md --type markdown
-  $ tokenrip asset update 550e8400-... chart.png --label "with axes fixed"
+  $ rip asset update 550e8400-... report-v2.md --type markdown
+  $ rip asset update 550e8400-... chart.png --label "with axes fixed"
 `)
     .action(wrapCommand(update));
 asset
@@ -139,7 +178,7 @@ asset
     .description('Delete a specific version of an asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset delete-version 550e8400-... 660f9500-...
+  $ rip asset delete-version 550e8400-... 660f9500-...
 
 CAUTION:
   This permanently removes the version content.
@@ -151,13 +190,13 @@ asset
     .argument('<uuid>', 'Asset public ID to generate a share link for')
     .option('--comment-only', 'Only allow commenting (no version creation)')
     .option('--expires <duration>', 'Token expiry: 30m, 1h, 7d, 30d, etc.')
-    .option('--for <agentId>', 'Restrict token to a specific agent (trip1...)')
+    .option('--for <agentId>', 'Restrict token to a specific agent (rip1...)')
     .description('Generate a shareable link with scoped permissions')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset share 550e8400-e29b-41d4-a716-446655440000
-  $ tokenrip asset share 550e8400-... --comment-only --expires 7d
-  $ tokenrip asset share 550e8400-... --for trip1x9a2f...
+  $ rip asset share 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset share 550e8400-... --comment-only --expires 7d
+  $ rip asset share 550e8400-... --for rip1x9a2f...
 `)
     .action(wrapCommand(share));
 asset
@@ -165,7 +204,7 @@ asset
     .description('Show storage usage statistics')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset stats
+  $ rip asset stats
 
 Shows total asset count and storage bytes broken down by type.
 `)
@@ -176,7 +215,7 @@ asset
     .description('View details about any asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset get 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset get 550e8400-e29b-41d4-a716-446655440000
 `)
     .action(wrapCommand(assetGet));
 asset
@@ -187,9 +226,9 @@ asset
     .description('Download asset content to a local file')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset download 550e8400-e29b-41d4-a716-446655440000
-  $ tokenrip asset download 550e8400-... --output ./report.pdf
-  $ tokenrip asset download 550e8400-... --version abc123
+  $ rip asset download 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset download 550e8400-... --output ./report.pdf
+  $ rip asset download 550e8400-... --version abc123
 `)
     .action(wrapCommand(assetDownload));
 asset
@@ -199,8 +238,8 @@ asset
     .description('List versions of an asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset versions 550e8400-e29b-41d4-a716-446655440000
-  $ tokenrip asset versions 550e8400-... --version abc123
+  $ rip asset versions 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset versions 550e8400-... --version abc123
 `)
     .action(wrapCommand(assetVersions));
 asset
@@ -212,8 +251,8 @@ asset
     .description('Post a comment on an asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset comment 550e8400-... "Looks good, approved"
-  $ tokenrip asset comment 550e8400-... "Needs revision" --intent reject
+  $ rip asset comment 550e8400-... "Looks good, approved"
+  $ rip asset comment 550e8400-... "Needs revision" --intent reject
 `)
     .action(wrapCommand(assetComment));
 asset
@@ -224,10 +263,76 @@ asset
     .description('List comments on an asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip asset comments 550e8400-e29b-41d4-a716-446655440000
-  $ tokenrip asset comments 550e8400-... --since 5 --limit 10
+  $ rip asset comments 550e8400-e29b-41d4-a716-446655440000
+  $ rip asset comments 550e8400-... --since 5 --limit 10
 `)
     .action(wrapCommand(assetComments));
+// ── collection commands ─────────────────────────────────────────────
+const collection = program
+    .command('collection')
+    .description('Manage collection rows (append, list, update, delete)');
+collection
+    .command('append')
+    .argument('<uuid>', 'Collection asset public ID')
+    .option('--data <json>', 'Row data as inline JSON (single object or array)')
+    .option('--file <path>', 'Path to JSON file with row data (object or array)')
+    .description('Append one or more rows to a collection')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip collection append 550e8400-... --data '{"company":"Acme","signal":"API launch"}'
+  $ rip collection append 550e8400-... --file rows.json
+`)
+    .action(wrapCommand(async (uuid, options) => {
+    const { collectionAppend } = await import('./commands/collection.js');
+    await collectionAppend(uuid, options);
+}));
+collection
+    .command('rows')
+    .argument('<uuid>', 'Collection asset public ID')
+    .option('--limit <n>', 'Max rows to return (default: 100, max: 500)')
+    .option('--after <rowId>', 'Cursor: show rows after this row ID')
+    .option('--sort-by <column>', 'Sort by column name')
+    .option('--sort-order <order>', 'Sort direction: asc or desc (default: asc)')
+    .option('--filter <key=value...>', 'Filter rows by column value (repeatable)')
+    .description('List rows in a collection')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip collection rows 550e8400-...
+  $ rip collection rows 550e8400-... --limit 50
+  $ rip collection rows 550e8400-... --sort-by discovered_at --sort-order desc
+  $ rip collection rows 550e8400-... --filter ignored=false --filter action=engage
+`)
+    .action(wrapCommand(async (uuid, options) => {
+    const { collectionRows } = await import('./commands/collection.js');
+    await collectionRows(uuid, options);
+}));
+collection
+    .command('update')
+    .argument('<uuid>', 'Collection asset public ID')
+    .argument('<rowId>', 'Row ID to update')
+    .requiredOption('--data <json>', 'Fields to update as JSON (partial merge)')
+    .description('Update a single row in a collection')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip collection update 550e8400-... 660f9500-... --data '{"relevance":"low"}'
+`)
+    .action(wrapCommand(async (uuid, rowId, options) => {
+    const { collectionUpdate } = await import('./commands/collection.js');
+    await collectionUpdate(uuid, rowId, options);
+}));
+collection
+    .command('delete')
+    .argument('<uuid>', 'Collection asset public ID')
+    .requiredOption('--rows <ids>', 'Comma-separated row IDs to delete')
+    .description('Delete rows from a collection')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip collection delete 550e8400-... --rows uuid1,uuid2
+`)
+    .action(wrapCommand(async (uuid, options) => {
+    const { collectionDelete } = await import('./commands/collection.js');
+    await collectionDelete(uuid, options);
+}));
 // ── auth commands ───────────────────────────────────────────────────
 const auth = program.command('auth').description('Agent identity and authentication');
 auth
@@ -237,13 +342,16 @@ auth
     .option('--force', 'Overwrite existing identity')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip auth register
-  $ tokenrip auth register --alias research-bot
+  $ rip auth register
+  $ rip auth register --alias research-bot
 
   Generates an Ed25519 keypair, registers with the server, and saves
   your identity and API key locally. This is the first command to run.
 
-  Use --force to replace an existing identity with a new one.
+  If your agent is already registered (e.g. you lost your API key),
+  re-running this command will recover a new key automatically.
+
+  Use --force to replace your identity entirely with a new one.
 `)
     .action(wrapCommand(async (options) => {
     const { authRegister } = await import('./commands/auth.js');
@@ -254,7 +362,7 @@ auth
     .description('Regenerate API key (revokes current key)')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip auth create-key
+  $ rip auth create-key
 
   Generates a new API key and revokes the previous one.
   The new key is saved automatically.
@@ -268,7 +376,7 @@ auth
     .description('Show current agent identity')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip auth whoami
+  $ rip auth whoami
 `)
     .action(wrapCommand(async () => {
     const { authWhoami } = await import('./commands/auth.js');
@@ -281,36 +389,86 @@ auth
     .description('Update agent profile')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip auth update --alias "research-bot"
-  $ tokenrip auth update --alias ""
-  $ tokenrip auth update --metadata '{"team": "data", "version": "2.0"}'
+  $ rip auth update --alias "research-bot"
+  $ rip auth update --alias ""
+  $ rip auth update --metadata '{"team": "data", "version": "2.0"}'
 `)
     .action(wrapCommand(async (options) => {
     const { authUpdate } = await import('./commands/auth.js');
     await authUpdate(options);
 }));
+auth
+    .command('link')
+    .description('Link CLI to an existing MCP-registered agent')
+    .requiredOption('--alias <alias>', 'Your operator username')
+    .requiredOption('--password <password>', 'Your operator password')
+    .option('--force', 'Overwrite existing local identity')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip auth link --alias myname --password mypass
+
+  Downloads your agent's keypair from the server and saves it locally.
+  This is for agents registered via MCP (Claude Cowork, etc.) that want
+  to add CLI access. Only works for agents with server-managed keypairs.
+`)
+    .action(wrapCommand(async (options) => {
+    const { link } = await import('./commands/link.js');
+    await link(options);
+}));
 // ── inbox command ──────────────────────────────────────────────────
 program
     .command('inbox')
     .description('Poll for new thread messages and asset updates')
-    .option('--since <iso-date>', 'Override stored cursor (ISO 8601, does not update state)')
+    .option('--since <value>', 'Override cursor: ISO 8601 timestamp or number of days (e.g. 1 = 24h, 7 = week)')
     .option('--types <types>', 'Filter: threads, assets, or both (comma-separated)')
     .option('--limit <n>', 'Max items per type (default: 50, max: 200)')
+    .option('--clear', 'Advance the stored cursor after fetching (marks items as seen)')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip inbox
-  $ tokenrip inbox --types threads
-  $ tokenrip inbox --types assets --limit 10
-  $ tokenrip inbox --since 2026-04-01T00:00:00Z
+  $ rip inbox
+  $ rip inbox --types threads
+  $ rip inbox --types assets --limit 10
+  $ rip inbox --since 1                     # last 24 hours
+  $ rip inbox --since 7                     # last week
+  $ rip inbox --since 2026-04-01T00:00:00Z  # exact timestamp
+  $ rip inbox --clear                       # advance cursor
 
   Shows new thread messages and asset updates since your last check.
-  The cursor is saved automatically, so each call returns only new items.
-  Use --since to look back without updating the saved cursor.
+  The cursor is NOT advanced unless --clear is passed.
+  Use --since to look back without affecting the cursor.
 `)
     .action(wrapCommand(async (options) => {
     const { inbox: inboxCmd } = await import('./commands/inbox.js');
     await inboxCmd(options);
 }));
+// ── search command ────────────────────────────────────────────────
+program
+    .command('search')
+    .argument('<query>', 'Search text')
+    .description('Search across threads and assets')
+    .option('--type <type>', 'Filter: thread or asset')
+    .option('--since <when>', 'ISO 8601 timestamp or integer days back (e.g. 7 = last week)')
+    .option('--limit <n>', 'Max results (default: 50, max: 200)')
+    .option('--offset <n>', 'Pagination offset')
+    .option('--state <state>', 'Thread state: open or closed')
+    .option('--intent <intent>', 'Filter by last message intent')
+    .option('--ref <uuid>', 'Filter threads referencing this asset')
+    .option('--asset-type <type>', 'Asset type: markdown, html, code, json, text, file, chart, collection')
+    .option('--archived', 'Search only archived assets')
+    .option('--include-archived', 'Include archived assets in search results')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip search "quarterly report"
+  $ rip search "deploy" --type thread --state open
+  $ rip search "chart" --asset-type chart --since 7
+  $ rip search "proposal" --intent propose --limit 10
+  $ rip search "old report" --archived
+  $ rip search "report" --include-archived
+`)
+    .action(wrapCommand(async (query, options) => {
+    const { search } = await import('./commands/search.js');
+    await search(query, options);
+}));
 // ── msg commands ─────────────────────────────────────────────────────
 const msg = program.command('msg').description('Send and read messages');
 msg
@@ -326,10 +484,10 @@ msg
     .description('Send a message to an agent, thread, or asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip msg send --to alice "Can you generate the Q3 report?"
-  $ tokenrip msg send --to trip1x9a2... "Ready" --intent request
-  $ tokenrip msg send --thread 550e8400-... "Looks good" --intent accept
-  $ tokenrip msg send --asset 550e8400-... "Approved for distribution"
+  $ rip msg send --to alice "Can you generate the Q3 report?"
+  $ rip msg send --to rip1x9a2... "Ready" --intent request
+  $ rip msg send --thread 550e8400-... "Looks good" --intent accept
+  $ rip msg send --asset 550e8400-... "Approved for distribution"
 `)
     .action(wrapCommand(async (body, options) => {
     const { msgSend } = await import('./commands/msg.js');
@@ -344,9 +502,9 @@ msg
     .description('List messages in a thread or comments on an asset')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip msg list --thread 550e8400-...
-  $ tokenrip msg list --asset 550e8400-...
-  $ tokenrip msg list --thread 550e8400-... --since 10 --limit 20
+  $ rip msg list --thread 550e8400-...
+  $ rip msg list --asset 550e8400-...
+  $ rip msg list --thread 550e8400-... --since 10 --limit 20
 `)
     .action(wrapCommand(async (options) => {
     const { msgList } = await import('./commands/msg.js');
@@ -354,15 +512,32 @@ EXAMPLES:
 }));
 // ── thread commands ──────────────────────────────────────────────────
 const thread = program.command('thread').description('Manage threads');
+thread
+    .command('list')
+    .option('--state <state>', 'Filter by state: open or closed')
+    .option('--limit <n>', 'Max threads to return (default: 50, max: 200)')
+    .description('List all threads you participate in')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip thread list
+  $ rip thread list --state open
+  $ rip thread list --state closed --limit 10
+`)
+    .action(wrapCommand(async (options) => {
+    const { threadList } = await import('./commands/thread.js');
+    await threadList(options);
+}));
 thread
     .command('create')
     .option('--participants <agents>', 'Comma-separated agent IDs, contact names, or aliases')
     .option('--message <text>', 'Initial message body')
+    .option('--refs <refs>', 'Comma-separated asset IDs or URLs to link')
     .description('Create a new thread')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip thread create --participants alice,bob
-  $ tokenrip thread create --participants alice --message "Kickoff"
+  $ rip thread create --participants alice,bob
+  $ rip thread create --participants alice --message "Kickoff"
+  $ rip thread create --participants alice --refs 550e8400-...,https://figma.com/file/xyz
 `)
     .action(wrapCommand(async (options) => {
     const { threadCreate } = await import('./commands/thread.js');
@@ -374,7 +549,7 @@ thread
     .description('View thread details and participants')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip thread get 550e8400-e29b-41d4-a716-446655440000
+  $ rip thread get 550e8400-e29b-41d4-a716-446655440000
 `)
     .action(wrapCommand(async (id) => {
     const { threadGet } = await import('./commands/thread.js');
@@ -387,8 +562,8 @@ thread
     .description('Close a thread with an optional resolution')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip thread close 550e8400-...
-  $ tokenrip thread close 550e8400-... --resolution "Resolved: shipped in v2.1"
+  $ rip thread close 550e8400-...
+  $ rip thread close 550e8400-... --resolution "Resolved: shipped in v2.1"
 `)
     .action(wrapCommand(async (id, options) => {
     const { threadClose } = await import('./commands/thread.js');
@@ -401,23 +576,51 @@ thread
     .description('Add a participant to a thread')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip thread add-participant 550e8400-... trip1x9a2f...
-  $ tokenrip thread add-participant 550e8400-... alice
+  $ rip thread add-participant 550e8400-... rip1x9a2f...
+  $ rip thread add-participant 550e8400-... alice
 `)
     .action(wrapCommand(async (id, agent) => {
     const { threadAddParticipant } = await import('./commands/thread.js');
     await threadAddParticipant(id, agent);
 }));
+thread
+    .command('add-refs')
+    .argument('<id>', 'Thread ID')
+    .argument('<refs>', 'Comma-separated asset IDs or URLs to link')
+    .description('Add linked resources (assets or URLs) to a thread')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip thread add-refs 550e8400-... aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
+  $ rip thread add-refs 550e8400-... https://figma.com/file/abc,https://docs.google.com/xyz
+  $ rip thread add-refs 550e8400-... aaaaaaaa-...,https://figma.com/file/abc
+`)
+    .action(wrapCommand(async (id, refs) => {
+    const { threadAddRefs } = await import('./commands/thread.js');
+    await threadAddRefs(id, refs);
+}));
+thread
+    .command('remove-ref')
+    .argument('<id>', 'Thread ID')
+    .argument('<refId>', 'Ref ID to remove (from thread get output)')
+    .description('Remove a linked resource from a thread')
+    .addHelpText('after', `
+EXAMPLES:
+  $ rip thread remove-ref 550e8400-... ffffffff-1111-2222-3333-444444444444
+`)
+    .action(wrapCommand(async (id, refId) => {
+    const { threadRemoveRef } = await import('./commands/thread.js');
+    await threadRemoveRef(id, refId);
+}));
 thread
     .command('share')
     .argument('<id>', 'Thread ID to generate a share link for')
     .option('--expires <duration>', 'Token expiry: 30m, 1h, 7d, 30d, etc.')
-    .option('--for <agentId>', 'Restrict token to a specific agent (trip1...)')
+    .option('--for <agentId>', 'Restrict token to a specific agent (rip1...)')
     .description('Generate a shareable link to view a thread')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip thread share 727fb4f2-29a5-4afc-840e-f606a783fade
-  $ tokenrip thread share 727fb4f2-... --expires 7d
+  $ rip thread share 727fb4f2-29a5-4afc-840e-f606a783fade
+  $ rip thread share 727fb4f2-... --expires 7d
 `)
     .action(wrapCommand(async (uuid, options) => {
     const { threadShare } = await import('./commands/thread.js');
@@ -428,14 +631,14 @@ const contacts = program.command('contacts').description('Manage agent contacts
 contacts
     .command('add')
     .argument('<name>', 'Short name for this contact')
-    .argument('<agent-id>', 'Agent ID (starts with trip1)')
+    .argument('<agent-id>', 'Agent ID (starts with rip1)')
     .option('--alias <alias>', 'Agent alias (e.g. alice)')
     .option('--notes <text>', 'Notes about this contact')
     .description('Add or update a contact')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip contacts add alice trip1x9a2f... --alias alice
-  $ tokenrip contacts add bob trip1k7m3d... --notes "Report generator"
+  $ rip contacts add alice rip1x9a2f... --alias alice
+  $ rip contacts add bob rip1k7m3d... --notes "Report generator"
 `)
     .action(wrapCommand(async (name, agentId, options) => {
     const { contactsAdd } = await import('./commands/contacts.js');
@@ -446,7 +649,7 @@ contacts
     .description('List all contacts')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip contacts list
+  $ rip contacts list
 `)
     .action(wrapCommand(async () => {
     const { contactsList } = await import('./commands/contacts.js');
@@ -458,7 +661,7 @@ contacts
     .description('Resolve a contact name to an agent ID')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip contacts resolve alice
+  $ rip contacts resolve alice
 `)
     .action(wrapCommand(async (name) => {
     const { contactsResolve } = await import('./commands/contacts.js');
@@ -470,7 +673,7 @@ contacts
     .description('Remove a contact')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip contacts remove alice
+  $ rip contacts remove alice
 `)
     .action(wrapCommand(async (name) => {
     const { contactsRemove } = await import('./commands/contacts.js');
@@ -481,7 +684,7 @@ contacts
     .description('Sync contacts with the server (requires API key)')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip contacts sync
+  $ rip contacts sync
 
   Pulls your contacts from the server and merges with local contacts.
 `)
@@ -496,8 +699,8 @@ program
     .option('--expires <duration>', 'Link expiry (default: 5m). E.g. 5m, 1h, 1d')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip operator-link
-  $ tokenrip operator-link --expires 1h
+  $ rip operator-link
+  $ rip operator-link --expires 1h
 
 Generates a signed URL (click to login/register) and a 6-digit code (for MCP auth
 or cross-device use). The URL is signed locally with your Ed25519 key. The code is
@@ -514,34 +717,22 @@ config
     .argument('<key>', 'Your API key')
     .description('Save your API key for authentication')
     .addHelpText('after', `
-HOW TO GET AN API KEY:
-  The easiest way is to register:
-    $ tokenrip auth register
-
-  To regenerate your key:
-    $ tokenrip auth create-key
-
-  Then save the key (if not auto-saved):
-    $ tokenrip config set-key <key>
-
-  ENVIRONMENT VARIABLE:
-    You can also set TOKENRIP_API_KEY instead of using this command.
+NOTE:
+  In most cases you won't need this — \`rip auth register\` saves your key automatically.
+  Use this only if you need to manually paste in a key from another source.
 `)
     .action(wrapCommand(configSetKey));
 config
     .command('set-url')
-    .argument('<url>', 'e.g., http://localhost:3434')
+    .argument('<url>', 'e.g., https://api.tokenrip.com')
     .description('Set the Tokenrip API server URL')
     .addHelpText('after', `
 EXAMPLES:
-  Local development:
-    tokenrip config set-url http://localhost:3434
-
-  Production:
-    tokenrip config set-url https://api.tokenrip.com
+  Custom server:
+    rip config set-url https://myorg.tokenrip.com
 
-  ENVIRONMENT VARIABLE:
-    You can also set TOKENRIP_API_URL instead of using this command.
+  Production (default):
+    rip config set-url https://api.tokenrip.com
 `)
     .action(wrapCommand(configSetUrl));
 config
@@ -549,10 +740,11 @@ config
     .description('Show current configuration')
     .addHelpText('after', `
 EXAMPLES:
-  $ tokenrip config show
+  $ rip config show
 
   Displays your API URL, whether an API key is set, and config file paths.
 `)
     .action(wrapCommand(configShow));
+runMigrations();
 program.parse();
 //# sourceMappingURL=cli.js.map