~/flowgit/engine --mode=production --target=win64

ENGINEERING-NATIVE GIT CLIENT

TOPOLOGICAL GIT GRAPH.
BLUEPRINT PRECISION.

FlowGit replaces archaic commit ladders with an interactive, node-based DAG visual engine. Spawns authentic Git binaries through safe argument arrays with zero shell string interpolation, yielding instantaneous diffs, porcelain-v1 staging, and SQLite WAL caching for massive enterprise repositories.

Download on GitLab (Recommended) → GitHub Mirror ↗ ARTIFACTS: Portable .exe • Compiled Binaries .zip ↓

ZERO SHELL STRINGS

DIRECT ARGV SPAWN

ELECTRON 33 + REACT 18

SQLITE WAL CACHING

AXIOM DESIGN SYSTEM

> > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >

▲ FlowGit — repo: flowgit.git [main*]

GIT 2.44.0 (x64) • WAL OPEN

EVENT FREQUENCY

LAST 30 DAYS

Pan: Drag canvas | Zoom: Wheel / +/- | Click node to inspect

RADAR

COMMIT DETAILS

a94f1c0

AUTHOR

Alex Vance <alex@flowgit.io>

DATE & TIME

2026-10-25 22:41:18

MESSAGE

feat(graph): topological DAG bezier connector & minimap sync

CHANGED FILES

DIFF HUNK PREVIEW:

STAGED CHANGES (2)

UNSTAGED / UNTRACKED (3)

DIFF: electron/git/executor.ts INDEX VS WORKTREE

@@ -15,8 +15,10 @@ export function spawnGit(args: string[], cwd: string) {
   const gitBinary = getResolvedGitPath();
-  // Dangerous: raw shell invocation with string interpolation
-  return child_process.exec(`"${gitBinary}" ${args.join(' ')}`);
+  // Safe: argv array spawning with shell disabled
+  const env = redactSensitiveTokens(process.env);
+  return child_process.spawn(gitBinary, args, { cwd, shell: false, env });
 }

LOCAL BRANCHES (3 active)

* main HEAD

↑1 ahead • a94f1c0

o feature/blueprint-minimap

↑3 ahead • f419c82

o hotfix/sqlite-wal

synced • 7b3e9a1

STASH LIST & REMOTES (1 stash • 1 remote)

stash@{0}

WIP on main: a94f1c0 feat: minimap radar

UPSTREAM REMOTES

origin (fetch & push)

https://github.com/flowgit/flowgit.git

TECHNICAL SPECIFICATIONS

ENGINEERED FOR WORKFLOW VELOCITY

Every component in FlowGit is designed around deterministic Git execution, strict context isolation, and terminal-grade monospaced ergonomics.

// 01 — VISUAL ARCHITECTURE

Signature Blueprint Git Graph

Infinite canvas pan-and-zoom DAG renderer. Computes real topological ancestry, non-overlapping lane columns, and parent-child cubic Bezier splines. Never get lost in sprawling branch merges again.

Infinite dot-grid canvas (0.25x to 3.0x zoom)
Live minimap radar with viewport box tracking
Instant jump-to-HEAD and filter search

// 02 — PROCESS SECURITY

Zero Shell Concatenation

Direct binary invocation via safe argv arrays (spawn('git', [args])). Eliminates shell escape vulnerabilities, handles spaces and unicode filenames securely, and scrubs credentials before logging.

Context isolation with strict IPC channel guards
Automatic token & HTTP basic auth redaction
Multi-stage Windows Git binary detector

// 03 — HIGH PERFORMANCE CACHING

SQLite WAL Persistence

Instantaneous startup and sub-second repo switching. FlowGit persists repository records, pinned workspaces, and graph coordinates in an embedded SQLite engine with Write-Ahead Logging (WAL).

Zero cold-start lag on 100k+ commit repositories
Atomic disk commits with zero file corruption
Zero cloud dependency — 100% local data

// 04 — STAGING & COMMITS

Porcelain-v1 Index Staging

Deterministic file staging based directly on Git's porcelain status format. Atomic file actions with confirmation safeguards for destructive operations.

Clear Staged, Unstaged, Untracked & Conflicted separation
Amend commit flag & live 72-character counter
Selective hunk staging and safe worktree discard

// 05 — COMPARISON ENGINE

Unified & Split Diff Viewer

Terminal-grade diff parsing engine with additions/deletions highlighting, line numbering for both revisions, and intelligent context folding for unchanged code.

Side-by-side split & unified inline comparison modes
Protective threshold for binary and large files
Design-system safe muted color accents

// 06 — BRANCHES & SYNC

Branch Matrix & Stash Sync

Complete local and remote-tracking branch management with upstream sync indicators (↑ ahead / ↓ behind), annotated tags, and untracked-file stash operations.

Safe push with force-with-lease protection
Network error classification with actionable recovery
Instant stash preview, pop, apply, and drop

SYSTEM ARCHITECTURE & EXECUTION

HOW FLOWGIT OPERATES

Inspect the underlying technology choices and execute build commands directly.

# Standalone Single-File Executable
# Download FlowGit-Portable.exe from GitLab (Recommended) or GitHub mirror:
.\FlowGit-Portable.exe

# Zero installation, zero registry writes

COMPONENT	FLOWGIT ENGINE	STANDARD GUI CLIENTS
Git Process	argv spawn() arrays (zero shell)	exec() shell string interpolation
Visual Model	Blueprint Topological DAG (Node-based)	Linear vertical ladder list
Metadata Store	SQLite WAL database (0ms cold cache)	Volatile in-memory parse on each open
Security Model	Context Isolation + Credential Redaction	Plaintext logging of auth URLs
Design System	Axiom Dark System (Strict Monospace)	Generic OS native / colorful tabs
Runtime	Electron 33 + Vite 6 + React 18	Legacy framework runtimes

DEPLOYMENT ARTIFACTS

DOWNLOAD FLOWGIT FOR WINDOWS

Targeted for Windows 11 and Windows 10 (64-bit). Primary distribution is hosted on GitLab (Recommended), with an official mirror on GitHub Releases as a backup source.

RECOMMENDED

Standalone Portable

FlowGit-Portable.exe • ~82 MB

Target OS Windows 11 / 10 (x64)
Form Factor Single standalone .exe
Installation Zero registry writes
Persistence %APPDATA%\FlowGit\

Download (GitLab • Recommended) → Backup Mirror (GitHub Releases) ↗

Compiled Binaries

FlowGit-win-x64-binaries.zip • ~95 MB

Target OS Windows 11 / 10 (x64)
Contents FlowGit.exe + runtime bundle
Execution Extract & run FlowGit.exe
Portability Run from any folder or USB

Download (GitLab • Recommended) → Backup Mirror (GitHub Releases) ↗

Source Repository

TypeScript / React 18 / Electron 33

Node.js v20.x or v24.x LTS
Tooling electron-vite + Vitest
License MIT Open Source
Verification 100% Tests Passing

GitLab Repository → GitHub Mirror ↗

MINIMUM PREREQUISITES: Windows 10/11 (64-bit) • 4 GB RAM • Git for Windows 2.30+ installed in PATH

HOSTING: GitLab Releases (Recommended) • GitHub (Backup Mirror)