@indexnetwork/cli 0.8.1 → 0.9.1

package/README.md

@@ -73,6 +73,9 @@ View user profiles and trigger profile regeneration.
 index profile                       # Show your own profile
 index profile show <user-id>        # Show another user's profile
 index profile sync                  # Regenerate your profile
+index profile search <query>        # Search profiles by name or keyword
+index profile create                # Generate profile from social links
+index profile update <details>      # Update profile details
 ```
 
 ### `index intent`
@@ -85,7 +88,11 @@ index intent list --archived                # Include archived signals
 index intent list --limit 5                 # Limit to 5 results
 index intent show <id>                      # Show full signal details
 index intent create "Looking for a CTO"     # Create from natural language
+index intent update <id> "revised text"     # Update a signal (runs full pipeline)
 index intent archive <id>                   # Archive a signal
+index intent link <id> <network-id>         # Link a signal to a network
+index intent unlink <id> <network-id>       # Unlink a signal from a network
+index intent links <id>                     # List networks linked to a signal
 ```
 
 ### `index opportunity`
@@ -99,6 +106,9 @@ index opportunity list --limit 5           # Limit results
 index opportunity show <id>                # Show full details
 index opportunity accept <id>              # Accept an opportunity
 index opportunity reject <id>              # Reject an opportunity
+index opportunity discover "query"         # Discover opportunities by search
+index opportunity discover --target <id>   # Discover with a specific user
+index opportunity discover --introduce <a> <b>  # Introduce two users
 ```
 
 Status values: `pending`, `accepted`, `rejected`, `expired`.
@@ -112,11 +122,101 @@ index network list                     # List your networks
 index network create "My Network"      # Create a network
 index network create "AI" --prompt "AI researchers"  # Create with description
 index network show <id>                # Show details and members
+index network update <id> --title "New Name"  # Update a network
+index network delete <id>              # Delete a network
 index network join <id>                # Join a public network
 index network leave <id>               # Leave a network
 index network invite <id> user@email   # Invite a user by email
 ```
 
+### `index contact`
+
+Manage your contacts. Add, list, remove, or import contacts.
+
+```bash
+index contact list                     # List your contacts
+index contact add user@email           # Add a contact by email
+index contact add user@email --name "Name"  # Add with display name
+index contact remove user@email        # Remove a contact
+index contact import --gmail           # Import contacts from Gmail
+```
+
+### `index scrape`
+
+Scrape and extract content from a URL.
+
+```bash
+index scrape https://example.com                    # Scrape a URL
+index scrape https://example.com --objective "..."   # Scrape with focus
+```
+
+### `index sync`
+
+Sync all user context (profile, networks, intents, contacts) to a local file.
+
+```bash
+index sync                             # Sync to ~/.index/context.json
+index sync --json                      # Output to stdout as JSON
+```
+
+## Examples: Opportunity Discovery
+
+The `opportunity discover` command supports multiple modes for creating connections.
+
+### Scenario 1: Search-based discovery
+
+Find people whose intents match a search query. The protocol runs HyDE-powered semantic search across your networks.
+
+```bash
+# Find collaborators for a project
+index opportunity discover "looking for an AI engineer with privacy expertise"
+
+# Scope discovery to a specific network
+index opportunity discover "need a React developer" --target <network-id>
+```
+
+### Scenario 2: Direct connection
+
+Propose an opportunity with a specific person. Use when you already know who you want to connect with.
+
+```bash
+# First, find the user
+index profile search "Jane Smith"
+
+# Then create a direct opportunity with them
+index opportunity discover "collaborate on open-source LLM tooling" --target <user-id>
+```
+
+### Scenario 3: Introduction
+
+Introduce two people you think should connect. You become the introducer — both parties see you as the connector. The CLI automatically finds shared networks, gathers profiles and intents, then creates the introduction.
+
+```bash
+# Introduce two users to each other
+index opportunity discover --introduce <user-id-a> <user-id-b>
+
+# Provide a reason for the introduction
+index opportunity discover --introduce <user-id-a> <user-id-b> "both working on privacy-preserving ML"
+```
+
+### Scenario 4: Review and act
+
+After discovery creates draft opportunities, review and accept/reject them.
+
+```bash
+# List pending opportunities
+index opportunity list --status pending
+
+# See full details (reasoning, scores, mutual intents)
+index opportunity show <id>
+
+# Accept — starts a conversation thread
+index opportunity accept <id>
+
+# Or reject
+index opportunity reject <id>
+```
+
 ## Options
 
 | Flag | Short | Description |
@@ -129,6 +229,13 @@ index network invite <id> user@email   # Invite a user by email
 | `--status <status>` | | Filter opportunities by status |
 | `--limit <n>` | | Limit number of results |
 | `--prompt <text>` | `-p` | Network description (for `network create`) |
