Foxpit — Multi-Agent Cockpit for Claude Code, Codex & OpenCode

Foxpit is an open-source desktop application that serves as a multi-agent cockpit for terminal-based coding agents including Claude Code, OpenAI Codex, and OpenCode. By running multiple AI coding agents simultaneously in real terminal emulators and visualizing their live operational states inside an isometric 3D office, Foxpit gives software engineers instant approval-at-a-glance visibility. A lead orchestrator agent coordinates parallel sub-agents across isolated git worktree checkouts, delegating sub-tasks to lighter models to conserve token quotas and prevent codebase collisions. Local-only event transport (127.0.0.1) with zero telemetry, and no Node.js installation required.

---

Table of Contents

• Why Foxpit?
• Screenshots
• Key Features
• Quickstart & Installation
• Guides & Documentation
• Comparison with Alternatives
• Privacy & Security
• Local Development
• License & Credits

---

Why Foxpit?

1. See all coding agents in one cockpit: Stop getting lost in dozens of scattered terminal tabs and multiplexer splits. Monitor your entire fleet of autonomous agents from a unified visual dashboard.
2. Catch approval prompts immediately: When an agent pauses to request permission for file edits or shell execution, Foxpit pulses the operating system taskbar and raises a desk banner in the 3D office.
3. Conserve API quotas via orchestrator delegation: A primary orchestrator agent (for example, a flagship Claude model) designs architecture and breaks down goals, delegating repetitive code writing, linting, and tests to sub-agents running cheaper models.
4. Conflict-free parallel execution: Each agent can run inside its own isolated Git worktree branch, so parallel agents do not overwrite each other's work or fight over the Git index.
5. Local-only event transport: Event hooks communicate over your local loopback interface (127.0.0.1) and the app sends no telemetry. Note that the coding agents you run inside Foxpit still talk to their own model providers.

---

Screenshots

3D Mascot Office & Live Activity

Track agent activities (thinking, reading, writing, waiting for approval) via desk mascots.

Customizable Office & Room Editor

Arrange furniture, snap desks into place, and design dedicated workspace clusters for frontend, backend, and testing agents.

Git Worktree Isolation per Agent

Spawn agents on dedicated branches with directory sandboxing, diff reviews, and clean merging.

---

Key Features

• Embedded Native Terminals (node-pty + xterm): Full terminal emulation with ANSI color support, tabbed management, and direct keyboard input.
• 3D Spatial Visualization (Three.js): Isometric office with expressive mascots representing real-time LLM states: working, thinking, waiting for approval, stuck, idle, done, or error.
• Automated Git Worktrees: Optional per-agent worktree provisioning (git worktree add) keeps parallel agents from conflicting over shared files.
• One-Click Hook Setup ("Connect All"): Automatically writes lightweight hook scripts for Claude Code, Codex, and OpenCode. Reuses the app's bundled Electron/Node runtime, so no system Node.js install is needed.
• Token & Context Monitoring: Each agent card shows a context-usage bar and a cumulative token counter, and a persistent ledger records tasks, tool calls, and estimated cost/savings.
• Cross-Platform & Local-First: Windows (x64 .exe), macOS (.dmg, unsigned), and Linux (AppImage). All event communication uses loopback (127.0.0.1).
• Auto-Updates: Checks and applies stable updates directly from GitHub Releases.

---

Quickstart & Installation

Download the latest pre-built packages from GitHub Releases or visit the official Website & Docs.

Windows

• Download Foxpit-Setup-<version>.exe and run the installer.
• A desktop shortcut and Start menu entry will be created.
• Note: Foxpit is not signed with a Windows code-signing certificate yet, so SmartScreen may show "Windows protected your PC". Click More info → Run anyway.
• Prefer the installer over the portable .exe: only the installed app updates itself.

macOS

• Download Foxpit-<version>.dmg, open it, and drag Foxpit to your Applications folder.
• Note: Because Foxpit is community open source and not signed with an Apple developer certificate, on first launch right-click the app icon, select Open, and confirm.

Linux

• Download Foxpit-<version>.AppImage, make it executable, and run:

  chmod +x Foxpit-*.AppImage
  ./Foxpit-*.AppImage

First Run (5 Minutes)

1. Ensure CLI Agents Are Installed: Ensure claude, opencode, or codex are available in your path.
2. Launch Foxpit: Open the application.
3. Click "Connect All": Foxpit registers the local hook scripts in ~/.claude/hooks/ and CLI config paths.
4. Open a Git Repository: Select your project folder.
5. Start Orchestrating: Open an orchestrator terminal, spawn sub-agents into isolated worktrees, and supervise their progress in the 3D office!

---

Guides & Documentation

In-depth technical guides for maximizing speed, safety, and quota efficiency:

• Quickstart & Getting Started Guide
• How to Run Multiple Claude Code Agents in Parallel
• Save Claude Quota with Multi-Agent Orchestration
• Git Worktrees for AI Coding Agents: Practical Engineering Guide
• Frequently Asked Questions (FAQ)

---

Comparison with Alternatives

The multi-agent tooling space moves quickly, so specific third-party features and licenses go stale fast. Instead of listing claims about other projects that may no longer be accurate, the Ecosystem Comparison explains the common approaches — embedded terminals, terminal multiplexers, web dashboards, and kanban task boards — and where Foxpit fits.

---

Privacy & Security

• Strict Loopback (127.0.0.1): All IPC and hook communications bind only to local loopback.
• Sensitive Value Masking: Values that look like keys, tokens, or passwords are masked in agent status text and in error reports.
• Zero Telemetry: No usage analytics, tracking pixels, or diagnostic logs are sent over the network. The only outbound request the app itself makes is an update check against GitHub Releases.

---

Local Development

To contribute or build Foxpit from source:

# Clone the repository
git clone https://github.com/lordon1a/foxpit.git
cd foxpit

# Install dependencies (Node.js 22+ recommended)
npm install

# Run unit tests
npm test

# Run SEO & static integrity audits
node scripts/seo_check.mjs

# Start in development mode
npm start

# Build production distributables (outputs to dist/)
npm run dist

---

License & Credits

• Source Code: MIT License © Foxpit Contributors.
• Application Bundling: The program source is MIT-licensed, but some bundled art assets have their own licenses. In particular, the base mascot model is derived from the "Autonomous Characters Lab" character by Arturo Paracuellos (unboring.net) under CC BY-NC 4.0 (non-commercial), so the project as a whole is not intended for commercial use. The app's About window lists all third-party assets (app/ucuncu_taraf.json).
• 3D Furniture Assets: Kenney Furniture Kit and KayKit Furniture Bits (both CC0).
• 3D Engine: three.js (MIT License).