[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83699":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":17,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":10,"trendingCount":16,"starSnapshotCount":16,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},83699,"mindfs","a9gent\u002Fmindfs","a9gent","Access your personal AI agents and workstation data anywhere, anytime through MindFS.","https:\u002F\u002Fx.com\u002Fyandc18",null,"TypeScript",1113,75,1,19,0,91,273,18.64,"GNU Affero General Public License v3.0",false,"main",[],"2026-06-12 02:04:35","# MindFS\n\n[English](.\u002FREADME.md) | [简体中文](.\u002FREADME.zh.md)\n\n> **AI Agent Remote Access Gateway · Result Visualization**\n\nAccess your personal AI agents and workstation data anywhere, anytime through MindFS.\n\n---\n\n## Screenshots\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fimages\u002Fmindfs-desktop.webp\" alt=\"MindFS desktop UI\" width=\"92%\" \u002F>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fimages\u002Fmindfs-mobile.webp\" alt=\"MindFS mobile UI\" width=\"92%\" \u002F>\n\u003C\u002Fp>\n\n---\n\n## Features\n\n### Agent Sessions\n\n- **Multi-Agent support**: Claude Code · OpenAI Codex · Gemini CLI · Cursor · GitHub Copilot · Cline · Augment · Kimi · Kiro · Qwen · Qoder · OMP · Pi · Hermes · OpenCode · OpenClaw — installed agents are detected automatically.\n- **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.\n- **Flexible switching**: Switch agents or models mid-session; all agents share the same context — no need to re-explain the background.\n- **Session search**: Search by session title or conversation content, then jump straight to the matched session and snippet.\n- **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.\n- **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.\n- **Rich media input**: Attach files and images directly in your messages.\n- **Multi-device sync**: Access the same instance from multiple devices simultaneously with live session sync.\n- **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.\n- **Subagents**: Codex subagents are automatically discovered and displayed.\n\n### File Access\n\n- **Multiple projects**: Manage several directories at once; sessions are organized per project and stay independent.\n- **Self-hosted data**: All conversation history, file metadata, and view config are stored under the project's `.mindfs\u002F` subdirectory — migration and backup is just a folder copy.\n- **File tree browser**: Full directory navigation with file preview; Markdown, images, and code all have dedicated renderers.\n\n### Interaction\n\n- **`\u002F` slash commands**: Type `\u002F` to trigger a command palette and quickly run preset operations.\n- **`@` file references**: Type `@` to trigger path completion and attach any file as context for the agent.\n- **`#` quick prompts**: Type `#` to trigger your saved prompt shortcuts inline.\n- **Bidirectional file–session linking**: Jump from a file to the session that created it, or from a session to all files it touched.\n- **Android, Browser app (PWA)**: Install to desktop or mobile home screen for a native-like experience — no app store required.\n- **Mobile-optimized UI**: Bottom action bar within thumb reach, independent panel swipe navigation, input box adapts to the soft keyboard.\n\n### Access Modes\n\n- **Local mode**: Accessible in the browser on the local machine immediately after startup — no account or configuration needed.\n- **Relay remote mode**: Access your local instance from anywhere on the public internet without opening firewall ports, via an encrypted tunnel through [a9gent.com](https:\u002F\u002Fa9gent.com). Click the bind button in the local UI to activate.\n- **Private channel**: Use a private network (e.g. Tailscale) and access directly via `ip:port`.\n- **End-to-end encryption**: Sessions and files can be protected with end-to-end encryption.\n\n### Plugin System\n\n- **Custom views**: A plugin is a custom view for a file, following the pattern: receive file content → parse → render UI.\n- **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.\n- **Interaction loop**: Plugins can register action buttons that send structured commands to the agent, completing the loop: customize plugin → browse file → agent interaction.\n\n### Command Execution\n\n- **Card output**: Command results are displayed as cards for clearer reading.\n- **History suggestions**: Matching previous commands automatically appear as suggestions for quick input.\n- **Screen-width adaptation**: Command output adapts to the screen width for a friendlier result view.\n- **Selectable shell type**: Choose the shell used for command execution, so Windows users do not need to worry about shell type mismatches.\n- **Session persistence**: Each session gets a long-lived shell, making tmux-like command continuity easier.\n\n### Installation\n\n- **Single binary**: The production build is a statically compiled binary with all web assets embedded, and the install package is under 10 MB.\n- **Zero dependencies**: No Node.js, Docker, or daemon manager required on the host.\n- **Cross-platform**: macOS (Intel + Apple Silicon), Linux (x86-64, ARM64, ARMv7), Windows (x86-64, ARM64).\n\n---\n\n## Quick Start\n\n### Prerequisites\n\nMindFS does not include any AI model — you need at least one Agent CLI installed locally. Choose what works for you:\n\n| Agent | Install |\n|-------|---------|\n| **Claude Code** | https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fquickstart |\n| **OpenAI Codex** | https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli |\n| **Gemini CLI** | https:\u002F\u002Fgeminicli.com\u002F |\n| **Cursor** | https:\u002F\u002Fcursor.com\u002Fcn\u002Fcli |\n| **GitHub Copilot** | https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot\u002Fcli |\n| **Cline** | https:\u002F\u002Fcline.bot\u002Fkanban |\n| **Augment** | https:\u002F\u002Fwww.augmentcode.com\u002Fproduct\u002FCLI |\n| **Kiro** | https:\u002F\u002Fkiro.dev\u002Fcli\u002F |\n| **OpenCode** | https:\u002F\u002Fopencode.ai\u002F |\n| **OpenClaw** | https:\u002F\u002Fdocs.openclaw.ai\u002F |\n| **Kimi** | https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fdocs\u002Fkimi-cli\u002Fguides\u002Fgetting-started.html |\n| **Qwen** | https:\u002F\u002Fqwen.ai\u002Fqwencode |\n| **Qoder** | https:\u002F\u002Fdocs.qoder.com\u002Fcli\u002Fquick-start |\n| **OMP** | https:\u002F\u002Fgithub.com\u002Fcan1357\u002Foh-my-pi (`omp acp`) |\n| **Pi** | https:\u002F\u002Fgithub.com\u002Fbadlogic\u002Fpi-mono\u002Ftree\u002Fmain\u002Fpackages\u002Fcoding-agent, and acp adatper: https:\u002F\u002Fgithub.com\u002Fsvkozak\u002Fpi-acp |\n| **Hermes** | https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Facp |\n\nOnce an agent is installed, start MindFS and interact with it through the browser.\n\n### Install\n\n**macOS \u002F Linux**\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fa9gent\u002Fmindfs\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\nCustom install path:\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fa9gent\u002Fmindfs\u002Fmain\u002Fscripts\u002Finstall.sh | bash -s -- --prefix your\u002Fpath\n```\n\n**Windows (PowerShell)**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fa9gent\u002Fmindfs\u002Fmain\u002Fscripts\u002Finstall.ps1 | iex\n```\n\nThe install script auto-detects your OS and architecture, reads the latest version from the first line of [`release-notes.md`](https:\u002F\u002Fraw.githubusercontent.com\u002Fa9gent\u002Fmindfs\u002Fmain\u002Frelease-notes.md), then downloads the matching binary from [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fa9gent\u002Fmindfs\u002Freleases). `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.\n\n**Build from source** (requires Go 1.22+, Node.js 20+)\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fa9gent\u002Fmindfs.git\ncd mindfs\nmake build      # output: .\u002Fmindfs\n```\n\n### Run\n\n```bash\nmindfs                        # manage current directory\nmindfs \u002Fpath\u002Fto\u002Fyour\u002Fproject  # manage a specific directory\nmindfs -addr :9000 \u002Fpath\u002Fto\u002Fyour\u002Fproject  # custom port\n```\n\nOpen [http:\u002F\u002Flocalhost:7331](http:\u002F\u002Flocalhost:7331) in your browser.\n\n#### HTTPS (TLS)\n\nEnable HTTPS with a self-signed certificate (auto-generated and reused across restarts):\n\n```bash\nmindfs -tls\nmindfs -tls -addr :9000 \u002Fpath\u002Fto\u002Fyour\u002Fproject\n```\n\nOpen [https:\u002F\u002Flocalhost:7331](https:\u002F\u002Flocalhost: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., `~\u002F.config\u002Fmindfs\u002F` on Linux).\n\nUse custom certificate and key files:\n\n```bash\nmindfs -tls -cert \u002Fpath\u002Fto\u002Fcert.pem -key \u002Fpath\u002Fto\u002Fkey.pem\n```\n\nMindFS automatically detects the availability of installed agents. This usually takes about one minute.\n\n### Enable Remote Access (Optional)\n\n1. Open MindFS in local mode and click the bind button in the bottom-left corner.\n2. Log in to [a9gent.com](https:\u002F\u002Fa9gent.com) and confirm the binding.\n3. Open your node — it is now accessible from any device.\n\n### CLI Reference\n\n```bash\nmindfs [flags] [root]\n```\n\n`root` is the directory to manage. If omitted, MindFS opens without adding a directory.\n\nBy 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.\n\n#### Common Commands\n\n```bash\nmindfs\nmindfs \u002Fpath\u002Fto\u002Fproject\nmindfs -addr :9000 \u002Fpath\u002Fto\u002Fproject\nmindfs -foreground \u002Fpath\u002Fto\u002Fproject\nmindfs -status\nmindfs -version\nmindfs -stop\nmindfs -restart\nmindfs -remove \u002Fpath\u002Fto\u002Fproject\n```\n\n#### Flags\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `-addr string` | `127.0.0.1:7331` | Listen address. Use `:7331` or `0.0.0.0:7331` to allow LAN access. |\n| `-foreground` | `false` | Run the server in the foreground instead of starting a background service. |\n| `-status` | `false` | Show background service status, PID, URL, and log file path. |\n| `-version` | `false` | Show the current MindFS version. |\n| `-stop` | `false` | Stop the background service for the selected address. |\n| `-restart` | `false` | Stop the background service if present, then start it again. |\n| `-remove` | `false` | Remove `root` from the managed directory list. If the server is running, it is removed through the local API; otherwise it is removed from the local registry. |\n| `-no-relayer` | `false` | Disable relay integration. Local and private-network access still work. |\n| `-e2ee` | `false` | Enable end-to-end encryption for sensitive data. The pairing code can also be used as an authentication mechanism: unpaired frontends cannot access node content. LAN access requires `-tls` to work correctly. On first enablement, the CLI prints the pairing secret. |\n| `-tls` | `false` | Enable HTTPS. If `-cert` and `-key` are not provided, MindFS generates and reuses a local self-signed certificate. |\n| `-cert string` | empty | TLS certificate file in PEM format. Used with `-tls`; auto-generated when empty. |\n| `-key string` | empty | TLS private key file in PEM format. Used with `-tls`; auto-generated when empty. |\n\n---\n\n## Contributing\n\nPull requests are welcome. For larger changes, please open an issue first to discuss the approach.\n\n\n---\n\n## License\n\n[AGPL v3](LICENSE)\n\n## Friend Links\n\u003Ca href=\"https:\u002F\u002Flinux.do\">Linux.do\u003C\u002Fa>\n",2,"2026-06-11 04:11:27","high_star"]