+| `--title <text>` | | Network title (for `network update`) |
+| `--name <name>` | | Display name (for `contact add`) |
+| `--gmail` | | Import from Gmail (for `contact import`) |
+| `--target <id>` | | Target user ID (for `opportunity discover`) |
+| `--introduce <id>` | | Introduce two users (for `opportunity discover`) |
+| `--objective <text>` | | Focus objective (for `scrape`) |
+| `--json` | | Output raw JSON to stdout |
 | `--help` | `-h` | Show help |
 | `--version` | `-v` | Show version |
 
@@ -170,6 +277,9 @@ cli/
     intent.command.ts          Intent (signal) subcommand handlers
     opportunity.command.ts     Opportunity subcommand handlers
     network.command.ts         Network subcommand handlers
+    contact.command.ts         Contact subcommand handlers
+    scrape.command.ts          URL scraping command handler
+    sync.command.ts            Context sync command handler
     output/                    Terminal formatting, colors, markdown renderer
     api.client.ts              Typed HTTP client for the protocol API
     auth.store.ts              Credential persistence (~/.index/credentials.json)

package/dist/index.js

@@ -4,9 +4,9 @@
 import { execFile } from "node:child_process";
 
 // src/args.parser.ts
-var KNOWN_COMMANDS = new Set(["login", "logout", "profile", "intent", "opportunity", "network", "conversation", "help", "version"]);
-var OPPORTUNITY_SUBCOMMANDS = new Set(["list", "show", "accept", "reject"]);
-var NETWORK_SUBCOMMANDS = new Set(["list", "create", "show", "join", "leave", "invite"]);
+var KNOWN_COMMANDS = new Set(["login", "logout", "profile", "intent", "opportunity", "network", "conversation", "contact", "scrape", "onboarding", "sync", "help", "version"]);
+var OPPORTUNITY_SUBCOMMANDS = new Set(["list", "show", "accept", "reject", "discover"]);
+var NETWORK_SUBCOMMANDS = new Set(["list", "create", "show", "join", "leave", "invite", "update", "delete"]);
 var CONVERSATION_SUBCOMMANDS = new Set(["list", "with", "show", "send", "stream", "sessions", "help"]);
 function parseArgs(args) {
   const result = {
@@ -62,6 +62,39 @@ function parseArgs(args) {
     } else if (arg === "--prompt" || arg === "-p") {
       result.prompt = args[i + 1];
       i += 2;
+    } else if (arg === "--json") {
+      result.json = true;
+      i++;
+    } else if (arg === "--name") {
+      result.name = args[i + 1];
+      i += 2;
+    } else if (arg === "--gmail") {
+      result.gmail = true;
+      i++;
+    } else if (arg === "--objective") {
+      result.objective = args[i + 1];
+      i += 2;
+    } else if (arg === "--target") {
+      result.target = args[i + 1];
+      i += 2;
+    } else if (arg === "--introduce") {
+      result.introduce = args[i + 1];
+      i += 2;
+    } else if (arg === "--linkedin") {
+      result.linkedin = args[i + 1];
+      i += 2;
+    } else if (arg === "--github") {
+      result.github = args[i + 1];
+      i += 2;
+    } else if (arg === "--twitter") {
+      result.twitter = args[i + 1];
+      i += 2;
+    } else if (arg === "--title") {
+      result.title = args[i + 1];
+      i += 2;
+    } else if (arg === "--details") {
+      result.details = args[i + 1];
+      i += 2;
     } else if (arg.startsWith("--")) {
       i++;
     } else {
@@ -73,7 +106,9 @@ function parseArgs(args) {
     const sub = positionals[0];
     if (sub && OPPORTUNITY_SUBCOMMANDS.has(sub)) {
       result.subcommand = sub;
-      if (positionals[1]) {
+      if (sub === "discover") {
+        result.positionals = positionals.slice(1);
+      } else if (positionals[1]) {
         result.targetId = positionals[1];
       }
     }
@@ -88,8 +123,34 @@ function parseArgs(args) {
       }
     } else if (sub === "sync") {
       result.subcommand = "sync";
+    } else if (sub === "search") {
+      result.subcommand = "search";
+      result.positionals = positionals.slice(1);
+    } else if (sub === "create") {
+      result.subcommand = "create";
+    } else if (sub === "update") {
+      result.subcommand = "update";
+      result.positionals = positionals.slice(1);
     }
   }
+  if (result.command === "onboarding" && positionals.length > 0) {
+    const sub = positionals[0];
+    if (sub === "complete") {
+      result.subcommand = "complete";
+    }
+  }
+  if (result.command === "contact") {
+    if (positionals.length > 0) {
+      const sub = positionals[0];
+      if (["list", "add", "remove", "import"].includes(sub)) {
+        result.subcommand = sub;
+        result.positionals = positionals.slice(1);
+      }
+    }
+  }
+  if (result.command === "scrape") {
+    result.positionals = positionals;
+  }
   if (result.command === "intent") {
     parseIntentArgs(positionals, result);
   }
@@ -111,7 +172,7 @@ function parseArgs(args) {
   }
   return result;
 }
-var INTENT_SUBCOMMANDS = new Set(["list", "show", "create", "archive"]);
+var INTENT_SUBCOMMANDS = new Set(["list", "show", "create", "archive", "update", "link", "unlink", "links"]);
 function parseIntentArgs(positionals, result) {
   if (positionals.length === 0)
     return;
@@ -123,6 +184,7 @@ function parseIntentArgs(positionals, result) {
   switch (result.subcommand) {
     case "show":
     case "archive":
+    case "links":
       result.intentId = rest[0];
       break;
     case "create":
@@ -130,6 +192,17 @@ function parseIntentArgs(positionals, result) {
         result.intentContent = rest.join(" ");
       }
       break;
+    case "update":
+      result.intentId = rest[0];
+      if (rest.length > 1) {
+        result.intentContent = rest.slice(1).join(" ");
+      }
+      break;
+    case "link":
+    case "unlink":
+      result.intentId = rest[0];
+      result.targetId = rest[1];
+      break;
   }
 }
 
@@ -354,6 +427,10 @@ class ApiClient {
     }
     return res;
   }
+  async callTool(toolName, query = {}) {
+    const res = await this.post(`/api/tools/${toolName}`, { query });
+    return await res.json();
+  }
   async get(path) {
     const res = await fetch(`${this.baseUrl}${path}`, {
       headers: {
@@ -914,6 +991,19 @@ function profileCard(data) {
   console.log(output);
   return output;
 }
+function contactTable(contacts) {
+  if (contacts.length === 0) {
+    console.log("  No contacts yet.");
+    return;
+  }
+  const nameWidth = Math.max(6, ...contacts.map((c) => c.name.length));
+  const header = `  ${"Name".padEnd(nameWidth)}  Email`;
+  console.log(`${BOLD}${header}${RESET}`);
+  for (const c of contacts) {
+    const ghost = c.isGhost ? ` ${DIM}(ghost)${RESET}` : "";
+    console.log(`  ${c.name.padEnd(nameWidth)}  ${c.email}${ghost}`);
+  }
+}
 function sessionTable(sessions) {
   if (sessions.length === 0) {
     dim("  No chat sessions found.");
@@ -1262,7 +1352,20 @@ function messageList(messages) {
   }
 }
 // src/profile.command.ts
-async function handleProfile(client, subcommand, positionals) {
+async function handleProfile(client, subcommand, positionals, options = {}) {
+  if (subcommand === "create") {
+    await profileCreate(client, options);
+    return;
+  }
+  if (subcommand === "update") {
+    const action = positionals.join(" ");
+    if (!action) {
+      error("Usage: index profile update <action> [--details <text>]", 1);
+      return;
+    }
+    await profileUpdate(client, action, options.details);
+    return;
+  }
   if (subcommand === "sync") {
     await profileSync(client);
     return;
@@ -1276,6 +1379,35 @@ async function handleProfile(client, subcommand, positionals) {
     await profileShow(client, userId);
     return;
   }
+  if (subcommand === "search") {
+    const query = positionals.join(" ");
+    if (!query) {
+      error("Usage: index profile search <query>", 1);
+      return;
+    }
+    const result = await client.callTool("read_user_profiles", { query });
+    if (options.json) {
+      console.log(JSON.stringify(result));
+      return;
+    }
+    if (!result.success) {
+      error(result.error ?? "Search failed", 1);
+      return;
+    }
+    const data = result.data;
+    heading("Search Results");
+    if (!data.profiles?.length) {
+      dim("  No profiles found.");
+    } else {
+      for (const p of data.profiles) {
+        console.log(`  ${p.name} (${p.userId.slice(0, 8)})`);
+        if (p.profile?.bio)
+          dim(`    ${p.profile.bio.slice(0, 100)}`);
+      }
+    }
+    console.log();
+    return;
+  }
   await profileMe(client);
 }
 async function profileMe(client) {
@@ -1294,6 +1426,34 @@ async function profileSync(client) {
   await client.syncProfile();
   success("Profile regeneration triggered. It may take a moment to complete.");
 }
+async function profileCreate(client, options) {
+  info("Creating profile...");
+  const query = { confirm: true };
+  if (options.linkedin)
+    query.linkedinUrl = options.linkedin;
+  if (options.github)
+    query.githubUrl = options.github;
+  if (options.twitter)
+    query.twitterUrl = options.twitter;
+  const result = await client.callTool("create_user_profile", query);
+  if (!result.success) {
+    error(result.error ?? "Profile creation failed", 1);
+    return;
+  }
+  success("Profile created.");
+}
+async function profileUpdate(client, action, details) {
+  info("Updating profile...");
+  const query = { action };
+  if (details)
+    query.details = details;
+  const result = await client.callTool("update_user_profile", query);
+  if (!result.success) {
+    error(result.error ?? "Profile update failed", 1);
+    return;
+  }
+  success("Profile updated.");
+}
 
 // src/intent.command.ts
 var INTENT_HELP = `
@@ -1301,11 +1461,19 @@ Usage:
   index intent list [--archived] [--limit <n>]  List your signals
   index intent show <id>                        Show signal details (accepts short ID)
   index intent create <content>                 Create a signal from text
+  index intent update <id> <content>            Update a signal's description
   index intent archive <id>                     Archive a signal (accepts short ID)
+  index intent link <id> <network-id>           Link a signal to a network
+  index intent unlink <id> <network-id>         Unlink a signal from a network
+  index intent links <id>                       Show linked networks for a signal
 `;
 async function handleIntent(client, subcommand, options) {
   if (!subcommand) {
-    console.log(INTENT_HELP);
+    if (options.json) {
+      console.log(JSON.stringify({ error: "No subcommand provided" }));
+    } else {
+      console.log(INTENT_HELP);
+    }
     return;
   }
   switch (subcommand) {
@@ -1314,6 +1482,10 @@ async function handleIntent(client, subcommand, options) {
         archived: options.archived,
         limit: options.limit
       });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
       heading("Signals");
       intentTable(result.intents);
       if (result.pagination.total > 0) {
@@ -1329,6 +1501,10 @@ async function handleIntent(client, subcommand, options) {
         return;
       }
       const intent = await client.getIntent(options.intentId);
+      if (options.json) {
+        console.log(JSON.stringify(intent));
+        return;
+      }
       intentCard(intent);
       return;
     }
@@ -1339,84 +1515,330 @@ async function handleIntent(client, subcommand, options) {
       }
       info("Processing signal...");
       const result = await client.processIntent(options.intentContent);
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
       success("Signal processed successfully.");
       if (result.message) {
         dim(`  ${result.message}`);
       }
       return;
     }
+    case "update": {
+      if (!options.intentId) {
+        error("Missing signal ID. Usage: index intent update <id> <content>", 1);
+        return;
+      }
+      if (!options.intentContent) {
+        error("Missing content. Usage: index intent update <id> <content>", 1);
+        return;
+      }
+      info("Updating signal...");
+      const result = await client.callTool("update_intent", {
+        intentId: options.intentId,
+        newDescription: options.intentContent
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to update signal", 1);
+        return;
+      }
+      success("Signal updated.");
+      return;
+    }
     case "archive": {
       if (!options.intentId) {
         error("Missing signal ID. Usage: index intent archive <id>", 1);
         return;
       }
       await client.archiveIntent(options.intentId);
+      if (options.json) {
+        console.log(JSON.stringify({ success: true }));
+        return;
+      }
       success(`Signal ${options.intentId} archived.`);
       return;
     }
+    case "link": {
+      if (!options.intentId || !options.targetId) {
+        error("Usage: index intent link <intent-id> <network-id>", 1);
+        return;
+      }
+      const result = await client.callTool("create_intent_index", {
+        intentId: options.intentId,
+        indexId: options.targetId
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to link signal", 1);
+        return;
+      }
+      success("Signal linked to network.");
+      return;
+    }
+    case "unlink": {
+      if (!options.intentId || !options.targetId) {
+        error("Usage: index intent unlink <intent-id> <network-id>", 1);
+        return;
+      }
+      const result = await client.callTool("delete_intent_index", {
+        intentId: options.intentId,
+        indexId: options.targetId
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to unlink signal", 1);
+        return;
+      }
+      success("Signal unlinked from network.");
+      return;
+    }
+    case "links": {
+      if (!options.intentId) {
+        error("Missing signal ID. Usage: index intent links <id>", 1);
+        return;
+      }
+      const result = await client.callTool("read_intent_indexes", {
+        intentId: options.intentId
+      });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to read linked networks", 1);
+        return;
+      }
+      const data = result.data;
+      heading("Linked Networks");
+      if (!data.indexes?.length) {
+        dim("  No linked networks.");
+      } else {
+        for (const idx of data.indexes) {
+          const score = idx.relevancyScore !== undefined ? ` (${idx.relevancyScore.toFixed(2)})` : "";
+          console.log(`  ${idx.title} ${DIM}${idx.indexId.slice(0, 8)}${score}${RESET}`);
+        }
+      }
+      console.log();
+      return;
+    }
   }
 }
 
 // src/opportunity.command.ts
 var OPPORTUNITY_HELP = `
 Usage:
-  index opportunity list                List your opportunities
-  index opportunity list --status <s>   Filter by status (pending|accepted|rejected|expired)
-  index opportunity list --limit <n>    Limit results
-  index opportunity show <id>           Show full opportunity details (accepts short ID)
-  index opportunity accept <id>         Accept an opportunity (accepts short ID)
-  index opportunity reject <id>         Reject an opportunity (accepts short ID)
+  index opportunity list                        List your opportunities
+  index opportunity list --status <s>           Filter by status (pending|accepted|rejected|expired)
+  index opportunity list --limit <n>            Limit results
+  index opportunity show <id>                   Show full opportunity details (accepts short ID)
+  index opportunity accept <id>                 Accept an opportunity (accepts short ID)
+  index opportunity reject <id>                 Reject an opportunity (accepts short ID)
+  index opportunity discover <query>            Discover opportunities by search query
+  index opportunity discover --target <uid> <q> Discover for a specific user
+  index opportunity discover --introduce <a> <b> Introduce two users
 `;
 async function handleOpportunity(client, subcommand, options) {
   if (!subcommand) {
-    console.log(OPPORTUNITY_HELP);
+    if (options.json) {
+      console.log(JSON.stringify({ error: "No subcommand provided" }));
+    } else {
+      console.log(OPPORTUNITY_HELP);
+    }
     return;
   }
   switch (subcommand) {
     case "list":
-      await opportunityList(client, options.status, options.limit);
+      await opportunityList(client, options.status, options.limit, options.json);
       return;
     case "show":
       if (!options.targetId) {
         error("Missing opportunity ID. Usage: index opportunity show <id>", 1);
         return;
       }
-      await opportunityShow(client, options.targetId);
+      await opportunityShow(client, options.targetId, options.json);
       return;
     case "accept":
       if (!options.targetId) {
         error("Missing opportunity ID. Usage: index opportunity accept <id>", 1);
         return;
       }
-      await opportunityStatusUpdate(client, options.targetId, "accepted");
+      await opportunityStatusUpdate(client, options.targetId, "accepted", options.json);
       return;
     case "reject":
       if (!options.targetId) {
         error("Missing opportunity ID. Usage: index opportunity reject <id>", 1);
         return;
       }
-      await opportunityStatusUpdate(client, options.targetId, "rejected");
+      await opportunityStatusUpdate(client, options.targetId, "rejected", options.json);
+      return;
+    case "discover": {
+      const query = options.positionals?.join(" ");
+      if (!query && !options.introduce) {
+        error("Usage: index opportunity discover <query>", 1);
+        return;
+      }
+      if (options.introduce) {
+        const userA = options.introduce;
+        const userB = options.positionals?.[0];
+        if (!userB) {
+          error("Usage: index opportunity discover --introduce <userA> <userB>", 1);
+          return;
+        }
+        const hint = options.positionals?.slice(1).join(" ") || undefined;
+        await discoverIntroduction(client, userA, userB, hint, options.json);
+      } else if (options.target) {
+        info("Discovering opportunities...");
+        const result = await client.callTool("create_opportunities", {
+          targetUserId: options.target,
+          searchQuery: query
+        });
+        if (options.json) {
+          console.log(JSON.stringify(result));
+          return;
+        }
+        if (!result.success) {
+          error(result.error ?? "Discovery failed", 1);
+          return;
+        }
+        success("Discovery complete.");
+        const data = result.data;
+        if (data?.message)
+          dim(`  ${data.message}`);
+      } else {
+        info("Discovering opportunities...");
+        const result = await client.callTool("create_opportunities", { searchQuery: query });
+        if (options.json) {
+          console.log(JSON.stringify(result));
+          return;
+        }
+        if (!result.success) {
+          error(result.error ?? "Discovery failed", 1);
+          return;
+        }
+        success("Discovery complete.");
+        const data = result.data;
+        if (data?.message)
+          dim(`  ${data.message}`);
+      }
       return;
+    }
     default:
       error(`Unknown subcommand: ${subcommand}`, 1);
       return;
   }
 }
-async function opportunityList(client, status2, limit) {
+async function opportunityList(client, status2, limit, json) {
   const opportunities = await client.listOpportunities({ status: status2, limit });
+  if (json) {
+    console.log(JSON.stringify(opportunities));
+    return;
+  }
   heading("Opportunities");
   opportunityTable(opportunities);
   console.log();
 }
-async function opportunityShow(client, id) {
+async function opportunityShow(client, id, json) {
   const opportunity = await client.getOpportunity(id);
+  if (json) {
+    console.log(JSON.stringify(opportunity));
+    return;
+  }
   opportunityCard(opportunity);
 }
-async function opportunityStatusUpdate(client, id, status2) {
-  await client.updateOpportunityStatus(id, status2);
+async function opportunityStatusUpdate(client, id, status2, json) {
+  const result = await client.updateOpportunityStatus(id, status2);
+  if (json) {
+    console.log(JSON.stringify(result));
+    return;
+  }
   const label = status2 === "accepted" ? "accepted" : "rejected";
   success(`Opportunity ${label}.`);
 }
+async function discoverIntroduction(client, userA, userB, hint, json) {
+  info("Gathering data for introduction...");
+  const [membershipsA, membershipsB] = await Promise.all([
+    client.callTool("read_index_memberships", { userId: userA }),
+    client.callTool("read_index_memberships", { userId: userB })
+  ]);
+  if (!membershipsA.success || !membershipsB.success) {
+    const err = membershipsA.error ?? membershipsB.error ?? "Failed to read memberships";
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: err }));
+      return;
+    }
+    error(err, 1);
+    return;
+  }
+  const indexesA = membershipsA.data?.memberships ?? membershipsA.data?.indexes ?? [];
+  const indexesB = membershipsB.data?.memberships ?? membershipsB.data?.indexes ?? [];
+  const idsA = new Set(indexesA.map((m) => m.indexId));
+  const shared = indexesB.filter((m) => idsA.has(m.indexId));
+  if (shared.length === 0) {
+    const err = "No shared indexes found between these users. They must be members of at least one common network.";
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: err }));
+      return;
+    }
+    error(err, 1);
+    return;
+  }
+  const sharedIndexId = shared[0].indexId;
+  dim(`  Found shared network: ${sharedIndexId}`);
+  const [profileA, profileB, intentsA, intentsB] = await Promise.all([
+    client.callTool("read_user_profiles", { userId: userA }),
+    client.callTool("read_user_profiles", { userId: userB }),
+    client.callTool("read_intents", { userId: userA, indexId: sharedIndexId }),
+    client.callTool("read_intents", { userId: userB, indexId: sharedIndexId })
+  ]);
+  const extractProfile = (result2) => {
+    if (!result2.success || !result2.data)
+      return;
+    const d = result2.data;
+    if (d.profile)
+      return d.profile;
+    const profiles = d.profiles;
+    return profiles?.[0]?.profile;
+  };
+  const extractIntents = (result2) => {
+    if (!result2.success || !result2.data)
+      return;
+    const d = result2.data;
+    return d.intents?.map((i) => ({ intentId: i.intentId ?? i.id ?? "", payload: i.payload, summary: i.summary }));
+  };
+  const entities = [
+    { userId: userA, profile: extractProfile(profileA), intents: extractIntents(intentsA), indexId: sharedIndexId },
+    { userId: userB, profile: extractProfile(profileB), intents: extractIntents(intentsB), indexId: sharedIndexId }
+  ];
+  dim("  Profiles and intents gathered. Creating introduction...");
+  const result = await client.callTool("create_opportunities", {
+    partyUserIds: [userA, userB],
+    entities,
+    ...hint ? { hint } : {}
+  });
+  if (json) {
+    console.log(JSON.stringify(result));
+    return;
+  }
+  if (!result.success) {
+    error(result.error ?? "Introduction failed", 1);
+    return;
+  }
+  success("Introduction created.");
+  const data = result.data;
+  if (data?.message)
+    dim(`  ${data.message}`);
+}
 
 // src/network.command.ts
 var NETWORK_HELP = `
@@ -1425,6 +1847,9 @@ Network Commands:
   index network create <name>            Create a new network
   index network create <name> --prompt   Create with a description
   index network show <id|key>            Show network details and members
+  index network update <id> [--title <t>] [--prompt <p>]
+                                         Update a network
+  index network delete <id>              Delete a network
   index network join <id|key>            Join a public network
   index network leave <id|key>           Leave a network
   index network invite <id|key> <email>  Invite a user by email
@@ -1450,6 +1875,12 @@ async function handleNetwork(client, subcommand, positionals, options) {
     case "leave":
       await networkLeave(client, positionals[0]);
       return;
+    case "update":
+      await networkUpdate(client, positionals[0], options);
+      return;
+    case "delete":
+      await networkDelete(client, positionals[0]);
+      return;
     case "invite":
       await networkInvite(client, positionals[0], positionals[1]);
       return;
@@ -1505,6 +1936,39 @@ async function networkLeave(client, id) {
   await client.leaveNetwork(id);
   success("Left network.");
 }
+async function networkUpdate(client, id, options) {
+  if (!id) {
+    error("Usage: index network update <id> [--title <t>] [--prompt <p>]", 1);
+    return;
+  }
+  const settings = {};
+  if (options.title)
+    settings.title = options.title;
+  if (options.prompt)
+    settings.prompt = options.prompt;
+  if (Object.keys(settings).length === 0) {
+    error("Provide at least --title or --prompt. Usage: index network update <id> [--title <t>] [--prompt <p>]", 1);
+    return;
+  }
+  const result = await client.callTool("update_index", { indexId: id, settings });
+  if (!result.success) {
+    error(result.error ?? "Network update failed", 1);
+    return;
+  }
+  success("Network updated.");
+}
+async function networkDelete(client, id) {
+  if (!id) {
+    error("Usage: index network delete <id>", 1);
+    return;
+  }
+  const result = await client.callTool("delete_index", { indexId: id });
+  if (!result.success) {
+    error(result.error ?? "Network deletion failed", 1);
+    return;
+  }
+  success("Network deleted.");
+}
 async function networkInvite(client, id, email) {
   if (!id || !email) {
     error("Usage: index network invite <id> <email>", 1);
@@ -1891,6 +2355,175 @@ async function handleStreamError(response) {
   error(body.error ?? `HTTP ${response.status}`, 1);
 }
 
+// src/contact.command.ts
+var CONTACT_HELP = `
+Usage:
+  index contact list                       List your contacts
+  index contact add <email> [--name <n>]   Add a contact by email
+  index contact remove <email>             Remove a contact
+  index contact import --gmail             Import contacts from Gmail
+`;
+async function handleContact(client, subcommand, positionals, options) {
+  if (!subcommand) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "No subcommand provided" }));
+    } else {
+      console.log(CONTACT_HELP);
+    }
+    return;
+  }
+  switch (subcommand) {
+    case "list": {
+      const result = await client.callTool("list_contacts", {});
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to list contacts", 1);
+        return;
+      }
+      const data = result.data;
+      heading("Contacts");
+      contactTable(data.contacts);
+      dim(`
+  ${data.count} contact${data.count !== 1 ? "s" : ""}`);
+      console.log();
+      return;
+    }
+    case "add": {
+      const email = positionals[0];
+      if (!email) {
+        error("Missing email. Usage: index contact add <email>", 1);
+        return;
+      }
+      const result = await client.callTool("add_contact", { email, name: options.name });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to add contact", 1);
+        return;
+      }
+      const data = result.data;
+      success(data.message);
+      return;
+    }
+    case "remove": {
+      const email = positionals[0];
+      if (!email) {
+        error("Missing email. Usage: index contact remove <email>", 1);
+        return;
+      }
+      const listResult = await client.callTool("list_contacts", {});
+      if (!listResult.success) {
+        error("Failed to resolve contact", 1);
+        return;
+      }
+      const contacts = listResult.data.contacts;
+      const match = contacts.find((c) => c.email.toLowerCase() === email.toLowerCase());
+      if (!match) {
+        error(`No contact found with email: ${email}`, 1);
+        return;
+      }
+      const result = await client.callTool("remove_contact", { contactUserId: match.userId });
+      if (options.json) {
+        console.log(JSON.stringify(result));
+        return;
+      }
+      if (!result.success) {
+        error(result.error ?? "Failed to remove contact", 1);
+        return;
+      }
+      success(`Removed ${email} from contacts.`);
+      return;
+    }
+    case "import": {
+      if (options.gmail) {
+        const result = await client.callTool("import_gmail_contacts", {});
+        if (options.json) {
+          console.log(JSON.stringify(result));
+          return;
+        }
+        if (!result.success) {
+          error(result.error ?? "Failed to import Gmail contacts", 1);
+          return;
+        }
+        const data = result.data;
+        success(data.message);
+      } else {
+        error("Specify import source: --gmail", 1);
+      }
+      return;
+    }
+    default: {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Unknown subcommand: ${subcommand}` }));
+      } else {
+        error(`Unknown subcommand: ${subcommand}`);
+        console.log(CONTACT_HELP);
+      }
+      return;
+    }
+  }
+}
+
+// src/scrape.command.ts
+async function handleScrape(client, positionals, options) {
+  const url = positionals[0];
+  if (!url) {
+    error("Usage: index scrape <url> [--objective <text>]", 1);
+    return;
+  }
+  info(`Scraping ${url}...`);
+  const result = await client.callTool("scrape_url", { url, objective: options.objective });
+  if (options.json) {
+    console.log(JSON.stringify(result));
+    return;
+  }
+  if (!result.success) {
+    error(result.error ?? "Scrape failed", 1);
+    return;
+  }
+  const data = result.data;
+  heading(`Content from ${data.url}`);
+  console.log(data.content);
+  dim(`
+  ${data.contentLength} characters extracted`);
+  console.log();
+}
+
+// src/sync.command.ts
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+async function handleSync(client, options) {
+  if (!options.json)
+    info("Syncing context...");
+  const [profile, networks, intents, contacts] = await Promise.all([
+    client.callTool("read_user_profiles", {}),
+    client.callTool("read_indexes", {}),
+    client.callTool("read_intents", {}),
+    client.callTool("list_contacts", {})
+  ]);
+  const context = {
+    syncedAt: new Date().toISOString(),
+    profile: profile.success ? profile.data : null,
+    networks: networks.success ? networks.data : null,
+    intents: intents.success ? intents.data : null,
+    contacts: contacts.success ? contacts.data : null
+  };
+  if (options.json) {
+    console.log(JSON.stringify(context));
+    return;
+  }
+  const dir = join2(homedir2(), ".index");
+  mkdirSync(dir, { recursive: true, mode: 448 });
+  writeFileSync(join2(dir, "context.json"), JSON.stringify(context, null, 2), { mode: 384 });
+  success("Context synced to ~/.index/context.json");
+}
+
 // src/main.ts
 var DEFAULT_API_URL = "https://protocol.index.network";
 var DEFAULT_APP_URL = "https://index.network";
