@aion0/forge 0.4.15 → 0.4.16

package/CLAUDE.md

@@ -9,7 +9,7 @@ forge server start              # production via npm link/install
 forge server start --dev        # dev mode
 forge server start              # background by default, logs to ~/.forge/forge.log
 forge server start --foreground # foreground mode
-forge server stop               # stop default instance (port 3000)
+forge server stop               # stop default instance (port 8403)
 forge server stop --port 4000 --dir ~/.forge-staging  # stop specific instance
 forge server restart            # stop + start (safe for remote)
 forge server rebuild            # force rebuild

package/README.md

@@ -32,7 +32,7 @@ npm install -g @aion0/forge
 forge server start
 ```
 
-Open `http://localhost:3000`. First launch prompts you to set an admin password.
+Open `http://localhost:8403`. First launch prompts you to set an admin password.
 
 **Requirements:** Node.js ≥ 20, tmux, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 

package/RELEASE_NOTES.md

@@ -1,25 +1,26 @@
-# Forge v0.4.15
+# Forge v0.4.16
 
 Released: 2026-03-23
 
-## Changes since v0.4.14
+## Changes since v0.4.15
 
 ### Features
-- feat: record token usage from task, pipeline, and mobile sources
-- feat: Usage dashboard — token cost by project, model, day, source
-- feat: token usage tracking — scanner, DB, API
+- feat: change default port from 3000/3001 to 8403/8404
+- feat: prompt to restart Claude after skill/command installation
+- Revert "feat: mobile real-time streaming with tool activity display"
+- feat: mobile real-time streaming with tool activity display
 
 ### Bug Fixes
-- fix: exclude cache tokens from cost estimate
-- fix: usage stored per day+model for accurate daily breakdown
-- fix: usage query uses local timezone for daily grouping
+- fix: only show port change warning when using default port
+- fix: upgrade Next.js 16.1.6 → 16.2.1 to fix Turbopack panic
+- fix: start.sh exports PORT=8403 and TERMINAL_PORT=8404
+- fix: default config port 3000 → 8403
 
-### Performance
-- perf: usage scan interval from 5min to 1 hour
+### Documentation
+- docs: update README port 3000 → 8403
 
 ### Other
-- ui: show author and source URL in skills detail view
-- ui: move Usage button next to Browser in header right section
+- Revert "feat: mobile real-time streaming with tool activity display"
 
 
-**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.4.14...v0.4.15
+**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.4.15...v0.4.16

package/bin/forge-server.mjs

@@ -9,8 +9,8 @@
  *   forge-server --stop                   Stop background server
  *   forge-server --restart                Stop + start (safe for remote)
  *   forge-server --rebuild                Force rebuild
- *   forge-server --port 4000              Custom web port (default: 3000)
- *   forge-server --terminal-port 4001     Custom terminal port (default: 3001)
+ *   forge-server --port 4000              Custom web port (default: 8403)
+ *   forge-server --terminal-port 4001     Custom terminal port (default: 8404)
  *   forge-server --dir ~/.forge-test      Custom data directory (default: ~/.forge)
  *   forge-server --reset-terminal         Kill terminal server before start (loses tmux sessions)
  *
@@ -62,7 +62,7 @@ const isRebuild = process.argv.includes('--rebuild');
 const resetTerminal = process.argv.includes('--reset-terminal');
 const resetPassword = process.argv.includes('--reset-password');
 
-const webPort = parseInt(getArg('--port')) || 3000;
+const webPort = parseInt(getArg('--port')) || 8403;
 const terminalPort = parseInt(getArg('--terminal-port')) || (webPort + 1);
 const DATA_DIR = getArg('--dir')?.replace(/^~/, homedir()) || join(homedir(), '.forge', 'data');
 
