@oss-autopilot/core

CLI and core library for managing open source contributions. Track PRs, respond to maintainers, discover issues, and maintain contribution velocity.

Part of OSS Autopilot.

Installation

npm install -g @oss-autopilot/core

Or run directly:

npx @oss-autopilot/core daily --json

Requirements

• Node.js 20+
• GitHub CLI (gh) authenticated, or GITHUB_TOKEN environment variable

CLI Usage

# Daily digest of your open PRs
oss-autopilot daily --json

# Check PR status
oss-autopilot status --json

# Search for contributable issues
oss-autopilot search "react" --json

# Track a new PR
oss-autopilot track https://github.com/owner/repo/pull/123

# View help
oss-autopilot --help

All commands support --json for structured output:

{
  "success": true,
  "data": { ... },
  "timestamp": "2026-02-28T12:00:00.000Z"
}

Library Usage

import { PRMonitor, StateManager, IssueDiscovery } from '@oss-autopilot/core';

const token = process.env.GITHUB_TOKEN!;

// Monitor your open PRs
const monitor = new PRMonitor(token);
const result = await monitor.fetchUserOpenPRs();

// Manage state
const state = StateManager.getInstance();
const currentState = state.getState();

// Discover contributable issues
const discovery = new IssueDiscovery(token);
const issues = await discovery.searchIssues({ languages: ['typescript'], maxResults: 5 });

Claude Code Plugin

For the full AI-powered experience, install as a Claude Code plugin:

/plugin marketplace add costajohnt/oss-autopilot

See the main README for plugin setup.

License

MIT