A developer-first, terminal-based Git-aware project management system.
Current release: v0.3.1
Manage Git repositories, view diffs, track tasks, and collaborate—all from your terminal without leaving your coding flow.
cargo build --release
./target/release/forge- 🔀 Git Integration — Real-time file status and diff preview
- 🌐 Remote Operations — Fetch, pull, and push with progress + cancellation
- 📋 Project Board — Kanban task tracking (Pending → Current → Completed)
- 🔗 Branch Management — Create, switch, and delete branches
- 📝 Commit History — Browse and inspect commits
- 👥 Team Management — Track modules and developers
- 🔀 Merge Visualization — Side-by-side local/incoming previews with accept markers
- ⚙️ Customizable — Theme switching, notifications, and autosync
- ⌨️ Keyboard-Driven — Fully navigable without mouse
- Getting Started — Installation and first run
- Features — Complete feature overview
- Keyboard Shortcuts — All keybindings
- Architecture — System design
- Development — Contributing guide
- API Reference — Core types and functions
- Workflows — User workflows and interaction patterns
- Performance — Benchmarks and optimization
- Roadmap — Future plans
- FAQ — Common questions
- Rust 1.70+ (install here)
- Git 2.0+
- Terminal with 256-color support
# Clone the repository
git clone https://github.com/Princelad/forge.git
cd forge
# Build for production
cargo build --release
# Run in a Git repository
cd /path/to/your/repo
/path/to/forge/target/release/forge- Navigate with Tab and Arrow keys
- Stage files with Space
- Commit with Enter
- View help with
? - Fetch with Alt+F (Changes view)
- Push with Alt+P (Changes view)
- Pull with Ctrl+L (Changes view)
- Quit with Ctrl+C
See the Keyboard Shortcuts page for complete reference.
Contributions are welcome! See CONTRIBUTING.md for quick start, or the Development wiki for comprehensive guidelines.
GPL-3.0-only
Need help? Check the FAQ or open an issue on GitHub.