Oss Autopilot
Claude Code plugin: AI-powered autopilot for managing open source contributions. Track PRs, respond to maintainers, discover issues, maintain velocity.
If you contribute to more than a couple of projects, PRs go stale without you noticing. A maintainer asks for a change, CI breaks after a rebase, a branch picks up a conflict, and you find out two weeks later.
OSS Autopilot checks every open PR you have on GitHub and sorts them into what needs you and what is waiting on someone else. For the ones that need you, it helps draft the reply, diagnose the CI failure, or rebase the branch. You approve each push and each comment before it goes out.

Contents
- Requirements
- Quick start (Claude Code)
- Other ways to run it
- The daily check
- Commands
- Finding new issues
- Overnight mode
- Dashboard
- Configuration
- How it works
- What it will and will not do on its own
- Troubleshooting
- Limitations
- Contributing
Requirements
- Node.js 22 or newer
- GitHub CLI installed and logged in (
gh auth login), or aGITHUB_TOKENin your environment - For the plugin: Claude Code, plus
npmand network access on first run (see below)
CI runs on Ubuntu and macOS. Windows is untested.
Quick start (Claude Code)
/plugin marketplace add costajohnt/oss-autopilot
/plugin install oss-autopilot@oss-autopilot
Restart Claude Code, then:
/setup-oss
Setup asks for your GitHub username, the languages and labels you care about, and how many PRs you want open at once. After that, run /oss whenever you want to check in.
About the first run. The plugin ships as source. The first /setup-oss or /oss installs dependencies and builds the CLI inside the plugin directory, so it needs npm (or pnpm) and a network connection, and it takes longer than later runs. If the build fails, see Troubleshooting.
Other ways to run it
MCP server (Cursor, Claude Desktop, Codex, Windsurf, any MCP client)
Save your GitHub username once:
npx @oss-autopilot/core@latest init <your-github-username>
Then add the server to your MCP client config:
{
"mcpServers": {
"oss-autopilot": {
"command": "npx",
"args": ["@oss-autopilot/mcp@latest"]
}
}
}
The MCP server exposes 35 tools, 6 resources, and 4 prompts. @latest means you get new releases automatically; pin a version (@oss-autopilot/mcp@5.7.4) if you would rather update on your own schedule.
Standalone CLI
npx @oss-autopilot/core@latest init <your-github-username>
npx @oss-autopilot/core@latest daily # human-readable digest
npx @oss-autopilot/core@latest daily --json # structured output
npx @oss-autopilot/core@latest doctor # check token, state, rate limit
# or install it
npm install -g @oss-autopilot/core
oss-autopilot --help
Every command accepts --json and returns { success, data, error, timestamp }, so it is easy to script.
As a library
npm install @oss-autopilot/core
import { runDaily, runSearch } from '@oss-autopilot/core/commands';
const digest = await runDaily();
const issues = await runSearch({ maxResults: 10 });
API reference: jcosta.tech/oss-autopilot.
The daily check
From the project's README.