Oss Autopilot

What is Oss Autopilot?

Oss Autopilot is an AI-powered workflow engine for managing open source contributions at scale. It monitors all your open pull requests across GitHub, alerts you when maintainers leave feedback, helps draft responses, diagnoses CI failures, and finds new issues matched to your contribution history. It ships as a Claude Code plugin, an MCP server, and a standalone CLI.

How to use Oss Autopilot?

As a Claude Code plugin, run /plugin marketplace add costajohnt/oss-autopilot, then /plugin install oss-autopilot@oss-autopilot, restart Claude Code, and run /setup-oss. For other MCP clients, run npx @oss-autopilot/core@latest init <your-github-username> one time, then add the MCP server config with command: "npx" and args: ["@oss-autopilot/mcp@latest"]. Use /oss for a daily check or npx @oss-autopilot/core daily from the CLI.

Key features of Oss Autopilot

• MCP server exposes 27 tools, 6 resources, and 4 prompts
• 7 specialized agents for different contribution tasks
• Deterministic core with 2,700+ tests independent of any LLM
• Fresh-fetch architecture — no local PR storage, always live data
• Human-in-the-loop guardrails — nothing posted without approval
• Production-grade GitHub API with caching, rate limiting, and backoff

Use cases of Oss Autopilot

• Daily pull request monitoring and triage across all open PRs
• Diagnose CI failures and merge conflicts with deterministic categorization
• Discover and vet new issues matched to your contribution history
• Draft responses to maintainer feedback and validate PR compliance
• Analyze repository health and generate contribution stats/badges

FAQ from Oss Autopilot

What runtime does Oss Autopilot require?

Oss Autopilot requires Node.js. It is published as npm packages and uses the gh CLI’s auth token for GitHub authentication.

Where does Oss Autopilot store data?

State is stored in ~/.oss-autopilot/state.json with 0o600 permissions. PR data is not stored locally; every run fetches live data from GitHub’s Search API.

How does Oss Autopilot authenticate with GitHub?

It uses the GitHub CLI’s authentication token (gh auth token) automatically. No separate token configuration is needed.

Is Oss Autopilot free and open source?

Yes, it is open source under the MIT license. All npm packages are publicly available on npm.

Can Oss Autopilot be used without Claude Code?

Yes. It works as an MCP server with any MCP client (Cursor, Claude Desktop, Codex, Windsurf) and as a standalone CLI via npx @oss-autopilot/core.