claude-friends 0.1.2 → 0.2.0

package/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { writeFileSync, existsSync } from "fs";
+import { writeFileSync, existsSync, mkdirSync, copyFileSync, readdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import { createInterface } from "readline";
@@ -40,18 +40,32 @@ if (command === "setup") {
 
   writeFileSync(CONFIG_PATH, JSON.stringify({ username: username.trim() }, null, 2));
 
+  // Install slash commands to ~/.claude/commands/
+  const commandsDir = join(homedir(), ".claude", "commands");
+  mkdirSync(commandsDir, { recursive: true });
+
+  const srcCommands = join(__dirname, "commands");
+  if (existsSync(srcCommands)) {
+    const files = readdirSync(srcCommands).filter((f) => f.endsWith(".md"));
+    for (const file of files) {
+      copyFileSync(join(srcCommands, file), join(commandsDir, file));
+    }
+    console.log(`\nInstalled slash commands: ${files.map((f) => "/" + f.replace(".md", "")).join(", ")}`);
+  }
+
   console.log(`
 Done! You're "${username.trim()}".
 
 Now add the MCP server to Claude Code:
 
-  claude mcp add claude-friends -- node ${join(__dirname, "mcp-server.js")}
+  claude mcp add claude-friends -- claude-friends serve
 
-Then in Claude Code, try:
-  "who's online?"
-  "add friend alice"
-  "set my status to debugging auth"
-  "nudge bob"
+Then in Claude Code:
+  /friend alice       Add a friend
+  /friends            See who's online
+  /nudge bob          Nudge someone
+  /status debugging   Set your status
+  /unfriend alice     Remove a friend
 `);
 
   rl.close();

package/commands/friend.md

@@ -0,0 +1 @@
+Use the add-friend MCP tool to add "$ARGUMENTS" as a friend. If no username is provided, ask for one.

package/commands/friends.md

@@ -0,0 +1 @@
+Use the friends-online MCP tool to show who's currently online.

package/commands/nudge.md

@@ -0,0 +1 @@
+Use the nudge MCP tool to nudge "$ARGUMENTS". If the input includes a message after the username, pass it as the message parameter. If no username is provided, ask for one.

package/commands/status.md

@@ -0,0 +1 @@
+Use the set-status MCP tool to set your status to "$ARGUMENTS". If no status is provided, ask what to set it to.

package/commands/unfriend.md

@@ -0,0 +1 @@
+Use the remove-friend MCP tool to remove "$ARGUMENTS" from your friends list. If no username is provided, ask for one.

package/mcp-server.js

@@ -13,14 +13,25 @@ const username = config.username;
 
 // Persistent WebSocket connection — stays open while Claude Code is running
 const ws = createConnection(username);
+let connected = false;
 
 // Local cache of state, updated via WebSocket messages
 let friendsList = [];
 let pendingNudges = [];
 let lastError = null;
 
+// Wait for connection to be ready
+function waitForConnection(timeout = 10000) {
+  return new Promise((resolve, reject) => {
+    if (connected && ws.readyState === 1) return resolve();
+    const timer = setTimeout(() => reject(new Error("connection timeout")), timeout);
+    ws.addEventListener("open", () => { connected = true; clearTimeout(timer); resolve(); }, { once: true });
+  });
+}
+
 // Promise-based request/response helper
-function request(msg, responseType, timeout = 5000) {
+async function request(msg, responseType, timeout = 5000) {
+  await waitForConnection();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => reject(new Error("timeout")), timeout);
     const handler = (event) => {
@@ -138,6 +149,7 @@ server.tool(
   "Set your status so friends can see what you're working on.",
   { status: z.string().describe("Your status, e.g. 'debugging auth flow'") },
   async ({ status }) => {
+    await waitForConnection();
     ws.send(JSON.stringify({ type: "set-status", status }));
     return { content: [{ type: "text", text: `Status set: "${status}"` }] };
   }
@@ -148,6 +160,7 @@ server.tool(
   "Share your token usage with friends.",
   { tokens: z.number().describe("Tokens used this session") },
   async ({ tokens }) => {
+    await waitForConnection();
     ws.send(JSON.stringify({ type: "share-tokens", tokens }));
     return { content: [{ type: "text", text: `Sharing: ${tokens.toLocaleString()} tokens` }] };
   }
@@ -158,6 +171,7 @@ server.tool(
   "Stop sharing token usage.",
   {},
   async () => {
+    await waitForConnection();
     ws.send(JSON.stringify({ type: "hide-tokens" }));
     return { content: [{ type: "text", text: "Token usage hidden." }] };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-friends",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "See who's online in Claude Code. Add friends, share status, nudge each other.",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
     "cli.js",
     "mcp-server.js",
     "statusline.js",
-    "client.js"
+    "client.js",
+    "commands/"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",