The Autonomous AI Code Reviewer for Indie Devs & Teams

Bugs, leaked secrets, missing tests, and architectural risks — caught before they merge.

Jennie is an autonomous, agentic AI code review tool built for modern engineering workflows. Unlike traditional static linters (ESLint, SonarQube) that only check syntax rules, Jennie performs full deep read-throughs like a senior engineer.

It traces AST call trees, follows cross-file dependencies, respects custom repository guidelines (.jennie/rules.md), connects to live external systems via the Model Context Protocol (MCP), and posts human-quality inline pull request feedback directly on GitHub.

Jennie can be run locally in your terminal before committing, continuously as a GitHub Action, or as an ambient background QA daemon.

• 🧠 Deep Codebase Context: Explores far beyond git diffs. Traces imports, inspects modified call trees, and verifies interface contracts across files.
• 🔌 Model Context Protocol (MCP): Native MCP client allows connecting live databases, Sentry observability, and Playwright browser suites into the review loop.
• ⚡ Provider Agnostic: Native support for Anthropic (Claude 3.7 Sonnet / 3.5 Haiku), OpenAI (gpt-4o / o3-mini), OpenRouter, and Cloudflare Workers AI.
• 📜 Custom Repository Rules: Place a .jennie/rules.md file in your repository to enforce team-specific architecture, styling, and security requirements.
• 💬 On-Demand PR Comment Triggers: Trigger reviews directly inside GitHub PR comments using /jennie review.
• 🛡️ Security & Privacy First: Zero code storage. Your code diffs are processed directly by your chosen LLM provider and never used for model training.
• 🌐 Ambient & Cross-Repo QA: Audit local changes as you code (npx jennie qa --ambient) or verify multi-repository microservice breaking changes simultaneously.
• 🎨 Interactive Web Dashboard: Includes a modern Next.js 16 web landing page and interactive documentation engine with dark mode and smooth animations.

Inspect staged or uncommitted local changes before opening a PR:

# Review staged changes in current working directory
npx jennie review

# Compare local branch against main with thorough depth
npx jennie review --base main --depth thorough --verbose

# Run with custom MCP tool integration enabled
npx jennie review --mcp ./mcp-config.json

Add the workflow file to .github/workflows/jennie-review.yml:

name: Jennie AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      issues: write

    steps:
      - name: Checkout Code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Run Jennie Review Agent
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: npx jennie review --ci

Jennie supports multiple LLM providers. Configure the appropriate keys:

Anthropic (Default):

export ANTHROPIC_API_KEY="sk-ant-api03-..."
export JENNIE_MODEL="claude-3-7-sonnet-20250219"

OpenAI:

export OPENAI_API_KEY="sk-proj-..."
export JENNIE_PROVIDER="openai"
export JENNIE_MODEL="gpt-4o"

OpenRouter:

export OPENROUTER_API_KEY="sk-or-v1-..."
export JENNIE_PROVIDER="openrouter"
export JENNIE_MODEL="anthropic/claude-3.5-sonnet"

npx jennie review [options]

This repository contains both the Jennie Code Review Agent documentation and its official web marketing portal built with Next.js 16 (App Router) and Tailwind CSS v4.

1. Install dependencies:

   npm install

2. Start development server:

   npm run dev

   Open http://localhost:3000 in your browser.

3. Build for production:

   npm run build
   npm run start

4. Run Linter:

   npm run lint

.
├── docs/                        # Complete product documentation
│   ├── setup.md                 # Installation & Quickstart guide
│   ├── action-options.md        # GitHub Action CLI parameters & depth settings
│   ├── ai-provider-config.md    # Multi-provider LLM configuration guide
│   ├── mcp.md                   # Model Context Protocol integration guide
│   ├── rules-files.md           # Custom repository rules (.jennie/rules.md)
│   ├── custom-instructions.md   # Prompt tailoring guide
│   ├── qa-features.md           # Automated QA capabilities
│   ├── ambient-qa.md            # Background daemon setup
│   ├── cross-repo-qa.md         # Multi-repository microservices review
│   └── subagent-tool.md         # Autonomous subagent tools reference
├── src/
│   ├── app/
│   │   ├── docs/                # Interactive documentation browser page (/docs)
│   │   ├── globals.css          # Core design system tokens & Tailwind CSS
│   │   ├── layout.tsx           # Global app shell with ThemeProvider & Navbar/Footer
│   │   └── page.tsx             # Marketing landing page (Hero, Features, QuickStart, FAQ)
│   ├── components/
│   │   ├── layout/              # Navbar, Footer, Mobile Navigation
│   │   ├── marketing/           # Hero, Features, FeatureCard, QuickStart, FAQ
│   │   └── ui/                  # CodeBlock, Badge, ThemeToggle, Stamp, SmoothScroll
│   └── lib/
│       └── content.ts           # Central branding configuration & documentation items
├── public/                      # Static assets & public images
├── package.json                 # Project dependencies & scripts
├── tailwind.config.js / postcss # PostCSS & Tailwind v4 styling setup
└── tsconfig.json                # TypeScript configuration

For detailed guides, check out the ./docs directory or visit the /docs route on the web application:

• Setup & Quickstart Guide
• GitHub Action Options
• AI Provider Configuration
• Model Context Protocol (MCP) Integration
• Custom Repository Rules
• Prompt Tailoring
• QA Features
• Ambient QA Daemon
• Cross-Repository QA
• Subagent Tools

Distributed under the MIT License. See LICENSE for more information.

Developed with ❤️ for developers who ship fast.