@@ -1914,22 +2547,43 @@ Usage:
   index profile                         Show your profile
   index profile show <user-id>          Show another user's profile
   index profile sync                    Regenerate your profile
+  index profile search <query>          Search user profiles
+  index profile create [--linkedin <url>] [--github <url>] [--twitter <url>]
+                                        Create your profile from social URLs
+  index profile update <action> [--details <text>]
+                                        Update your profile
   index intent list [--archived] [--limit <n>]  List your signals
   index intent show <id>               Show signal details
   index intent create <content>        Create a signal from natural language
+  index intent update <id> <content>   Update a signal's description
   index intent archive <id>            Archive a signal
+  index intent link <id> <network-id>  Link a signal to a network
+  index intent unlink <id> <network-id> Unlink a signal from a network
+  index intent links <id>              Show linked networks for a signal
   index opportunity list                List your opportunities
   index opportunity list --status <s>   Filter by status (pending|accepted|rejected|expired)
   index opportunity list --limit <n>    Limit results
   index opportunity show <id>           Show full opportunity details
   index opportunity accept <id>         Accept an opportunity
   index opportunity reject <id>         Reject an opportunity
+  index opportunity discover <query>    Discover opportunities by search query
   index network list                    List your networks
   index network create <name>           Create a new network
   index network show <id>               Show network details and members