@@ -379,6 +379,13 @@ function startBackground() {
   startServices();
 
   console.log(`[forge] Started in background (pid ${child.pid})`);
+  if (!getArg('--port')) {
+    console.log(`[forge] ⚠️  Default port changed: 3000 → ${webPort}`);
+    console.log(`[forge] ⚠️  Default port changed: 3000 → ${webPort}`);
+    console.log(`[forge] ⚠️  Default port changed: 3000 → ${webPort}`);
+    console.log(`[forge] ⚠️  Default port changed: 3000 → ${webPort}`);
+    console.log(`[forge] ⚠️  Default port changed: 3000 → ${webPort}`);
+  }
   console.log(`[forge] Web: http://localhost:${webPort}`);
   console.log(`[forge] Terminal: ws://localhost:${terminalPort}`);
   console.log(`[forge] Data: ${DATA_DIR}`);

package/cli/mw.ts

@@ -562,8 +562,8 @@ Usage:
   forge uninstall                Remove forge
 
 Options for 'forge server start':
-  --port 4000                    Custom web port (default: 3000)
-  --terminal-port 4001           Custom terminal port (default: 3001)
+  --port 4000                    Custom web port (default: 8403)
+  --terminal-port 4001           Custom terminal port (default: 8404)
   --dir ~/.forge-staging         Custom data directory
   --background                   Run in background
   --reset-terminal               Kill terminal server on start

package/components/DocTerminal.tsx

@@ -8,13 +8,13 @@ import '@xterm/xterm/css/xterm.css';
 const SESSION_NAME = 'mw-docs-claude';
 
 function getWsUrl() {
-  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '3001')}`;
+  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '8404')}`;
   const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
   const wsHost = window.location.hostname;
   if (wsHost !== 'localhost' && wsHost !== '127.0.0.1') {
     return `${wsProtocol}//${window.location.host}/terminal-ws`;
   }
-  const webPort = parseInt(window.location.port) || 3000;
+  const webPort = parseInt(window.location.port) || 8403;
   return `${wsProtocol}//${wsHost}:${webPort + 1}`;
 }
 

package/components/HelpTerminal.tsx

@@ -8,13 +8,13 @@ import '@xterm/xterm/css/xterm.css';
 const SESSION_NAME = 'mw-forge-help';
 
 function getWsUrl() {
-  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '3001')}`;
+  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '8404')}`;
   const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
   const wsHost = window.location.hostname;
   if (wsHost !== 'localhost' && wsHost !== '127.0.0.1') {
     return `${wsProtocol}//${window.location.host}/terminal-ws`;
   }
-  const webPort = parseInt(window.location.port) || 3000;
+  const webPort = parseInt(window.location.port) || 8403;
   return `${wsProtocol}//${wsHost}:${webPort + 1}`;
 }
 

package/components/SkillsPanel.tsx

@@ -149,6 +149,7 @@ export default function SkillsPanel({ projectFilter }: { projectFilter?: string
     });
     setInstallTarget({ skill: '', show: false });
     fetchSkills();
+    alert(`"${name}" installed. Restart Claude in terminal to apply.`);
   };
 
   const toggleDetail = async (name: string) => {
@@ -497,6 +498,7 @@ export default function SkillsPanel({ projectFilter }: { projectFilter?: string
                                         body: JSON.stringify({ action: 'install-local', name: itemName, type: localItem.type, sourceProject: localItem.projectPath, target: 'global', force: true }) });
                                       const data = await res.json();
                                       if (!data.ok) alert(data.error);
+                                      else alert(`"${itemName}" installed globally. Restart Claude to apply.`);
                                       setInstallTarget({ skill: '', show: false });
                                       fetchSkills();
                                     }}
@@ -511,6 +513,7 @@ export default function SkillsPanel({ projectFilter }: { projectFilter?: string
                                           body: JSON.stringify({ action: 'install-local', name: itemName, type: localItem.type, sourceProject: localItem.projectPath, target: p.path, force: true }) });
                                         const data = await res.json();
                                         if (!data.ok) alert(data.error);
