English | 简体中文 | Official Site | Discord | Twitter | 【wechat group】

AI Agent Remote Access Gateway · Result Visualization

Access your personal AI agents and workstation data anywhere, anytime through MindFS.

• Multi-Agent support: Claude Code · OpenAI Codex · Gemini CLI · Cursor · GitHub Copilot · Cline · Augment · Kimi · Kiro · Qwen · Qoder · OMP · Pi · Hermes · Reasonix · OpenCode · OpenClaw — installed agents are detected automatically.
• Real-time streaming: Token-by-token output pushed to the browser; tool calls, thought traces, permission prompts, and remaining context-window capacity are rendered live as structured, collapsible cards.
• Flexible switching: Switch agents or models mid-session; all agents share the same context — no need to re-explain the background.
• Session search: Search by session title or conversation content, then jump straight to the matched session and snippet.
• External session both-way import&synchronization: Browse existing sessions from supported agent CLIs, import one into MindFS, and continue it as a native MindFS session. MindFS session can resumed in agent cli too. Bidirectional synchronization is also possible.
• Binding persistence and recovery: MindFS persists the mapping between its internal session and the underlying agent session, so the link can be restored after service restarts and follow-up messages continue on the same agent session when available.
• Rich media input: Attach files and images directly in your messages.
• Multi-device sync: Access the same instance from multiple devices simultaneously with live session sync.
• Configuration backup and switching: Agent configurations can be backed up and switched with one click, making it easier to move between multiple accounts or API keys.
• Subagents: Codex subagents are automatically discovered and displayed.
• Scheduled tasks: Trigger agents to run tasks at specified times.

• Multiple projects: Manage several directories at once; sessions are organized per project and stay independent.
• Self-hosted data: All conversation history, file metadata, and view config are stored under the project's .mindfs/ subdirectory — migration and backup is just a folder copy.
• File tree browser: Full directory navigation with file preview; Markdown, images, and code all have dedicated renderers.

• / slash commands: Type / to trigger a command palette and quickly run preset operations.
• @ file references: Type @ to trigger path completion and attach any file as context for the agent.
• # quick prompts: Type # to trigger your saved prompt shortcuts inline.
• Bidirectional file–session linking: Jump from a file to the session that created it, or from a session to all files it touched.
• Android, Browser app (PWA): Install to desktop or mobile home screen for a native-like experience — no app store required.
• Mobile-optimized UI: Bottom action bar within thumb reach, independent panel swipe navigation, input box adapts to the soft keyboard.

• Local mode: Accessible in the browser on the local machine immediately after startup — no account or configuration needed.
• Relay remote mode: Access your local instance from anywhere on the public internet without opening firewall ports, via an encrypted tunnel through a9gent.com. Click the bind button in the local UI to activate.
• Private channel: Use a private network (e.g. Tailscale) and access directly via ip:port.
• End-to-end encryption: Sessions and files can be protected with end-to-end encryption.

• Custom views: A plugin is a custom view for a file, following the pattern: receive file content → parse → render UI.
• Agent-generated plugins: Tell the agent "implement a txt novel reader" and it generates the plugin — all txt files are then displayed as a reading experience.
• Interaction loop: Plugins can register action buttons that send structured commands to the agent, completing the loop: customize plugin → browse file → agent interaction.

• Card output: Command results are displayed as cards for clearer reading.
• History suggestions: Matching previous commands automatically appear as suggestions for quick input.
• Screen-width adaptation: Command output adapts to the screen width for a friendlier result view.
• Selectable shell type: Choose the shell used for command execution, so Windows users do not need to worry about shell type mismatches.
• Session persistence: Each session gets a long-lived shell, making tmux-like command continuity easier.

• Single binary: The production build is a statically compiled binary with all web assets embedded, and the install package is under 10 MB.
• Zero dependencies: No Node.js, Docker, or daemon manager required on the host.
• Cross-platform: macOS (Intel + Apple Silicon), Linux (x86-64, ARM64, ARMv7), Windows (x86-64, ARM64).

MindFS does not include any AI model — you need at least one Agent CLI installed locally. Choose what works for you:

MindFS also collects commonly used agents in the local UI. Open the file-tree menu, choose Agent Install & Update, then use the generated install/update commands for your platform. The commands are launched in MindFS command mode so you can review and run them from the same workspace.

Once an agent is installed, start MindFS and interact with it through the browser.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.sh | bash

Custom install path:

curl -fsSL https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.sh | bash -s -- --prefix your/path

Windows (PowerShell)

irm https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.ps1 | iex

The install script auto-detects your OS and architecture, reads the latest version from the first line of release-notes.md, then downloads the matching binary from GitHub Releases. release-notes.md keeps release history with the newest entry at the top; make release TAG=v1.2.3 commits and pushes it when changed, then uses only the top entry as the GitHub release notes.

The uninstall command removes the installed binary, bundled web assets, bundled default agents.json, and the PATH entry added by the installer. User config and project .mindfs/ data are kept by default.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.sh | bash -s -- --uninstall

Windows (PowerShell)

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.ps1))) -Uninstall

To also remove user-level MindFS config and logs, add --purge on macOS/Linux or -Purge on Windows. Project .mindfs/ directories are never removed automatically.

Build from source (requires Go 1.22+, Node.js 20+)

git clone https://github.com/a9gent/mindfs.git
cd mindfs
make build      # output: ./mindfs

mindfs                        # manage current directory
mindfs /path/to/your/project  # manage a specific directory
mindfs -addr :9000 /path/to/your/project  # custom port

Open http://localhost:7331 in your browser.

Enable HTTPS with a self-signed certificate (auto-generated and reused across restarts):

mindfs -tls
mindfs -tls -addr :9000 /path/to/your/project

Open https://localhost:7331 in your browser. The auto-generated certificate includes SANs for localhost, 127.0.0.1, ::1, and all non-loopback interface IPs, so LAN clients can connect without certificate name mismatches. Certificates are stored under the user config directory (e.g., ~/.config/mindfs/ on Linux).

Use custom certificate and key files:

mindfs -tls -cert /path/to/cert.pem -key /path/to/key.pem

MindFS automatically detects the availability of installed agents. This usually takes about one minute.

1. Open MindFS in local mode and click the bind button in the bottom-left corner.
2. Log in to a9gent.com and confirm the binding.
3. Open your node — it is now accessible from any device.

MindFS can load an extra agents.json for agent CLIs that speak the ACP protocol. This is useful when you are testing a new agent or want to keep project-specific agent definitions outside the bundled defaults.

{
  "agents": [
    {
      "name": "my-agent",
      "brief": "Short description shown in the install/update list.",
      "command": "my-agent",
      "protocol": "acp",
      "args": ["--acp"]
    }
  ]
}

Start MindFS with the extra config:

mindfs -agent-config /path/to/agents.json

The extra file can add new agents or override a bundled definition with the same name.

mindfs [flags] [root]

root is the directory to manage. If omitted, MindFS opens without adding a directory.

By default, mindfs starts or reuses a background service and opens the browser. Pass root to register a directory; if a service is already running on the selected address, the command reuses it and adds that directory.

mindfs
mindfs /path/to/project
mindfs -addr :9000 /path/to/project
mindfs -foreground /path/to/project
mindfs -status
mindfs -version
mindfs -update
mindfs -uninstall
mindfs -stop
mindfs -restart
mindfs -remove /path/to/project
mindfs -agent-config /path/to/agents.json

Pull requests are welcome. For larger changes, please open an issue first to discuss the approach.

AGPL v3

Linux.do