Roark: A GitHub Issue Automation Workflow Tool Based on Pi SDK

Roark is a CLI workflow runner built around the Pi Coding Agent SDK, designed to automate the conversion of GitHub Issues into draft Pull Requests. It is designed to assist developers while preserving human decision-making authority. It ensures experimental changes do not break the main branch through isolated workspaces, provides traceable run artifacts, and supports multiple commands to meet the needs of different scenarios.

In software development, converting requirements into code is a complex and error-prone process. Developers need to go through steps such as understanding Issue descriptions, planning solutions, writing code, testing, and submitting PRs, which is time-consuming and requires a lot of context switching. The Roark project was born to encapsulate the capabilities of the Pi Coding Agent SDK and provide a complete automated workflow solution from Issue to PR.

Roark divides Issue processing into seven stages: Fetch, Triage, Plan, Implement, Review, Fix, and Readiness. Its key design is the isolated workspace mechanism: each run creates a clean clone of the code repository, executes modifications in the clone, keeps the original checkout unaffected, and supports syncing changes back to the working directory. This ensures parallel processing of multiple Issues and easy rollback of failed operations.

Roark provides several core commands:

• roark do: Execute a single Issue to generate a draft PR;
• roark auto: Automatically process Issues based on labels;
• roark continue: Resume running from the point of failure;
• roark revise-pr: Revise a PR based on PR review feedback. All run artifacts are stored in the .roark/runs directory, including context files, plan documents, code changes, review reports, validation results, etc., ensuring each run is traceable and auditable.

Environment Requirements: Bun runtime, Git, authenticated GitHub CLI, and permissions for the target repository. Installation Steps: Clone the repository → Install dependencies → Install globally → Verify. Initialization Configuration: Execute roark init in the target repository to generate .roark/config.json, which supports custom configurations such as model selection, temperature parameters, label rules, and workspace options.

Roark explicitly does not perform operations such as automatic PR merging, closing Issues, or running persistent daemons, ensuring human control over the code repository. Comparison with other tools:

Feature	Roark	GitHub Copilot	Devin
Open Source	✅	❌	❌
Local Run	✅	❌	❌
Issue-driven	✅	❌	✅
Reviewable Artifacts	✅	Partial	✅
Auto Merge	❌	❌	✅
Human Control	Strong	Medium	Weak

Roark is suitable for open-source project maintenance (handling repetitive Issues), personal development (quickly turning ideas into code drafts), team review assistance (generating initial solutions), and learning exploration (observing AI-generated code and review reports). Summary: Roark is a pragmatic path for AI-assisted development, amplifying developers' capabilities while maintaining control, and is an open-source solution worth trying.