gnosis — Transforming pull requests into insightful…

Pitch

Description

Comments

About this project

Gnosis enhances code reviews by turning pull requests into structured, guided walkthroughs. Rather than viewing disorganized diffs, reviewers receive a narrative that explains the rationale behind changes, organized by dependencies. This approach fosters deeper understanding, leading to more effective and efficient review processes.

Gnosis is designed to enhance the code review process by converting pull requests into an easily digestible guided walkthrough. Inspired by the ancient Greek term for knowledge, Gnosis strives to provide a profound understanding of code changes rather than a superficial glance at diffs. A typical code review can often lack context and clarity, leading to missed insights; Gnosis addresses this issue by narrating the story behind each code change.

Key Features

Guided Slideshow: Changes are organized by theme and dependency, presenting foundational adjustments first, followed by implementations, tests, and configurations.
Multi-Provider Support: Choose between Claude (Opus, Sonnet, Haiku) and Gemini (3.1 Pro, 3 Pro, 3 Flash, 2.5 Pro, 2.5 Flash) to tailor the review experience.
Extended Thinking: Engage Claude models for deeper reasoning, allowing a more thorough review process.
Custom Instructions: Control the focus of the review with free-text prompts such as "focus on security" or "explain the auth flow".
Inline Review Comments: Add context-specific comments on diff lines and submit them directly to GitHub for approvals or change requests.
Split Diff View: Switch between unified and side-by-side diff layouts with persistent preferences.
Slide Chat: Inquire about any aspect of the review in an inline, resizable side panel, with tool call indicators displayed during the presentation.
Web Research Capabilities: For Claude users, the AI can perform web searches during slide generation and chat for enhanced context.
Signal Boost Filtering: Automatically filters out trivial changes, allowing reviewers to concentrate on significant design decisions and complex modifications.
Smart Imports Detection: Recognizes local file imports across various programming languages, providing context beyond mere JavaScript/TypeScript imports.
Background Review Generation: Multiple reviews can be generated simultaneously while continuing to browse PRs.
Risk Assessment: Each assessment includes a risk rating based on the nature of the changes.
Cross-Platform Compatibility: Available for macOS, Windows, and Linux (deb/rpm).

How It Works

Utilizing Gnosis is straightforward:

Paste a GitHub pull request URL or choose from open PRs.
Select a provider and model for the review.
Optionally enable extended thinking for Claude models.
Optionally add specific instructions to guide the review focus.
Generate the review, which runs in the background while allowing for continued PR submissions.

With a plethora of features aimed at making code reviews more intuitive and effective, Gnosis proposes a significant improvement over traditional methods. It transforms the review process from a disconnected checklist into a cohesive narrative, enriching both the reviewer’s comprehension and the overall quality of code evaluations.