MindFS provides a remote access gateway for personal AI agents and workstation data, enabling users to interact with their AI sessions and files from anywhere. It targets users of various AI agent CLIs, offering a unified, real-time interface for enhanced productivity and accessibility.

How It Works

MindFS acts as a central hub, automatically detecting and integrating with numerous installed AI agent command-line interfaces. It presents a web-based UI that streams agent outputs token-by-token, rendering tool calls, thought processes, and permission prompts live. The system supports flexible agent switching within a shared context, bidirectional synchronization with external agent sessions, and persistent session binding for recovery. File system browsing, rich media input, and a plugin system for custom file views further enhance interaction.

Quick Start & Requirements

Installation is via a single, cross-platform binary downloaded through shell scripts (Linux/macOS) or PowerShell (Windows), requiring no Node.js or Docker. A key prerequisite is the local installation of at least one compatible AI Agent CLI (e.g., Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot), with setup guides provided. Access is typically through http://localhost:7331. Building from source requires Go 1.22+ and Node.js 20+.

Highlighted Details

• Multi-Agent Integration: Seamlessly connects with a wide array of AI agent CLIs, automatically detecting installed agents.
• Real-time Streaming UI: Live, token-by-token output visualization with structured, collapsible cards for tool calls and agent thoughts.
• Bidirectional Session Sync: Import and resume agent sessions within MindFS, and export MindFS sessions back to agent CLIs.
• Self-Hosted Data Storage: All session history and configuration reside locally in .mindfs/, simplifying backup and migration.
• Extensible Plugin System: Enables custom file viewers and agent interaction loops, including agent-generated plugins.
• Cross-Platform Binary: Single, lightweight binary (<10MB) for macOS, Linux, and Windows with zero host dependencies.
• Flexible Access Modes: Supports local browser access, encrypted remote access via a9gent.com, or direct private network connections.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord or Slack. A "Friend Links" section points to Linux.do.

Licensing & Compatibility

MindFS is licensed under the AGPL v3. This strong copyleft license requires derivative works to be shared under the same terms, potentially impacting integration with proprietary or closed-source systems.

Limitations & Caveats

Requires the prior installation and configuration of one or more AI Agent CLIs. The AGPL v3 license imposes significant obligations on redistribution and modification, which may restrict commercial adoption. Remote access via a9gent.com depends on a third-party service.