Skip to content

The-Banana-Standard/forge

Forge

Forge

A desktop workspace manager and terminal multiplexer for Claude Code CLI sessions.

Features · Installation · Development · Contributing


Forge is a Tauri v2 desktop app that lets you manage project folders, launch Claude Code sessions and shell terminals against them, and keep everything organized in workspaces. Everything runs locally -- no external APIs, no cloud dependencies.

Features

  • Workspace management -- Group projects into workspaces and switch between them
  • Terminal multiplexer -- Run multiple Claude Code sessions and shell terminals side by side with split view
  • Session history -- Browse past Claude Code sessions per project
  • Skills manager -- Install, uninstall, and browse Claude Code slash-command skills
  • Daily planner -- Built-in task management to track your work
  • GitHub dashboard -- View issues and PRs for your projects via the GitHub CLI
  • Dark theme -- Purpose-built dark UI designed for long coding sessions

Installation

Pre-built releases

Download the latest release for your platform from the Releases page.

Platform File
macOS (Apple Silicon) Forge_x.x.x_aarch64.dmg
macOS (Intel) Forge_x.x.x_x64.dmg
Windows Forge_x.x.x_x64-setup.exe
Linux (Debian/Ubuntu) Forge_x.x.x_amd64.deb
Linux (other) Forge_x.x.x_amd64.AppImage

macOS users: The app is code-signed and notarized. If you installed an older version and macOS shows "Forge is damaged and can't be opened", run:

xattr -cr /Applications/Forge.app

Build from source

Prerequisites:

git clone https://github.com/The-Banana-Standard/forge.git
cd forge
npm install
npm run tauri build

The built application will be in src-tauri/target/release/.

Development

# Run in development mode (hot reload)
npm run tauri dev

# Run frontend tests
npm test

# Run Rust tests
cargo test --manifest-path src-tauri/Cargo.toml

# Frontend-only dev server (no Tauri shell, limited use)
npm run dev

The Vite dev server runs on port 1420 with HMR enabled.

Architecture

Forge is built with:

  • Backend: Rust (Tauri v2, portable-pty, tokio)
  • Frontend: React 19, TypeScript (strict), xterm.js v6
  • Storage: SQLite via tauri-plugin-sql
  • Build: Vite 7, Cargo

See CLAUDE.md for detailed architecture documentation.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for setup instructions and guidelines.

Security

To report a vulnerability, please see SECURITY.md.

License

MIT

About

Desktop workspace manager and terminal multiplexer for Claude Code CLI sessions

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors