forge-remote 0.1.23 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-remote",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Desktop relay for Forge Remote — monitor and control Claude Code sessions from your phone",
   "type": "module",
   "license": "UNLICENSED",

package/src/cli.js

@@ -210,8 +210,10 @@ program
     if (!sdkConfig) {
       console.error("\nCould not load Firebase SDK config.");
       console.error(
-        "Run `forge-remote init` first, or ensure the Firebase CLI is installed.\n",
+        "Run `npx forge-remote init` first, or ensure the Firebase CLI is installed.",
       );
+      console.error("  Install Firebase CLI: npm install -g firebase-tools");
+      console.error(`  Setup guide: https://forgeremote.com/#how-it-works\n`);
       process.exit(1);
     }
 

package/src/init.js

@@ -200,21 +200,74 @@ export async function runInit({ projectId: overrideProjectId } = {}) {
   console.log(
     chalk.dim("  a QR code to pair with the mobile app. Fully automated.\n"),
   );
+  console.log(
+    chalk.dim(
+      `  Full setup guide: ${chalk.cyan("https://forgeremote.com/#how-it-works")}`,
+    ),
+  );
 
-  // ── Step 1: Check Firebase CLI ──────────────────────────────────────────
+  // ── Prerequisites check ──────────────────────────────────────────────────
 
-  console.log(chalk.bold("\n📋 Step 1/11 — Checking Firebase CLI...\n"));
+  console.log(chalk.bold("\n📋 Prerequisites Check\n"));
 
+  const nodeVersion = run(["node", "--version"], { silent: true });
+  const npmVersion = run(["npm", "--version"], { silent: true });
   const firebaseVersion = run(["firebase", "--version"], { silent: true });
+
+  console.log(
+    nodeVersion
+      ? chalk.green(`  ✓ Node.js ${nodeVersion}`)
+      : chalk.red("  ✗ Node.js — not found"),
+  );
+  console.log(
+    npmVersion
+      ? chalk.green(`  ✓ npm ${npmVersion}`)
+      : chalk.red("  ✗ npm — not found"),
+  );
+  console.log(
+    firebaseVersion
+      ? chalk.green(`  ✓ Firebase CLI ${firebaseVersion}`)
+      : chalk.red("  ✗ Firebase CLI — not found"),
+  );
+
+  if (!nodeVersion) {
+    console.error(chalk.red("\n  Node.js is required (v18 or later).\n"));
+    console.error(chalk.bold("  Install it from:\n"));
+    console.error(chalk.cyan("    https://nodejs.org\n"));
+    process.exit(1);
+  }
+
   if (!firebaseVersion) {
-    console.error(chalk.red("  ✗ Firebase CLI not found.\n"));
+    console.error(
+      chalk.red("\n  Firebase CLI is required but not installed.\n"),
+    );
+    console.error(
+      chalk.dim(
+        "  The Firebase CLI is a free command-line tool from Google that lets",
+      ),
+    );
+    console.error(
+      chalk.dim(
+        "  Forge Remote create and manage your Firebase project automatically.\n",
+      ),
+    );
     console.error(chalk.bold("  Install it with:\n"));
     console.error(chalk.cyan("    npm install -g firebase-tools\n"));
+    console.error(chalk.dim("  Then run this command again:\n"));
+    console.error(chalk.cyan("    npx forge-remote init\n"));
     console.error(
-      chalk.dim("  Then run this command again: forge-remote init\n"),
+      chalk.dim(
+        `  For more info: ${chalk.cyan("https://forgeremote.com/#how-it-works")}\n`,
+      ),
     );
     process.exit(1);
   }
+
+  console.log(chalk.green("\n  All prerequisites met!\n"));
+
+  // ── Step 1: Check Firebase CLI ──────────────────────────────────────────
+
+  console.log(chalk.bold("\n📋 Step 1/11 — Checking Firebase CLI...\n"));
   console.log(chalk.green(`  ✓ Firebase CLI ${firebaseVersion}`));
 
   // ── Step 2: Firebase login ──────────────────────────────────────────────

package/src/logger.js

@@ -134,6 +134,7 @@ export function banner(hostname, platform, desktopId, projectCount) {
   console.log(`  ${BOLD}Projects:${RESET}  ${projectCount} found`);
   console.log(`${BOLD}${CYAN}${line}${RESET}`);
   console.log(`  ${GREEN}Listening for commands...${RESET}`);
+  console.log(`  ${DIM}Docs: https://forgeremote.com${RESET}`);
   console.log(`  ${DIM}Press Ctrl+C to stop${RESET}\n`);
 }
 

package/src/session-manager.js

@@ -570,6 +570,9 @@ export async function startNewSession(desktopId, payload) {
     startTime: Date.now(),
     messageCount: 0,
     toolCallCount: 0,
+    turnToolCalls: 0, // Tool calls this turn (reset on each prompt)
+    turnTokensInput: 0, // Input tokens this turn
+    turnTokensOutput: 0, // Output tokens this turn
     isFirstPrompt: true,
     lastToolCall: null, // Last tool_use block (for permission requests)
     permissionNeeded: false, // True when Claude reports permission denial
@@ -690,10 +693,13 @@ async function runClaudeProcess(sessionId, prompt) {
   const session = activeSessions.get(sessionId);
   if (!session) return;
 
-  // Reset permission state for this new turn.
+  // Reset permission state and per-turn stats for this new turn.
   session.permissionNeeded = false;
   session.deniedToolCall = null;
   session.lastToolCall = null;
+  session.turnToolCalls = 0;
+  session.turnTokensInput = 0;
+  session.turnTokensOutput = 0;
 
   const db = getDb();
   const sessionRef = db.collection("sessions").doc(sessionId);
@@ -1031,6 +1037,17 @@ async function runClaudeProcess(sessionId, prompt) {
             timestamp: FieldValue.serverTimestamp(),
           });
 
+        // Award XP for completed turn.
+        awardSessionXp(sessionId, {
+          toolCalls: sess?.turnToolCalls || 0,
+          tokensUsed:
+            (sess?.turnTokensInput || 0) + (sess?.turnTokensOutput || 0),
+        }).catch((e) =>
+          log.warn(
+            `Failed to award XP for ${sessionId.slice(0, 8)}: ${e.message}`,
+          ),
+        );
+
         // Push notification for idle.
         notifySessionIdle(sess.desktopId, sessionId, {
           projectName: sess.projectName || "Unknown",
@@ -1310,7 +1327,12 @@ async function handleStreamEvent(sessionId, sessionRef, event) {
       lastActivity: FieldValue.serverTimestamp(),
     });
 
-    if (session) session.tokenUsage = tokenUsage;
+    if (session) {
+      session.tokenUsage = tokenUsage;
+      // Track per-turn tokens for XP calculation.
+      session.turnTokensInput = tokenUsage.input;
+      session.turnTokensOutput = tokenUsage.output;
+    }
 
     log.session(
       sessionId,
@@ -1509,7 +1531,10 @@ const toolCallDocIds = new Map();
 async function storeToolCall(sessionId, block) {
   const db = getDb();
   const session = activeSessions.get(sessionId);
-  if (session) session.toolCallCount = (session.toolCallCount || 0) + 1;
+  if (session) {
+    session.toolCallCount = (session.toolCallCount || 0) + 1;
+    session.turnToolCalls = (session.turnToolCalls || 0) + 1;
+  }
 
   const toolName = block.name || "unknown";
   const toolInput =