+                                        else alert(`"${itemName}" installed to ${p.name}. Restart Claude to apply.`);
                                         setInstallTarget({ skill: '', show: false });
                                         fetchSkills();
                                       }}

package/components/WebTerminal.tsx

@@ -43,7 +43,7 @@ interface TabState {
 // ─── Layout persistence ──────────────────────────────────────
 
 function getWsUrl() {
-  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '3001')}`;
+  if (typeof window === 'undefined') return `ws://localhost:${parseInt(process.env.TERMINAL_PORT || '8404')}`;
   const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
   const wsHost = window.location.hostname;
   // When accessed via tunnel or non-localhost, use the Next.js proxy path
@@ -51,7 +51,7 @@ function getWsUrl() {
     return `${wsProtocol}//${window.location.host}/terminal-ws`;
   }
   // Terminal port = web port + 1
-  const webPort = parseInt(window.location.port) || 3000;
+  const webPort = parseInt(window.location.port) || 8403;
   return `${wsProtocol}//${wsHost}:${webPort + 1}`;
 }
 

package/docs/LOCAL-DEPLOY.md

@@ -8,13 +8,13 @@
 
 ### 方案对比
 
-| 方案 | 原理 | 优点 | 缺点 |
-|------|------|------|------|
-| **同一 WiFi 局域网** | Mac 开 Web 服务，手机直接访问 `192.168.x.x:3000` | 零配置、零成本 | 只能在家用 |
-| **Tailscale** | 虚拟局域网，任何网络下设备互通 | 免费、安全、无需公网 IP | 需要装客户端 |
-| **Cloudflare Tunnel** | 免费内网穿透，给你一个公网域名 | 免费、HTTPS、不开端口 | 依赖 Cloudflare |
-| **ngrok** | 临时隧道 | 一行命令搞定 | 免费版地址每次变 |
-| **frp** | 自建内网穿透 | 完全自控 | 需要一台有公网 IP 的服务器 |
+| 方案 | 原理                                     | 优点 | 缺点 |
+|------|----------------------------------------|------|------|
+| **同一 WiFi 局域网** | Mac 开 Web 服务，手机直接访问 `192.168.x.x:8403` | 零配置、零成本 | 只能在家用 |
+| **Tailscale** | 虚拟局域网，任何网络下设备互通                        | 免费、安全、无需公网 IP | 需要装客户端 |
+| **Cloudflare Tunnel** | 免费内网穿透，给你一个公网域名                        | 免费、HTTPS、不开端口 | 依赖 Cloudflare |
+| **ngrok** | 临时隧道                                   | 一行命令搞定 | 免费版地址每次变 |
+| **frp** | 自建内网穿透                                 | 完全自控 | 需要一台有公网 IP 的服务器 |
 
 ### 推荐组合：Tailscale（推荐） + 局域网（备选）
 
@@ -23,9 +23,9 @@
 │         你的 Mac                 │
 │                                 │
 │  my-workflow server             │
-│  ├── REST API    :3000          │
-│  ├── WebSocket   :3000/ws       │
-│  └── Dashboard   :3000          │
+│  ├── REST API    :8403          │
+│  ├── WebSocket   :8403/ws       │
+│  └── Dashboard   :8403          │
 │                                 │
 │  Tailscale IP: 100.x.x.x       │
 │  局域网 IP:    192.168.x.x      │
@@ -36,8 +36,8 @@
 ┌──────────┴──────────────────────┐
 │         你的手机                 │
 │                                 │
-│  浏览器 → 100.x.x.x:3000       │  ← 任何网络下都能访问
-│  或 Safari → 192.168.x.x:3000  │  ← 同一 WiFi 下
+│  浏览器 → 100.x.x.x:8403       │  ← 任何网络下都能访问
+│  或 Safari → 192.168.x.x:8403  │  ← 同一 WiFi 下
 │                                 │
 └─────────────────────────────────┘
 ```
@@ -67,7 +67,7 @@ tailscale ip -4
 
 # 5. 启动 my-workflow
 mw server start
-# → Dashboard: http://100.64.x.x:3000
+# → Dashboard: http://100.64.x.x:8403
 
 # 手机浏览器打开这个地址即可
 ```
