@aion0/forge 0.1.0 → 0.1.2

package/README.md

@@ -31,6 +31,12 @@ No API keys required. Forge runs on your existing Claude Code subscription.
 
 ```bash
 npm install -g @aion0/forge
+
+# Start the server
+forge-server
+
+# Or in development mode
+forge-server --dev
 ```
 
 ### From source
@@ -39,38 +45,12 @@ npm install -g @aion0/forge
 git clone https://github.com/aiwatching/forge.git
 cd forge
 pnpm install
-pnpm build
+pnpm dev
 ```
 
 ## Quick Start
 
-### 1. Create config
-
-Create `.env.local` in the project root:
-
-```env
-# Auth (generate a random string, e.g. openssl rand -hex 32)
-AUTH_SECRET=<random-string>
-AUTH_TRUST_HOST=true
-
-# Optional: Google OAuth for production
-# GOOGLE_CLIENT_ID=...
-# GOOGLE_CLIENT_SECRET=...
-```
-
-> **API keys are not required.** Forge uses your local Claude Code CLI, which runs on your Anthropic subscription. If you want to use the built-in multi-model chat feature, you can optionally add provider keys (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`, `XAI_API_KEY`) later.
-
-### 2. Start the server
-
-```bash
-# Development
-pnpm dev
-
-# Production
-pnpm build && pnpm start
-```
-
-### 3. Log in
+### 1. Log in
 
 Open `http://localhost:3000`. A login password is auto-generated and printed in the console:
 
@@ -252,6 +232,20 @@ notifyOnFailure: true
 | Tunnel | Cloudflare (cloudflared) |
 | Bot | Telegram Bot API (extensible) |
 
+## Troubleshooting
+
+### macOS: "fork failed: Device not configured"
+
+This means the system ran out of pseudo-terminal (PTY) devices. macOS defaults to 511, which can be tight when running IDEs and many terminal sessions. Increase the limit:
+
+```bash
+# Temporary (until reboot)
+sudo sysctl kern.tty.ptmx_max=2048
+
+# Permanent
+echo 'kern.tty.ptmx_max=2048' | sudo tee -a /etc/sysctl.conf
+```
+
 ## Roadmap
 
 - [ ] **Multi-Agent Workflow** — DAG-based pipelines where multiple Claude Code instances collaborate, passing outputs between nodes with conditional routing and parallel execution. See [docs/roadmap-multi-agent-workflow.md](docs/roadmap-multi-agent-workflow.md).

package/app/login/page.tsx

@@ -42,19 +42,6 @@ export default function LoginPage() {
           </button>
         </form>
 
-        <div className="flex items-center gap-3 text-[var(--text-secondary)] text-xs">
-          <div className="flex-1 h-px bg-[var(--border)]" />
-          <span>or</span>
-          <div className="flex-1 h-px bg-[var(--border)]" />
-        </div>
-
-        {/* Google OAuth */}
-        <button
-          onClick={() => signIn('google', { callbackUrl: window.location.origin + '/' })}
-          className="w-full py-2 bg-[var(--bg-tertiary)] border border-[var(--border)] rounded text-sm text-[var(--text-primary)] hover:bg-[var(--border)] transition-colors"
-        >
-          Sign in with Google
-        </button>
       </div>
     </div>
   );

