Forchetta – one window for all your Claude Code sessions (macOS)

Forchetta, a new Mac application developed by Alessio Donato, serves as a comprehensive control center for Claude Code sessions. The tool consolidates multiple AI assistant sessions into a single interface, providing real-time status updates, side-by-side terminal access, and team management features. Version 0.8.0 of the application allows users to monitor up to four sessions simultaneously, view their current actions, costs, and contexts, and manage permissions from one centralized location.

The application integrates seamlessly with existing Claude Code workflows, offering additional functionality without disrupting established processes. Forchetta operates entirely on the user's Mac, with only the optional Claude API for summaries requiring external connectivity. Installation is streamlined through Homebrew, which brings Node.js and tmux dependencies, while the app itself is built directly on the user's machine using Xcode Command Line Tools.

Key Features

Forchetta's core functionality revolves around session management and visualization. Each running Claude Code session appears as a distinct box displaying its state, current action, summary, context, cache information, and associated costs. The application uses color-coded visual indicators to communicate session status: a slowly pulsing border for working sessions, amber with a breath effect for sessions waiting for user input, green with a check mark for completed turns, and red with a shake for errors.

The tool introduces innovative team management capabilities, allowing users to organize Claude sessions into teams with a lead member and up to six supporting agents. These teams can collaborate by passing requests, answers, and questions among members, with each agent configured to either respond to the lead or execute commands independently. Team members can even work in separate git worktrees, enabling parallel development workflows.

Integration and Usage

Forchetta integrates with Claude Code through hooks that monitor session activities without impacting performance. These hooks track events like SessionStart, SessionEnd, and PermissionRequest, forwarding information to the local daemon. The application maintains compatibility with arricurdAI, another tool that helps manage Claude's context and costs, with Forchetta extending its functionality by displaying session contexts, token counts, and guard badges.

Users can launch Claude Code sessions through Forchetta using the command forchetta run claude, which starts sessions in a private tmux server. This approach allows sessions to continue running even if the terminal window is closed. The application also provides a menu bar icon with the shortcut ⌃⌥F for quick access, and includes features like searching previous sessions, organizing them in groups and roles, and managing permissions through its interface.

Technical Details

Forchetta requires macOS 12 or later and Claude Code (tested with version 2.1.322). The application stores all data in ~/Library/Application Support/Forchetta, ensuring user privacy with read-only permissions. Performance optimizations include reduced animation steps when the window is minimized or covered, and CPU usage stays below 1% at rest. The application works with both Intel and Apple Silicon Macs, with animations running at 60 fps initially before settling at 12 steps per second to maintain smooth performance.

Forchetta is available through GitHub, with installation via Homebrew (brew install alessiodonato/tap/forchetta) or by cloning the repository and building from source. The application is designed to be extensible, with configuration options stored in var/config. and team preferences maintained in var/teams.. Future development may focus on enhanced team collaboration features and deeper integration with Claude's capabilities.