Documentation

Everything you need to install, configure, and use Plip.

Getting Started

1. Install from GitHub Marketplace

Visit github.com/apps/plip-io and install Plip on your repositories. You can grant access to all repos or select specific ones.

2. Automatic setup

On install, Plip automatically creates a blue plip label on all granted repositories and posts a welcome issue with a quick-start guide.

3. Label an issue

Add the plip label to any issue. Plip takes it from there.

Permissions

Plip requests the minimum permissions needed to do its job:

Permission Access Why
Contents Read & Write Clone your repo and push fix branches
Issues Read & Write Read issue details and post progress updates
Pull Requests Read & Write Create PRs with the fix
Metadata Read Access repository info (language, default branch, etc.)

How Plip Works

Plip uses a two-phase triage-guided agent architecture. Each phase uses the right model for the job.

1

Triage ~30 seconds

Claude Haiku quickly scopes the issue. It reads the bug report, scans the codebase, and produces a structured triage:

  • Identifies 2-5 relevant files
  • Assesses difficulty: simple, moderate, or complex
  • Produces a fix plan for the next phase
2

Fix 2-10 minutes

Claude Sonnet executes the fix plan from Phase 1:

  • Reads relevant code and investigates the root cause
  • Writes the fix and regression tests
  • Runs the test suite to verify the fix
  • Creates a pull request with a clear explanation

Model selection is automatic. Haiku handles triage, Sonnet handles most fixes, and Opus tackles complex issues on Business/Enterprise plans. No configuration needed.

Progress is posted to the issue as a single comment, updated in real-time so you can follow along.

Human review is always required. Plip creates PRs, never pushes directly to your main branch.


Configuration

Plip works out of the box with zero configuration. To customize behavior, add a .github/plip.yml file to your repository. All fields are optional.

.github/plip.yml
# Trigger mode: "label" waits for the plip label, "auto" processes every new issue
trigger: label

# Label name that triggers a run (only used when trigger is "label")
label: plip

# Issue types to process: "bug", "feature", or "all"
issue-type: bug

# Language override: "auto" detects from your repo
language: auto

# Skip test execution
skip-tests: false

# Override auto-detected build command
buildCommand: ""

# Override auto-detected test command
testCommand: ""

Auto trigger mode

Set trigger: auto to have Plip process every new issue automatically, without requiring a label.

ScrumChum integration

If ScrumChum is installed on the same repo (detected by scrumchum: labels), auto-trigger mode waits 60 seconds for triage to complete before starting a fix. This gives Plip better context for the fix plan.


Triggering a Fix

Label trigger default

Add the plip label to any issue. Plip investigates the bug and creates a PR with the fix.

Auto trigger

Set trigger: auto in your config. Every new issue automatically triggers Plip.

Plip responds to labels and webhooks. There are no slash commands.


Supported Languages

Plip auto-detects your language and package manager. Here are the languages with first-class support:

TS

TypeScript / JavaScript

npm, yarn, pnpm, bun

Py

Python

pip, poetry

Go

Go

go modules

Rs

Rust

cargo

Jv

Java

maven, gradle

C#

C#

dotnet

Rb

Ruby

bundler

C+

C++

cmake, make

Plip can handle any language with a standard build and test setup. The languages above have optimized auto-detection for package managers and test runners.


Plans & Pricing

All plans use Claude Sonnet. Business and Enterprise unlock Claude Opus for complex issues.

Plan Price Fixes/mo Repos Model Queue Priority
Free $0 10 1 Haiku Standard
Pro popular $39/mo 25 Unlimited Sonnet High
Business $399/mo 100 Unlimited Sonnet + Opus Higher
Enterprise $599/mo 250 Unlimited Sonnet + Opus Highest
Annual billing saves 20%
Early adopter program: first 50 installs get Pro for life
Business & Enterprise use Claude Opus for complex issues
Billing handled by GitHub Marketplace

Privacy & Security

Ephemeral containers

Code is cloned temporarily and the container is destroyed after the job completes. No permanent storage of source code.

Network restricted

Container network access is limited to the GitHub API and Anthropic API only. No other outbound connections.

Webhook verification

All incoming webhooks are verified against GitHub's signature to prevent unauthorized triggers.

HTTPS enforced

All traffic is encrypted in transit. No unencrypted connections are accepted.

No training on your code

AI processing runs via the Anthropic Claude commercial API. Anthropic does not train on data sent through the API.

Data deleted on uninstall

When you uninstall Plip, all associated data is removed. Nothing is retained.

For full details, see our Privacy Policy and Terms of Service.

Support

General support

[email protected]

Privacy & data deletion

[email protected]

Bug reports

plip-community/issues

Ready to get started?

Install Plip in 30 seconds. Your first 10 fixes are free, every month.

Install on GitHub