Local-first, multi-pane developer file manager with dual voice jewels per pane (Navigate / Action). Sister to ZeroG Terminal and ZeroG SFTP — greenfield app, not a fork.
Repo: HappyMonkeyAI/ZeroGFileMan
npm install
npm run build
npm startnpm start launches the local Electron binary via scripts/start-electron.mjs (avoids the Electron CLI re-download hang).
Dev (main watch + Vite on 127.0.0.1:5174):
npm run dev
# other terminal:
npm startChecks:
npm run typecheck
npm test
npm run buildnpm run package:winArtifacts land in release/:
ZeroGFileMan-<version>-Setup.exe— NSIS installer (choose install dir)ZeroGFileMan-<version>-Portable.exe— portable single file
Packaged builds are Windows x64 only for now.
Unsigned builds. The executables are not code-signed, so Windows SmartScreen will show "Windows protected your PC" the first time you run one. Choose More info → Run anyway, or build from source if you'd rather not trust a downloaded binary.
Signing is off (signAndEditExecutable: false). App id: com.happymonkeyai.zerogfileman. Window/installer icon lives in build/ (npm run icon:render regenerates png/ico from the SVG).
The app checks GitHub releases about eight seconds after launch, unless you switch Settings → Updates to Manual or run an unpackaged development build.
- NSIS install: the prompt can download the signed
latest.yml-checked installer, then install it when you explicitly choose Install and restart. - Portable executable: the app cannot safely replace itself, so the prompt only opens the release page.
- Development or npm-installed builds: update checks are disabled.
Nothing downloads or installs without explicit consent. Later hides the prompt until the next check; Skip this version hides it until a newer release appears or you clear the skipped version in Settings. Pushing a v* tag runs .github/workflows/release.yml, which publishes the two Windows executables, the installer blockmap, and latest.yml.
- Dual local panes with breadcrumbs, history (Alt+←/→), favorites, Ctrl+K jump
- Favorites bar with direct open, rename, remove, and an add/remove toggle for the active path
- CRUD + cross-pane clipboard; F5/F6 copy/move to the other pane
- File-type associations: apps in your development store that declare file associations are detected automatically; pick a default app per extension or add any program in Settings → File apps
- Per-pane Navigate / Action jewels: click-toggle or hold-to-talk; Esc cancels
- Speech engines: demo transcript, builtin Whisper (Transformers.js), or OpenAI-compatible server (API key in OS safeStorage)
- Consent-based Windows update checks through the GitHub releases API
| File | Role |
|---|---|
| CONTEXT.md | Stack, rules, architecture |
| AGENTS.md | Agent workflow + Spine |
| SPEC.md | Acceptance |
| ROADMAP.md | Next slices (layouts, view modes, CI) |
| MCP.md | Intent → MCP routing |
| docs/adr/ | Decisions |
| CONTRIBUTING.md | How to build, test and send a PR |
| SECURITY.md | Reporting vulnerabilities; what leaves your machine |
MIT. Bundled fonts are under the SIL Open Font License; see THIRD-PARTY-NOTICES.md.