@aion0/forge 0.5.43 → 0.5.46

package/RELEASE_NOTES.md

@@ -1,11 +1,8 @@
-# Forge v0.5.43
+# Forge v0.5.46
 
-Released: 2026-04-25
+Released: 2026-04-26
 
-## Changes since v0.5.42
+## Changes since v0.5.45
 
-### Features
-- feat: smith pause/resume + agent_status watch event-driven + primary session picker
 
-
-**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.5.42...v0.5.43
+**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.5.45...v0.5.46

package/components/Dashboard.tsx

@@ -98,6 +98,20 @@ function FloatingBrowser({ onClose }: { onClose: () => void }) {
 
 export default function Dashboard({ user }: { user: any }) {
   const [viewMode, setViewMode] = useState<'tasks' | 'sessions' | 'terminal' | 'docs' | 'projects' | 'pipelines' | 'workspace' | 'skills' | 'logs' | 'usage'>('terminal');
+
+  // Honour `?view=<mode>` from the URL so external links (eg the VSCode
+  // extension) can deep-link straight into a section. Only views that have a
+  // top-level render branch are accepted. `workspace` and `sessions` live
+  // inside ProjectDetail, so they alias to `projects` (where you pick the
+  // project that contains the workspace/session).
+  useEffect(() => {
+    const raw = new URLSearchParams(window.location.search).get('view');
+    if (!raw) return;
+    const aliases: Record<string, string> = { workspace: 'projects', sessions: 'projects' };
+    const v = aliases[raw] || raw;
+    const valid = ['tasks', 'terminal', 'docs', 'projects', 'pipelines', 'skills', 'logs', 'usage'];
+    if (valid.includes(v)) setViewMode(v as any);
+  }, []);
   // workspaceProject state kept for forge:open-terminal event compatibility
   const [workspaceProject, setWorkspaceProject] = useState<{ name: string; path: string } | null>(null);
   const [browserMode, setBrowserMode] = useState<'none' | 'float' | 'right' | 'left'>('none');

package/lib/agents/index.ts

@@ -209,7 +209,7 @@ export function resolveTerminalLaunch(agentId?: string): TerminalLaunchInfo {
 
   // Determine CLI command and capabilities from cliType
   const cliMap: Record<string, { cmd: string; session: boolean; resume: string }> = {
-    'claude-code': { cmd: 'claude', session: true, resume: '-c' },
+    'claude-code': { cmd: 'claude', session: true, resume: '--resume' },
     'codex': { cmd: 'codex', session: false, resume: '' },
     'aider': { cmd: 'aider', session: false, resume: '' },
     'generic': { cmd: agentCfg.path || agentId || 'claude', session: false, resume: '' },

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

@@ -17,6 +17,7 @@ Forge is a self-hosted Vibe Coding platform for Claude Code. It provides a brows
 | **Remote Access** | One-click Cloudflare tunnel for remote browsing |
 | **GitHub Issue Auto-fix** | Scan issues, auto-fix, create PRs |
 | **Memory (optional)** | Code graph + knowledge via `@aion0/temper` MCP server |
+| **IDE Plugins** | First-party VSCode extension and IntelliJ plugin — drive workspaces, agents, terminals, pipelines and docs from inside the editor (see `13-ide-plugins.md`) |
 
 ## Quick Start
 

package/lib/help-docs/13-ide-plugins.md

@@ -0,0 +1,90 @@
+# IDE Plugins
+
+Forge ships with two first-party IDE plugins that mirror the web UI's feature set so you can drive workspaces, agent terminals, pipelines and docs without leaving the editor. Both are **thin clients** — they require a Forge server running locally (or reachable over a tunnel).
+
+| | VSCode extension | IntelliJ plugin |
+|---|---|---|
+| Marketplace ID | `aion0.forge-vibecoding` | `Forge Vibe Coding` (`com.aion0.forge`) |
+| Install | VSCode → Extensions → search `Forge Vibe Coding` | IDE → Settings → Plugins → Marketplace → search `Forge Vibe Coding` |
+| Source | `vscode-extension/` | `intellij-plugin/` |
+| Min IDE | VSCode ≥ 1.80 | IntelliJ Platform ≥ 2024.1 (build 241) |
+
+## Prerequisites
+
+The plugins do **not** ship Forge — install it once first:
+
+```bash
+npm install -g @aion0/forge
+forge server start
+```
+
+Default port `8403`. The plugins auto-detect `http://localhost:8403`. For remote forges (over Cloudflare tunnel or LAN), add a connection in plugin settings (see below).
+
+## Tool Window / Sidebar Layout
+
+Both plugins expose four tabs:
+
+| Tab | Shows | Right-click actions | Double-click |
+|---|---|---|---|
+| **Workspaces** | Forge workspaces with daemon status (🟢/○) and per-smith status emoji (▶ running / ⏸ paused / ✓ done / ✕ failed / ◐ starting) | Workspace: start / stop / restart daemon. Smith: open terminal, send message, pause/resume, mark done/failed/idle, retry. | Smith → attach to its tmux session in an IDE terminal |
+| **Terminals** | Each forge project as a folder with its claude sessions (★ = bound/pinned default). | Project: **Open With ▸** submenu of every configured agent (claude/codex/aider/...) — fresh launch; New Session… (pick agent); Plain Terminal Here. Session: Resume; Resume With… submenu; Pin as Default Session. | Session row resumes that exact session via `claude --resume <id>` |
+| **Pipelines** | Forge projects with their pipeline bindings (⚙ enabled / ⊘ disabled) and recent runs (▶/✓/✕/⊘). | Project: Add Pipeline…; Binding: Trigger Now, Enable/Disable, Remove; Run: Show Nodes; Node: Show Result. | Binding: trigger; Run: expand to see nodes; Node: open prompt/result/diff/log as a markdown buffer |
+| **Docs** | Configured doc roots → file/dir tree. | Dir: Open Terminal Here (runs claude); File: Open. | File: open in IDE editor |
+
+## Multi-Connection (Local + Remote forges)
+
+Both plugins support multiple Forge servers — useful when you have one Forge running locally for `~/.forge` and a second running on an office Mac mini exposed via tunnel.
+
+**VSCode**: edit `forge.connections` in settings.json:
+```json
+{
+  "forge.connections": [
+    { "name": "Local",  "serverUrl": "http://localhost:8403", "terminalUrl": "ws://localhost:8404" },
+    { "name": "Office", "serverUrl": "https://forge-office.trycloudflare.com", "terminalUrl": "wss://forge-office.trycloudflare.com" }
+  ],
+  "forge.activeConnection": "Local"
+}
+```
+Click the status-bar entry (bottom right, `Forge: <name>`) to switch.
+
+**IntelliJ**: Settings → Tools → Forge → Connections list. Status-bar widget toggles active connection.
+
+Tokens are stored per-connection: VSCode uses `SecretStorage`, IntelliJ uses `PasswordSafe`. `Forge: Login` (command palette / Tools menu) prompts for the admin password and caches the bearer token.
+
+## How agent terminals work
+
+When you double-click a session row or pick `Open With ▸ <agent>`:
+
+1. Plugin calls `GET /api/agents?resolve=<agentId>` → gets `cliCmd`, `cliType`, `supportsSession`, `env`, `model`.
+2. For specific-session resume: `claude --resume <sid>` (forced regardless of API's `resumeFlag` — `-c` is wrong for specific resume).
+3. Profile env vars are forwarded to the spawned process.
+4. `model` is passed as `--model <name>` for claude-code agents (so a "sonnet" profile actually runs sonnet).
+5. **IntelliJ** spawns the agent CLI directly as the pty's primary process (`LocalTerminalDirectRunner` subclass with `enableShellIntegration = false` + `configureStartupOptions` override) — no shell, no `executeCommand` race. The user's login shell (`$SHELL -l`) is wrapped around it so `.zprofile` / `.bash_profile` is sourced for PATH.
+6. **VSCode** uses the existing terminal-server WebSocket (`forge.terminalUrl`) to attach.
+
+Workspace smith terminals attach to a pre-existing tmux session via `tmux -2 -u attach -t <session>` (UTF-8 + 256-color forced, otherwise JediTerm/xterm.js render boxes wrong).
+
+## Releasing new versions (maintainers)
+
+Each plugin has a `publish.sh` in its directory:
+
+```bash
+# VSCode — needs `vsce login aion0` cached, or $VSCE_PAT env var
+cd vscode-extension
+./publish.sh patch          # bump 0.2.x → 0.2.(x+1) and publish
+
+# IntelliJ — needs $JETBRAINS_MARKETPLACE_TOKEN env var
+cd intellij-plugin
+./publish.sh patch
+```
+
+VSCode goes live in 1–2 minutes. IntelliJ goes through human moderation: 1–3 business days for the first publish, hours-to-1-day for subsequent updates of an already-approved plugin.
+
+## Troubleshooting
+
+- **"Not connected" / "401" in tree** — Forge server isn't running or the token expired. Run `Forge: Login` (or `forge server start` if the server is down).
+- **Terminal opens but agent CLI fails** ("`claude: command not found`") — IDE inherited a stripped PATH. The IntelliJ plugin spawns under `$SHELL -l -c …` to source `.zprofile`/`.bash_profile`; if your PATH is set in `.zshrc` only (not `.zprofile`), move it.
+- **Smith terminal shows garbled output** — make sure tmux ≥ 3.0 and the IDE terminal supports UTF-8 + 256-color. The plugin already passes `tmux -2 -u attach`; if it still looks broken, check `$LANG` is `*.UTF-8`.
+- **Picked a session, claude opens a different one** — Forge ≤ 0.5.43 had `resume: '-c'` hardcoded for claude (which is `--continue`, zero-arg). Upgrade Forge or pull the latest `lib/agents/index.ts`.
+- **JetBrains plugin install fails with "incompatible build"** — verify your IDE is build 241+ (Help → About → Build #). The plugin's `sinceBuild = 241`.
+- **Tree keeps collapsing folders I expanded** — fixed in IntelliJ plugin v0.1.17 (full path expansion is preserved across the 5-second poll, not just top-level).

package/lib/help-docs/CLAUDE.md

@@ -43,6 +43,7 @@ The token is valid for 24 hours. Store it in a variable and reuse for all API ca
 | `10-troubleshooting.md` | Common issues and solutions |
 | `11-workspace.md` | Workspace (Forge Smiths) — multi-agent orchestration, daemon, message bus, profiles |
 | `12-usage.md` | Token usage analytics — charts, heatmap, cost estimation, by model/project/source |
+| `13-ide-plugins.md` | VSCode extension + IntelliJ plugin — install, tabs, multi-connection, agent terminal launching |
 
 ## Matching questions to docs
 
@@ -64,3 +65,5 @@ The token is valid for 24 hours. Store it in a variable and reuse for all API ca
 - Usage/cost/tokens/spending/billing/analytics → `12-usage.md`
 - Terminal dock/float/mouse toggle/reconnect → `07-projects.md` + `11-workspace.md`
 - Sidebar collapse/project tabs/favorites → `07-projects.md`
+- VSCode/IntelliJ/IDE plugin/extension/marketplace → `13-ide-plugins.md`
+- vsce/vsix/JetBrains marketplace publish → `13-ide-plugins.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aion0/forge",
-  "version": "0.5.43",
+  "version": "0.5.46",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {

package/tsconfig.json

@@ -37,6 +37,8 @@
     ".next/dev/dev/types/**/*.ts"
   ],
   "exclude": [
-    "node_modules"
+    "node_modules",
+    "vscode-extension",
+    "intellij-plugin"
   ]
 }