A Git diff review tool with a web interface, inspired by GitHub's pull request UI. Guck runs as a background daemon that automatically starts when you enter a git repository.
- 🤖 Auto-start daemon - Automatically starts a server when you cd into a git repo
- 🌐 Web-based interface - Review diffs in your browser with a GitHub-like UI
- 📁 File-by-file diff viewing - Expand and review individual files
- ✅ Mark files as viewed - Track your review progress
- 💬 Inline comments - Add comments to specific lines of code
- 💾 Persistent state - Remembers what you've reviewed using XDG conventions
- 🎨 GitHub-inspired dark theme - Familiar and easy on the eyes
- ⚡ Built with Go - Fast, simple, and efficient
- 🔌 Automatic port allocation - Each repository gets its own port
- 🤖 MCP Server Integration - Allows LLMs like Claude to query and resolve review comments
# Using mise (recommended)
mise use -g github:tuist/guck@latest
# Or download from releases
# https://github.com/tuist/guck/releasesAdd to your shell configuration (~/.bashrc, ~/.zshrc, etc.):
eval "$(guck init)"cd /path/to/your/repo # Daemon starts automatically
guck # Opens browser to review diffsAdd to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"guck": {
"command": "/path/to/guck",
"args": ["mcp"]
}
}
}Restart Claude Code, and you can ask Claude to:
- "List all unresolved comments in this repository"
- "Show me comments on main.go"
- "Resolve comment with ID xyz"
For comprehensive documentation, see docs/README.md:
# Daemon management
guck daemon start # Start daemon manually
guck daemon stop # Stop current repo's daemon
guck daemon list # List all running daemons
guck daemon stop-all # Stop all daemons
# Configuration
guck config set base-branch develop
guck config show- Shell Integration: Automatically starts a server when you
cdinto a git repository - Daemon Management: Each repository gets its own background server with a unique port
- Web Interface: Review diffs in your browser, mark files as viewed, add inline comments
- State Persistence: Everything is saved locally and associated with repo/branch/commit
- MCP Integration: LLMs like Claude can query and resolve comments through the MCP protocol
MIT
Thanks goes to these wonderful people (emoji key):
Jeffrey Guenther 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!