Star on GitHub
Star on GitHub

PRSense - Quick Start Guide

PRSense is an open-source Repository Memory Platform. It acts as a second brain for your codebase—tracking historical Engineering Decisions Memory (EDM), surfacing context with a Knowledge Graph, and automatically catching duplicate PRs before they waste your team’s time. You have two main paths to get started: Open Source (Self-Hosted) or our Managed Cloud Dashboard.

1. Open Source (Self-Hosted)

PRSense is fundamentally an open-source project. If you want full control and prefer to run PRSense on your own infrastructure, we offer 6 different integrations (GitHub Action, CLI, VS Code Extension, Node Library, Webhook Bot, and Docker API).

[!TIP] Check out the User Guide for full details on all 6 integration methods!

Instant Start (CLI)

The fastest way to test PRSense locally is using npx. No API key or setup needed (uses our fast local ONNX embeddings by default).

# Check a PR directly
npx prsense check --title "Fix login" --files "auth.ts"

# Dry run (no indexing)
npx prsense check --title "Test PR" --files "test.ts" --dry-run

Output:

Using ONNX local embeddings (no API key found)
Checking PR #173822...
UNIQUE (Confidence: 0.000)

Build Your Own Detector

You can easily integrate PRSense directly into your TypeScript/JavaScript projects.

import { PRSenseDetector, createOpenAIEmbedder } from 'prsense'

const detector = new PRSenseDetector({
  // Use built-in OpenAI embedder
  embedder: createOpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY })
})

// Check if PR is duplicate
const result = await detector.check({
  prId: 123,
  title: 'Fix authentication bug',
  description: 'Handle empty passwords',
  files: ['auth/login.ts']
})

console.log(result)

2. PRSense Cloud Dashboard (Managed)

If you don’t want to run infrastructure, configure databases, or manage deployments, we offer a fully managed Cloud Dashboard.

[!TIP] Want the easiest experience? Skip the manual setup. Check out our Pricing Page to try the Pro Tier.

1. Create an Account

Go to app.prsense.dev and log in seamlessly with your GitHub account.

2. Connect Your Organization

Once logged in, follow the quick onboarding flow to install the PRSense GitHub App and select the repositories you want to monitor.

3. You’re All Set!

PRSense will now automatically analyze your selected repositories. Every new Pull Request will be checked for duplicates automatically, and you can view metrics directly on your dashboard.

Next Steps

  1. Self-Hosted Setup: Read the full Installation Guide.
  2. Explore All 6 Integrations: Read the User Guide.
  3. Managed Option: Log into PRSense Cloud or view Pricing.

🆘 Getting Help

  • Found a bug? Open an issue on GitHub
  • Questions? Start a discussion
  • Read the rest of our docs at /docs