v0.14.0

Session state persistence, Claude Code auto-resume

• Session persistence - When you close a project window, all session state (names, running status, info cards) is saved. Reopening the project restores sessions exactly as they were.
• Claude Code auto-resume - ForgeTerm auto-detects Claude Code sessions running in your terminals. On restore, they resume automatically with claude -r <session-id> - no manual setup needed.
• Cmd+W fix - Properly deletes sessions (previously only stopped the PTY without cleaning up).
• Active session tracking - Remembers which session was focused when you closed the window.
• Saved state is one-time use (cleared after restore) so config changes still apply on fresh opens.
• Stale saved sessions auto-clean after 7 days.

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.13.0

CLI session rename, info cards, sidebar info popover

• forgeterm rename "name" - Rename the current terminal session from the CLI. Ideal for AI agents (Claude Code) to label sessions by task.
• forgeterm info - Update a session info card with title, summary, last action, and optional action item. Shown in the sidebar via an info popover.
• Sidebar info popover - Click the info icon on a session to see its context card (what's happening, last action, action items needing attention).
• Session context types - New SessionContext type shared between main process and renderer.

These features enable a richer Claude Code <-> ForgeTerm integration where AI sessions are self-documenting.

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.12.0

What's New

• Tray menu workspace grouping - Control menu now shows Workspace -> Project -> Sessions hierarchy. Click a workspace name to open/tile all its projects. Closed workspaces are listed for quick launch.
• Remote access hardening - Cloudflared binary resolved by checking known paths (no longer depends on Electron's PATH). Automatic retry on tunnel failure, increased timeout (30s), specific error messages.
• Remote access logs - All cloudflared output captured with timestamps. Collapsible log viewer in the modal - auto-opens on failure, always available when running.
• Search improvements - Shows match count ("3 of 12" or "No results"). Starts from the bottom (most recent output first).
• PATH fix - Electron main process augments PATH at startup with Homebrew locations so external binaries (cloudflared, etc.) are always found.

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.11.0

Terminal search, session delete shortcut, scroll improvements

• Cmd+F: Search within terminal - find text with next/prev navigation
• Cmd+W: Close/delete current session (picks adjacent session automatically)
• Fix: White screen when deleting a session (forced terminal re-render on visibility change)
• Fix: Session selection on delete now picks the adjacent session instead of jumping to first
• Scroll: Scrolling up with mouse/trackpad now reliably cancels stick-to-bottom during rapid output
• UI: "Follow" button with label on scroll controls for clearer intent

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.10.2

Remote Access Security Hardening (Round 2)

• Fix WebSocket connection limit bypass - counter double-decremented on error+close, permanently disabling the 5-connection limit
• Content-Security-Policy - restricts scripts to self + cdn.jsdelivr.net, blocks injected scripts
• WebSocket message size limit - rejects messages over 64KB to prevent memory exhaustion
• Resize validation - bounds-check terminal cols (1-500) and rows (1-200)
• PIN always required - removed PIN from QR code URL, must be entered manually every time

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.10.1

Remote Access Security Hardening

• PIN-based auth - 4-digit PIN replaces long token, regenerated each session
• Random session path - all routes behind /s/<random>/, tunnel URL alone returns 404
• Secure PIN transport - PIN in URL hash fragment (never sent to server or logged by proxies)
• Cookie-only auth - HttpOnly, Secure, SameSite=Strict, path-scoped cookies
• Aggressive rate limiting - global (20/min) + per-IP (5/min) using CF-Connecting-IP
• WebSocket connection limit - max 5 concurrent connections
• No client-side storage - removed localStorage, auth handled entirely via cookies

Bug Fixes

• Fix WebGL addon _isDisposed crash during HMR/terminal teardown
• Fix __dirname is not defined in remote server (ESM compatibility)

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.10.0

What's New

• Remote Access - Control your terminal sessions from your phone or any browser. Starts a local web server with a Cloudflare tunnel, protected by token auth. Scan the QR code to connect. (Hidden feature - enable from sidebar radar icon)
• Session Activity Detection - Sessions now show idle/working/unread status with visual indicators in the sidebar
• Finder Integration - Right-click folders in Finder to open in ForgeTerm as a project or workspace
• Workspace Editing - New modal for editing workspace settings
• CLI Enhancements - Additional CLI commands and improvements
• Help Updates - Expanded help documentation

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.9.0

What's New

• Sticky scroll - Terminal stays pinned to the bottom during long sessions (e.g. Claude Code). If you scroll up to read, it respects your position. Fixes the annoying scroll-to-top issue during resize/reflow.
• CLI status indicator - The CLI button in the sidebar now shows a colored dot:
  • Green: CLI installed and server running
  • Orange: CLI not yet installed
  • Red: Server error (with one-click restart from the modal)
• CLI modal per state - Clicking the CLI button shows context-aware content: install flow, command reference, or error diagnostics depending on the current status.

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.8.0

What's New

• CLI commands - forgeterm open <path> to open projects, forgeterm list to see recent projects, forgeterm help for full usage
• Homebrew support - Install the app via brew install --cask codama-dev/tap/forgeterm or just the CLI via brew install codama-dev/tap/forgeterm-cli
• Check for Updates - New menu item under ForgeTerm menu to manually check for updates, shows "up to date" or the update banner
• CLI sidebar button - 5th button in sidebar opens CLI tool modal with command reference and copyable AI prompt
• About dialog - Now shows Codama credit with link to codama.dev
• Arrangement centering - Workspace screen arrangement preview is now centered
• Smarter AI prompt - Notification prompt includes success/failure pattern for long-running tasks

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.

v0.7.0

What's New

• Project switcher tabs - Recent (default), Workspaces, Projects, All - with Recent showing both workspaces and projects sorted by last opened
• Workspace arrangement preview - Spatial screen map showing your actual display layout with tile distribution inside each screen
• Drag-to-reorder - Drag workspace project tags to control which window goes where (A, B, C order determines tile placement)
• Screen hover highlight - Hover a screen in the map to flash a colored overlay on the actual physical display
• Quick session button - "+" button below session list for instant shell sessions without a modal
• CLI install prompt - After installing the CLI, shows a copyable AI notification prompt for CLAUDE.md
• Arrangement help - "?" icon on workspaces explains how drag-to-reorder, screen selection, and tiling work

Install

Homebrew (recommended):

# App (macOS, Apple Silicon)
brew install --cask codama-dev/tap/forgeterm

# CLI only
brew install codama-dev/tap/forgeterm-cli

Manual: Download the DMG below, drag to Applications, then run:

xattr -cr /Applications/ForgeTerm.app

This is needed for unsigned apps - code signing coming soon.