+  index network update <id> [--title <t>] [--prompt <p>]
+                                        Update a network
+  index network delete <id>             Delete a network
   index network join <id>               Join a public network
   index network leave <id>              Leave a network
   index network invite <id> <email>     Invite a user by email
+  index contact list                    List your contacts
+  index contact add <email>             Add a contact by email
+  index contact remove <email>          Remove a contact
+  index contact import --gmail          Import contacts from Gmail
+  index scrape <url>                    Extract content from a URL
+  index onboarding complete             Mark onboarding as complete
+  index sync                            Sync context to ~/.index/context.json
+  index sync --json                     Output synced context to stdout
   index --help                          Show this help message
   index --version                       Show version
 
@@ -1941,6 +2595,17 @@ Options:
   --archived          Include archived signals (intent list)
   --status <status>   Filter opportunities by status
   --limit <n>         Limit number of results
+  --json              Output raw JSON instead of formatted text
+  --name <name>       Name for contact add
+  --gmail             Import source flag for contact import
+  --objective <text>  Objective for scrape command
+  --target <uid>      Target user for opportunity discover
+  --introduce <uid>   Source user for introduction discovery
+  --linkedin <url>    LinkedIn URL for profile create
+  --github <url>      GitHub URL for profile create
+  --twitter <url>     Twitter URL for profile create
+  --title <text>      Title for network update
+  --details <text>    Details for profile update
 `;
 async function requireAuth(apiUrlOverride) {
   const store = new CredentialStore;
@@ -2023,26 +2688,39 @@ async function main() {
   const client = await requireAuth(args.apiUrl);
   switch (args.command) {
     case "profile":
-      await handleProfile(client, args.subcommand, args.userId ? [args.userId] : []);
+      await handleProfile(client, args.subcommand, args.subcommand === "search" || args.subcommand === "update" ? args.positionals ?? [] : args.userId ? [args.userId] : [], {
+        json: args.json,
+        linkedin: args.linkedin,
+        github: args.github,
+        twitter: args.twitter,
+        details: args.details
+      });
       return;
     case "intent":
       await handleIntent(client, args.subcommand, {
         intentId: args.intentId,
         intentContent: args.intentContent,
         archived: args.archived,
-        limit: args.limit
+        limit: args.limit,
+        json: args.json,
+        targetId: args.targetId
       });
       return;
     case "opportunity":
       await handleOpportunity(client, args.subcommand, {
         targetId: args.targetId,
         status: args.status,
-        limit: args.limit
+        limit: args.limit,
+        json: args.json,
+        positionals: args.positionals,
+        target: args.target,
+        introduce: args.introduce
       });
       return;
     case "network":
       await handleNetwork(client, args.subcommand, args.positionals ?? [], {
-        prompt: args.prompt
+        prompt: args.prompt,
+        title: args.title
       });
       return;
     case "conversation":
@@ -2052,6 +2730,34 @@ async function main() {
         message: args.message
       });
       return;
+    case "contact":
+      await handleContact(client, args.subcommand, args.positionals ?? [], {
+        json: args.json,
+        name: args.name,
+        gmail: args.gmail
+      });
+      return;
+    case "scrape":
+      await handleScrape(client, args.positionals ?? [], {
+        json: args.json,
+        objective: args.objective
+      });
+      return;
+    case "onboarding":
+      if (args.subcommand === "complete") {
+        const result = await client.callTool("complete_onboarding", {});
+        if (!result.success) {
+          error(result.error ?? "Onboarding completion failed", 1);
+        } else {
+          success("Onboarding completed.");
+        }
+      } else {
+        error("Usage: index onboarding complete", 1);
+      }
+      return;
+    case "sync":
+      await handleSync(client, { json: args.json });
+      return;
   }
 }
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Command-line interface for Index Network",
   "license": "MIT",
   "type": "module",
@@ -20,10 +20,10 @@
     "publish:all": "bun scripts/publish.ts"
   },
   "optionalDependencies": {
-    "@indexnetwork/cli-linux-x64": "0.8.1",
-    "@indexnetwork/cli-linux-arm64": "0.8.1",
-    "@indexnetwork/cli-darwin-x64": "0.8.1",
-    "@indexnetwork/cli-darwin-arm64": "0.8.1"
+    "@indexnetwork/cli-linux-x64": "0.9.1",
+    "@indexnetwork/cli-linux-arm64": "0.9.1",
+    "@indexnetwork/cli-darwin-x64": "0.9.1",
+    "@indexnetwork/cli-darwin-arm64": "0.9.1"
   },
   "devDependencies": {
     "@types/bun": "latest"