fanbox  by alchaincyf

A local cockpit for AI-assisted development and agent activity

Created 1 month ago
910 stars

Top 39.2% on SourcePulse

GitHubView on GitHub
Project Summary

FanBox consolidates AI development workflows by integrating file browsing, an embedded terminal for agent interaction, and change previews into a single window. It targets developers managing scattered AI-generated projects, offering a streamlined "cockpit" to enhance discoverability and track AI modifications efficiently.

How It Works

The application features a dual-pane UI: file navigation/previews on the left, and a real embedded terminal for AI agents on the right/bottom. Its core innovation is visualizing AI activity via a "live dashboard" that highlights agent-modified files with dynamic animations, complemented by session replay and project memory. FanBox is local-first, zero-configuration, and has no runtime dependencies, focusing on the AI agent interaction loop.

Quick Start & Requirements

  • Desktop (Recommended): Download .dmg from Releases; drag to Applications. Native Apple Silicon (arm64) required.
  • Web: Run node server.js (http://localhost:4567). Zero dependencies, zero build. Limited to file browsing/search/preview.
  • Development: Node.js required. npm install, then npm run app (desktop) or npm run dist (package).

Highlighted Details

  • Three Skins: Distinct UI themes (Volt, Archive, Index) altering colors, typography, icons, and code/terminal themes.
  • Live Agent Change Visualization: Agent-written files trigger animated ripples/glows, showing modification frequency and location.
  • Session Replay: Timeline scrubbing to review agent file modifications step-by-step.
  • Project Memory: Stores AI interaction history per project, with a "resume" capability.
  • AI Organize: Proposes file organization actions based on metadata, with user approval and rollback. Supports Claude Code/Codex.
  • Real Embedded Terminal: Uses node-pty/xterm.js (WebGL) supporting drag-and-drop paths, clickable paths, and selection-to-terminal input.
  • WYSIWYG Editors: Milkdown Crepe (Markdown), Monaco Editor (code/JSON), image annotation.

Maintenance & Community

Developed by indie developer 花叔 Huashu. No explicit community channels listed, but the author has a social media presence. Built-in update notifications are provided.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: The MIT license permits broad commercial use and integration into closed-source projects. The desktop application is Apple Silicon native.

Limitations & Caveats

The primary desktop application is built for Apple Silicon. The web version omits the embedded terminal and editors. FanBox is specialized for AI agent interaction workflows and does not aim to replace comprehensive IDEs or file management tools.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
20
Issues (30d)
25
Star History
738 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.