Fozikio

Getting Started

Fozikio is a local-first desktop app for developers who manage multiple projects. It reads your filesystem, shows git status across all your repos, and gives you a single dashboard to stay on top of everything.

Requirements

  • Node.js 18 or later
  • Git installed and available in your PATH
  • Windows, macOS, or Linux

Install from Source

Fozikio is currently in early preview (v0.1). Pre-built binaries are coming with v0.2. For now, you can build from source:

git clone https://github.com/idapixl/Fozikio.git
cd Fozikio
npm install
npm run dev

This starts the Electron app in development mode with hot reload.

Building for Production

npm run build

This creates a production build in the dist/ directory. On Windows, this generates a portable .exe and an NSIS installer.

First Launch

When you first open Fozikio:

  1. Add a projects folder — Click the add folder button and point it at your ~/projects directory (or wherever you keep your repos).
  2. Wait for scanning — Fozikio will auto-discover repos, detect project types, and index file metadata. This happens locally and usually takes a few seconds.
  3. Explore — Use the sidebar to browse projects, check git status, view files, and run scripts.

Key Shortcuts

| Shortcut | Action | |----------|--------| | Ctrl+K | Command palette | | Ctrl+Shift+F | Focus mode | | Ctrl+J | Scratch pad | | Ctrl+, | Settings |

Next Steps