package/bin/forge-server.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * forge-server — Start the Forge web platform.
+ *
+ * Usage:
+ *   forge-server          Start in production mode (builds first if needed)
+ *   forge-server --dev    Start in development mode
+ */
+
+import { execSync, spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const isDev = process.argv.includes('--dev');
+
+process.chdir(ROOT);
+
+if (isDev) {
+  console.log('[forge] Starting in development mode...');
+  const child = spawn('npx', ['next', 'dev', '--turbopack'], {
+    cwd: ROOT,
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  child.on('exit', (code) => process.exit(code || 0));
+} else {
+  // Build if .next doesn't exist
+  if (!existsSync(join(ROOT, '.next'))) {
+    console.log('[forge] Building...');
+    execSync('npx next build', { cwd: ROOT, stdio: 'inherit' });
+  }
+  console.log('[forge] Starting server...');
+  const child = spawn('npx', ['next', 'start'], {
+    cwd: ROOT,
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  child.on('exit', (code) => process.exit(code || 0));
+}

package/components/WebTerminal.tsx

@@ -836,7 +836,7 @@ const MemoTerminalPane = memo(function TerminalPane({
       fontSize: 13,
       fontFamily: 'Menlo, Monaco, "Courier New", monospace',
       scrollback: 10000,
-      logger: { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} },
+      logger: { trace: () => {}, debug: () => {}, info: () => {}, warn: () => {}, error: () => {} },
       theme: {
         background: '#1a1a2e',
         foreground: '#e0e0e0',
@@ -920,8 +920,11 @@ const MemoTerminalPane = memo(function TerminalPane({
           const sn = sessionNameRef.current;
           if (sn) {
             socket.send(JSON.stringify({ type: 'attach', sessionName: sn, cols, rows }));
-          } else {
+          } else if (createRetries < MAX_CREATE_RETRIES) {
+            createRetries++;
             socket.send(JSON.stringify({ type: 'create', cols, rows }));
+          } else {
+            term.write('\r\n\x1b[91m[failed to create session — check server logs]\x1b[0m\r\n');
           }
         }
       };
@@ -957,15 +960,7 @@ const MemoTerminalPane = memo(function TerminalPane({
               }, 500);
             }
           } else if (msg.type === 'error') {
-            if (!connectedSession && createRetries < MAX_CREATE_RETRIES) {
-              createRetries++;
-              term.write(`\r\n\x1b[93m[${msg.message || 'error'} — retry ${createRetries}/${MAX_CREATE_RETRIES}...]\x1b[0m\r\n`);
-              if (ws?.readyState === WebSocket.OPEN) {
-                ws.send(JSON.stringify({ type: 'create', cols: term.cols, rows: term.rows }));
-              }
-            } else {
-              term.write(`\r\n\x1b[93m[${msg.message || 'error'}]\x1b[0m\r\n`);
-            }
+            term.write(`\r\n\x1b[93m[${msg.message || 'error'}]\x1b[0m\r\n`);
           } else if (msg.type === 'exit') {
             term.write('\r\n\x1b[90m[session ended]\x1b[0m\r\n');
           }

package/lib/task-manager.ts

@@ -222,8 +222,7 @@ function executeTask(task: Task): Promise<void> {
 
     // Resolve the actual claude CLI script path (claude is a symlink to a .js file)
     const resolvedClaude = resolveClaudePath(claudePath);
-    console.log(`[task-runner] Spawning: ${resolvedClaude.cmd} ${resolvedClaude.prefix.concat(args).join(' ')}`);
-    console.log(`[task-runner] CWD: ${task.projectPath}`);
+    console.log(`[task] ${task.projectName}: "${task.prompt.slice(0, 60)}..."`);
 
     const child = spawn(resolvedClaude.cmd, [...resolvedClaude.prefix, ...args], {
       cwd: task.projectPath,
@@ -243,7 +242,7 @@ function executeTask(task: Task): Promise<void> {
     });
 
     child.stdout?.on('data', (data: Buffer) => {
-      console.log(`[task-runner] stdout chunk: ${data.toString().slice(0, 200)}`);
+      // stdout chunk processing (silent)
 
       // Check if cancelled
       if (getTask(task.id)?.status === 'cancelled') {
@@ -275,14 +274,14 @@ function executeTask(task: Task): Promise<void> {
 
     child.stderr?.on('data', (data: Buffer) => {
       const text = data.toString().trim();
-      console.error(`[task-runner] stderr: ${text.slice(0, 300)}`);
+      // stderr logged to task log only
       if (text) {
         appendLog(task.id, { type: 'system', subtype: 'error', content: text, timestamp: new Date().toISOString() });
       }
     });
 
     child.on('exit', (code, signal) => {
-      console.log(`[task-runner] Process exited: code=${code}, signal=${signal}`);
+      // Process exit handled below
       // Process remaining buffer
       if (buffer.trim()) {
         try {
@@ -511,7 +510,7 @@ function startMonitorTask(task: Task) {
   const stopTail = tailSessionFile(fp, (newEntries) => {
     lastActivityTime = Date.now();
     lastEntryCount += newEntries.length;
-    console.log(`[monitor] ${task.id}: +${newEntries.length} entries (${lastEntryCount} total)`);
+    // Monitor entries tracked in task log only
 
     appendLog(task.id, {
       type: 'system', subtype: 'text',

package/lib/telegram-bot.ts

@@ -105,7 +105,7 @@ async function poll() {
 
 async function handleMessage(msg: any) {
   const chatId = msg.chat.id;
-  console.log(`[telegram] Message from chat ID: ${chatId}, user: ${msg.from?.username || msg.from?.first_name || 'unknown'}`);
+  // Message received (logged silently)
   const text: string = msg.text.trim();
   const replyTo = msg.reply_to_message?.message_id;
 

package/lib/terminal-standalone.ts

@@ -215,6 +215,12 @@ wss.on('connection', (ws: WebSocket) => {
       return;
     }
 
+    // Kill previous pty process before attaching to new session (prevents PTY leak)
+    if (term) {
+      try { term.kill(); } catch {}
+      term = null;
+    }
+
     // Ensure mouse and scrollback are enabled (for old sessions too)
     try {
       execSync(`${TMUX} set-option -t ${name} mouse on 2>/dev/null`);
@@ -239,7 +245,7 @@ wss.on('connection', (ws: WebSocket) => {
       } as Record<string, string>,
     });
 
-    console.log(`[terminal] Attached to tmux session "${name}" (pid: ${term.pid})`);
+    // Attached to tmux session (silent)
     ws.send(JSON.stringify({ type: 'connected', sessionName: name }));
 
     term.onData((data: string) => {
@@ -338,7 +344,7 @@ wss.on('connection', (ws: WebSocket) => {
     // Only kill the pty attach process, NOT the tmux session — it persists
     if (term) {
       term.kill();
-      console.log(`[terminal] Detached from tmux session "${sessionName}"`);
+      // Detached from tmux session (silent)
     }
 
     // Untrack this client

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.1.0",
+  "version": "0.1.2",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {
@@ -11,6 +11,7 @@
   },
   "bin": {
     "forge": "./cli/mw.ts",
+    "forge-server": "./bin/forge-server.mjs",
     "mw": "./cli/mw.ts"
   },
   "keywords": [