开源AI工作流

Requirements

• Node.js 22 or newer
• GitHub CLI installed and logged in (gh auth login), or a GITHUB_TOKEN in your environment
• For the plugin: Claude Code, plus npm and network access on first run (see below)

CI runs on Ubuntu and macOS. Windows is untested.

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.

</details>

<details>
<summary><strong>As a library</strong></summary>

const digest = await runDaily(); const issues = await runSearch({ maxResults: 10 }); ```

API reference: jcosta.tech/oss-autopilot.

</details>

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.

Configuration

Settings live in ~/.oss-autopilot/state.json under config. Change them with /setup-oss, or from the CLI:

oss-autopilot config                     # show everything
oss-autopilot config maxActivePRs 5      # set one value

Stats and badges. oss-autopilot stats prints your merged-PR numbers; --markdown gives a shareable report and --badge gives shields.io endpoint JSON. For a live profile badge and SVG cards, see oss-widgets.

Sync across machines (optional). State can be stored in a secret GitHub gist instead of only on disk. See oss-autopilot state --help. A secret gist is unlisted, not access-controlled, so anyone with the URL can read it.

Troubleshooting

Start here. It checks your token, the CLI bundle, the state file, and your rate limit:

npx @oss-autopilot/core@latest doctor

gh is missing or not logged in

brew install gh        # macOS; see https://cli.github.com for other platforms
gh auth login

The plugin's first-run build failed

find ~/.claude/plugins -name "oss-autopilot" -type d    # locate the plugin
cd <that path>/packages/core
npm install
npm run bundle

My PRs do not show up

• Run /setup-oss and confirm the GitHub username.
• Only PRs you authored are tracked.
• Check excludeRepos, excludeOrgs, and minStars.

Updating

• Plugin: /plugin update oss-autopilot
• MCP and CLI via npx ...@latest: nothing to do
• Your configuration carries over. Changelogs: core, mcp

Found a bug? Open an issue with the output of doctor --json.