Porter

GitHub-native agents

Turn GitHub issues into pull requests with one comment

Comment @porter on any GitHub issue. A Fly Machine spins up, runs your agent, and opens a PR.

Get started Read docs
porter — zsh
> GitHub issue #42: Fix auth redirect bug
▼ @porter opencode fix auth redirect
● Spawning Fly Machine...
● Cloning repo...
● Running opencode agent...
✓ Found bug in auth.ts:134
✓ Created PR #423: Fix auth redirect
● Machine destroyed ($0.03)
$

How it works

Four steps to your first PR

01

Install the GitHub App

Add Porter to your repos. It gets just enough access to read issues and open PRs.

Porter watches for @porter mentions — nothing else.

02

Add your API keys

Create a private Gist with your Fly token and model provider keys.

Your credentials, your Gist. Porter reads them at runtime, never stores them.

03

Comment @porter on an issue

Pick an agent — @porter opencode, @porter claude, or @porter amp.

Porter reads the issue, builds a prompt, and spins up a fresh Fly Machine.

04

Review the PR

The agent clones your repo, does the work, and opens a pull request.

Full trail from issue to branch to PR. You pay Fly compute + model tokens. No platform fee.

Use cases

What it looks like in practice

Bug triage to patch

Issue: OAuth callback mismatch in production

@you · 2 minutes ago

@porter opencode reproduce and patch oauth callback mismatch from logs in issue body

@porter-bot · just now

  • ● Spawning Fly Machine...
  • ● Cloning repo, running agent
  • ✓ Opened PR #143: Fix OAuth callback mismatch

Large refactors

Issue: Migrate legacy REST handlers to shared service layer

@you · 2 minutes ago

@porter claude migrate legacy REST handlers to shared service layer and preserve existing contracts

@porter-bot · just now

  • ● Spawning Fly Machine...
  • ● Cloning repo, running agent
  • ✓ Opened PR #287: Migrate REST handlers to shared service layer

Test coverage before release

Issue: Add test coverage for checkout edge cases before v2.4 cutover

@you · 2 minutes ago

@porter amp add tests for checkout retry, timeout fallback, and webhook signature edge cases

@porter-bot · just now

  • ● Spawning Fly Machine...
  • ● Cloning repo, running agent
  • ✓ Opened PR #312: Add checkout edge case tests

Dependency upgrades

Issue: Upgrade to React 19

@you · 2 minutes ago

@porter opencode upgrade to react 19, replace deprecated APIs, and include migration notes in PR

@porter-bot · just now

  • ● Spawning Fly Machine...
  • ● Cloning repo, running agent
  • ✓ Opened PR #98: Upgrade to React 19 with migration notes