A modernised git interface for improved agent and human collaboration, review and control.

How It Works

Built with Electron, React, and TypeScript, Ledger provides a cross-platform desktop application. It uses simple-git for Git operations and integrates with the GitHub CLI (gh) for PR management. Its "Opinionated Git" features streamline common tasks, such as auto-stashing and "virtual merge" PR previews, aiming to reduce friction.

Quick Start & Requirements

• Installation: Binaries available for macOS (Apple Silicon), Linux (Ubuntu/Debian x64 .deb, AppImage), and Windows (NSIS installer). Refer to "Releases" for downloads.
• Prerequisites: git on PATH. GitHub CLI (gh) is optional but needed for PR integration.
• macOS First Launch: May require right-click -> "Open" or xattr -cr <Ledger_App_Path> to bypass security warnings.

Highlighted Details

• Pull Request Integration: View, filter, and interact with GitHub PRs, including inline diffs and reviews.
• Worktree Support: Manage worktrees, detect AI agent workspaces, and convert worktree changes to branches.
• Branch Management: Comprehensive view of local/remote branches with filtering/sorting; double-click to switch with auto-stash.
• Commit & Staging: Visualize commit history with graphs, stage/unstage files with diff previews, and reset commits.
• Stash Management: View, apply, pop, preview, and convert stashes to branches.
• Opinionated Git: Auto-stash, PR previews ("virtual merge"), Mailmap support.

Maintenance & Community

The README details development setup and contribution guidelines but lacks specific community channels (Discord, Slack), active maintainer information, sponsorships, or a public roadmap.

Licensing & Compatibility

Licensed under the MIT License, generally permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

macOS first-launch security prompts require user intervention. Linux support beyond Ubuntu/Debian x64 relies on AppImage, which may have dependencies (e.g., fuse3). The project focuses on modern workflows, including AI agent workspaces.