Skip to content

About

Local-first multi-pane voice-enabled file manager (sister to ZeroG Terminal)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

63 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZeroG FileMan

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

Quick start (dev)

npm install
npm run build
npm start

npm 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 start

Checks:

npm run typecheck
npm test
npm run build

Packaged Windows build

npm run package:win

Artifacts 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).

Updates

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.

What it does

  • 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

Docs

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

License

MIT. Bundled fonts are under the SIL Open Font License; see THIRD-PARTY-NOTICES.md.

About

Local-first multi-pane voice-enabled file manager (sister to ZeroG Terminal)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages