Stop managing Git. Start engineering. GitCanopy combines high-performance visualization with a cognitive AI engine to automate commit hygiene, resolve complex conflicts, and audit code quality in real-time.
Features • Download • Usage • System Architecture
GitCanopy isn't just a wrapper around git. It is an active development partner that understands your code.
Most clients let you push bad code. GitCanopy's Quality Reviewer analyzes your staged diffs against performance standards and architectural patterns, giving you a Quality Score (0-100) before you ever hit commit.
Mycelia is an active development agent that bridges the gap between your local repository and external platforms. Powered by the Model Context Protocol (MCP), it can manage GitLab issues, trigger CI/CD pipelines, and automate cross-platform workflows using natural language.
Stop memorizing complex Git flags. Press ⌘J to open a centered, immersive command palette. Type your intent in plain English (e.g., "undo my last commit but keep changes" or "delete branches already merged into main") and the AI will translate and execute the command safely.
History is a living thing. Use the Time Machine scrubber to travel back to any point in your project's life. The graph visualization rebuilds itself dynamically, allowing you to see how your architecture sprouted and merged over years or minutes.
- 🤖 AI & Automation:
- Mycelia AI Agent: Native support for MCP to automate repository tasks and integrate with GitLab/external services.
- AI Command Center (⌘J): Centered, Spotlight-style natural language CLI for repository management.
- Smart Commit Generator: Generate semantic messages from diffs using Gemini, OpenAI, or Claude.
- Intelligent Conflict Resolver: Resolve complex merge conflicts with natural language instructions.
- Quality Reviewer: Get a pre-commit quality score (0-100) and catch logical bugs before you push.
- Visualization Engine:
- Railway-Style Graph: Lane-persistent commit graphs with semantic coloring.
- Precision Multi-selection (V): Marquee-style bulk selection for squashing and hash copying.
- Git Time Machine: Interactive historical scrubber to visualize repo evolution over time.
- Actions Explorer: Real-time GitHub Actions monitoring with instant sync and branch filtering.
- Professional Performance: 60FPS virtualized rendering and background worker-powered layouts.
- Seamless Workflow: Atomic staging, high-fidelity diffs, and integrated remote synchronization.
- Deep Insights: Contributor metrics, file hotspots, and a visual stash gallery with file previews.
GitCanopy is an open-source project. You can find the latest installers for macOS, Windows, and Linux on our Releases page or via our download mirror:
👉 Download GitCanopy from GitHub
🌐 Alternative Mirror (Vercel)
Note for macOS users: Since the app is currently unsigned, you will need to Right-Click > Open the first time you launch it to bypass the security verification.
If you see a message saying "GitCanopy is damaged and can't be opened":
- Open your Terminal.
- Run the following command:
bash sudo xattr -cr /Applications/GitCanopy.app
For developers looking to build from source or contribute, please refer to the Setup Guide.
GitCanopy leverages a modern, type-safe stack designed for security, performance, and AI-enhanced productivity.
graph TD
subgraph "Electron Application"
Renderer["🖼️ React Renderer<br/>(UI Layer)"]
Main["⚙️ Main Process<br/>(Node.js Environment)"]
Preload["🌉 Preload Script<br/>(Secure IPC Bridge)"]
Renderer <--> Preload <--> Main
end
subgraph "Core Services (Main)"
GitService["📂 Git Service"]
AiService["🧠 AI Service"]
Mycelia["🍄 Mycelia Agent"]
McpService["🧩 MCP Service"]
Main --> GitService
Main --> AiService
Main --> Mycelia
Mycelia --> McpService
end
subgraph "External Integrations"
GitCLI["Build-in Git Binary"]
GeminiAPI["✨ Google Gemini API"]
OpenAI_API["OpenAI API"]
Claude_API["Anthropic Claude API"]
GitHubAPI["GitHub API"]
GitLabAPI["GitLab API (via MCP)"]
McpServers["🔌 External MCP Servers"]
GitService <--> GitCLI
AiService <--> GeminiAPI
AiService <--> OpenAI_API
AiService <--> Claude_API
Main <--> GitHubAPI
McpService <--> GitLabAPI
McpService <--> McpServers
end
style Renderer fill:#0891b2,stroke:#06b6d4,stroke-width:2px,color:#fff
style Main fill:#1f2937,stroke:#3b82f6,stroke-width:2px,color:#fff
style AiService fill:#7c3aed,stroke:#a78bfa,stroke-width:2px,color:#fff
style Mycelia fill:#10b981,stroke:#059669,stroke-width:2px,color:#fff
style McpService fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#fff
GitCanopy v1.3.0 introduces Mycelia, an agentic core built on the Model Context Protocol.
- Native GitLab Integration: Link your GitLab account to manage issues, merge requests, and pipelines directly from the Mycelia agent pane.
- Agentic Reasoning: Mycelia uses LLMs to plan and execute multi-step tasks (e.g., "Find the latest failing pipeline on GitLab and summarize the error logs").
- Extensible Architecture: Connect any MCP-compliant server to give Mycelia new "superpowers" like database inspection, cloud resource management, or local file system automation.
- Renderer sends a request (e.g., "Generate Commit Message" or an Agent prompt) via IPC.
- Main Process captures the current context (staged diffs, repository state, MCP tool definitions).
- AI Service constructs a prompt and selects the provider (Gemini, OpenAI, or Claude).
- Mycelia Agent (if invoked) reasons about which MCP tools to call and executes them.
- External API processes the request and returns semantic text or tool results.
- Response is summarized by the AI and flows back to the UI for user review.
- Visual Interactive Rebase: Drag-and-drop history management and rewriting.
- Conflict Resolution UI: Advanced tools for solving complex merges.
- Ecosystem Integration: First-class support for GitHub, GitLab, and Bitbucket.
- Extensibility: Custom themes and commit classification plugin system.
Everyone is welcome for contributions from the community! Whether it's bug reports, feature requests, or code contributions, every bit helps make GitCanopy better. Refer to our Development Guide to get started.
GitCanopy is a solo developer project built with passion. If you find it useful, please consider supporting its growth:
- ⭐ Star this repository to help others discover the project.
- 🚀 Share GitCanopy with your team or on social media.
- 🤝 Sponsor the Developer on GitHub.
Distributed under the MIT License. See LICENSE for more information.
MIT License - feel free to use GitCanopy in your projects,
modify it, and distribute it as you see fit.
{ Report Bug • Request Feature • Documentation }