@@ -133,10 +133,10 @@ launchctl list | grep my-workflow
 
 ```
 本地开发阶段:
-  手机 → Tailscale → Mac:3000
+  手机 → Tailscale → Mac:8403
 
 迁移到云端:
-  手机 → Tailscale → VPS:3000   (只是 IP 变了)
+  手机 → Tailscale → VPS:8403   (只是 IP 变了)
   或
   手机 → https://workflow.yourdomain.com  (Cloudflare Tunnel)
 ```

package/lib/cloudflared.ts

@@ -169,7 +169,7 @@ function pushLog(line: string) {
   if (state.log.length > MAX_LOG_LINES) state.log.shift();
 }
 
-export async function startTunnel(localPort: number = parseInt(process.env.PORT || '3000')): Promise<{ url?: string; error?: string }> {
+export async function startTunnel(localPort: number = parseInt(process.env.PORT || '8403')): Promise<{ url?: string; error?: string }> {
   console.log(`[tunnel] Starting tunnel on port ${localPort}...`);
   // Prevent concurrent starts: state.process is already spawned, or another call is
   // mid-flight between the guard and spawn (the async download window).

package/lib/help-docs/00-overview.md

@@ -9,7 +9,7 @@ npm install -g @aion0/forge
 forge server start
 ```
 
-Open `http://localhost:3000`. First launch prompts you to set an admin password.
+Open `http://localhost:8403`. First launch prompts you to set an admin password.
 
 ## Requirements
 - Node.js >= 20

package/lib/help-docs/05-pipelines.md

@@ -260,25 +260,25 @@ Schedule options: Manual only, 15min, 30min, 1h, 2h, 6h, 12h, 24h.
 
 ```bash
 # List bindings + runs + workflows for a project
-curl "http://localhost:3000/api/project-pipelines?project=/path/to/project"
+curl "http://localhost:8403/api/project-pipelines?project=/path/to/project"
 
 # Add binding
-curl -X POST http://localhost:3000/api/project-pipelines \
+curl -X POST http://localhost:8403/api/project-pipelines \
   -H 'Content-Type: application/json' \
   -d '{"action":"add","projectPath":"/path","projectName":"my-app","workflowName":"issue-fix-and-review"}'
 
 # Update binding (enable/disable, change config/schedule)
-curl -X POST http://localhost:3000/api/project-pipelines \
+curl -X POST http://localhost:8403/api/project-pipelines \
   -H 'Content-Type: application/json' \
   -d '{"action":"update","projectPath":"/path","workflowName":"issue-fix-and-review","config":{"interval":30}}'
 
 # Trigger pipeline manually
-curl -X POST http://localhost:3000/api/project-pipelines \
+curl -X POST http://localhost:8403/api/project-pipelines \
   -H 'Content-Type: application/json' \
   -d '{"action":"trigger","projectPath":"/path","projectName":"my-app","workflowName":"issue-fix-and-review","input":{"issue_id":"42"}}'
 
 # Remove binding
-curl -X POST http://localhost:3000/api/project-pipelines \
+curl -X POST http://localhost:8403/api/project-pipelines \
   -H 'Content-Type: application/json' \
   -d '{"action":"remove","projectPath":"/path","workflowName":"issue-fix-and-review"}'
 ```
@@ -303,7 +303,7 @@ To create a workflow via Help AI: ask "Create a pipeline that does X" — the AI
 ## Creating Workflows via API
 
 ```bash
-curl -X POST http://localhost:3000/api/pipelines \
+curl -X POST http://localhost:8403/api/pipelines \
   -H 'Content-Type: application/json' \
   -d '{"action": "save-workflow", "yaml": "<yaml content>"}'
 ```

package/lib/init.ts

@@ -182,7 +182,7 @@ function startTelegramProcess() {
   const script = join(process.cwd(), 'lib', 'telegram-standalone.ts');
   telegramChild = spawn('npx', ['tsx', script], {
     stdio: ['ignore', 'inherit', 'inherit'],
-    env: { ...process.env, PORT: String(process.env.PORT || 3000) },
+    env: { ...process.env, PORT: String(process.env.PORT || 8403) },
     detached: false,
   });
   telegramChild.on('exit', () => { telegramChild = null; });
@@ -194,7 +194,7 @@ let terminalChild: ReturnType<typeof spawn> | null = null;
 function startTerminalProcess() {
   if (terminalChild) return;
 
-  const termPort = Number(process.env.TERMINAL_PORT) || 3001;
+  const termPort = Number(process.env.TERMINAL_PORT) || 8404;
 
   const net = require('node:net');
   const tester = net.createServer();

package/lib/telegram-standalone.ts

@@ -61,7 +61,7 @@ async function poll() {
 
           // Forward to Next.js API for processing
           try {
-            await fetch(`http://localhost:${process.env.PORT || 3000}/api/telegram`, {
+            await fetch(`http://localhost:${process.env.PORT || 8403}/api/telegram`, {
               method: 'POST',
               headers: { 'Content-Type': 'application/json', 'x-telegram-secret': TOKEN },
               body: JSON.stringify(update.message),

package/lib/terminal-server.ts

@@ -1,6 +1,6 @@
 /**
  * Terminal Server — standalone WebSocket PTY server.
- * Runs on port 3001 alongside the Next.js dev server on 3000.
+ * Runs on port 8404 alongside the Next.js server on 8403.
  */
 
 import { WebSocketServer, WebSocket } from 'ws';
@@ -9,7 +9,7 @@ import { homedir } from 'node:os';
 
 let wss: WebSocketServer | null = null;
 
-export function startTerminalServer(port = 3001) {
+export function startTerminalServer(port = 8404) {
   if (wss) return;
 
   wss = new WebSocketServer({ port });

package/lib/terminal-standalone.ts

@@ -33,7 +33,7 @@ import { getDataDir } from './dirs';
 import { readFileSync, writeFileSync, mkdirSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
-const PORT = Number(process.env.TERMINAL_PORT) || 3001;
+const PORT = Number(process.env.TERMINAL_PORT) || 8404;
 // Session prefix based on DATA_DIR hash — default instance keeps 'mw-' for backward compat
 const _dataDir = process.env.FORGE_DATA_DIR || '';
 const _isDefault = !_dataDir || _dataDir.endsWith('/data') || _dataDir.endsWith('/.forge');

package/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aion0/forge",
-  "version": "0.4.15",
+  "version": "0.4.16",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {
@@ -37,7 +37,7 @@
     "@xyflow/react": "^12.10.1",
     "ai": "^6.0.116",
     "better-sqlite3": "^12.6.2",
-    "next": "^16.1.6",
+    "next": "^16.2.1",
     "next-auth": "5.0.0-beta.30",
     "node-pty": "1.0.0",
     "react": "^19.2.4",

package/src/config/index.ts

@@ -102,7 +102,7 @@ function getDefaultConfig(): AppConfig {
     },
     server: {
       host: '0.0.0.0',
-      port: 3000,
+      port: 8403,
     },
   };
 }

package/start.sh

@@ -14,6 +14,9 @@ pkill -f 'next start' 2>/dev/null
 pkill -f 'next dev' 2>/dev/null
 sleep 1
 
+export PORT=${PORT:-8403}
+export TERMINAL_PORT=${TERMINAL_PORT:-8404}
+
 if [ "$1" = "dev" ]; then
   pnpm dev
 else