Integration with Development Workflows
Planning Phase
Use OpenHands during planning to accelerate technical decisions: Technical specification assistance:Development Phase
OpenHands excels during active development: Feature implementation:- Write new features with clear specifications
- Follow existing code patterns automatically
- Generate tests alongside code
- Create documentation as you go
- Analyze error logs and stack traces
- Identify root causes
- Implement fixes with regression tests
- Document the issue and solution
- Refactor for clarity and maintainability
- Optimize performance bottlenecks
- Update deprecated APIs
- Improve error handling
Testing Phase
Automate test creation and improvement:Review Phase
Accelerate code reviews:Deployment Phase
Assist with deployment preparation:CI/CD Integration
OpenHands can be integrated into your CI/CD pipelines through the Software Agent SDK. Rather than using hypothetical actions, you can build powerful, customized workflows using real, production-ready tools.GitHub Actions Integration
The Software Agent SDK provides composite GitHub Actions for common workflows:- Automated PR Review - Automatically review pull requests with inline comments
- SDK GitHub Workflows Guide - Build custom GitHub workflows with the SDK
OpenHands/software-agent-sdk/.github/actions/pr-review composite action.
What You Can Automate
Using the SDK, you can create GitHub Actions workflows to:- Automatic code review when a PR is opened
- Automatically update docs weekly when new functionality is added
- Diagnose errors that have appeared in monitoring software such as DataDog and automatically send analyses and improvements
- Manage TODO comments and track technical debt
- Assign reviewers based on code ownership patterns
Getting Started
To integrate OpenHands into your CI/CD:- Review the SDK Getting Started guide
- Explore the GitHub Workflows examples
- Set up your
LLM_API_KEYas a repository secret - Use the provided composite actions or build custom workflows
Team Workflows
Solo Developer Workflows
For individual developers: Daily workflow:- Morning review: Have OpenHands analyze overnight CI results
- Feature development: Use OpenHands for implementation
- Pre-commit: Request review before pushing
- Documentation: Generate/update docs for changes
- Set up automated reviews on all PRs
- Use OpenHands for boilerplate and repetitive tasks
- Keep AGENTS.md updated with project patterns
Small Team Workflows
For teams of 2-10 developers: Collaborative workflow:- Slack notifications for OpenHands findings
- Automatic issue creation for bugs found
- Weekly summary reports
Enterprise Team Workflows
For larger organizations: Governance and oversight:- Configure approval requirements for OpenHands changes
- Set up audit logging for all AI-assisted changes
- Define scope limits for automated actions
- Establish human review requirements
Best Practices
Code Review Integration
Set up effective automated reviews:Pull Request Automation
Automate common PR tasks:| Trigger | Action |
|---|---|
| PR opened | Auto-review, label by type |
| Tests fail | Analyze failures, suggest fixes |
| Coverage drops | Identify missing tests |
| PR approved | Update changelog, check docs |
Quality Gates
Define automated quality gates:Automated Testing
Integrate OpenHands with your testing strategy: Test generation triggers:- New code without tests
- Coverage below threshold
- Bug fix without regression test
- API changes without contract tests
Common Integration Patterns
Pre-Commit Hooks
Run OpenHands checks before commits:Post-Commit Actions
Automate tasks after commits:Scheduled Tasks
Run regular maintenance:Event-Triggered Workflows
You can build custom event-triggered workflows using the Software Agent SDK. For example, the Incident Triage use case shows how to automatically analyze and respond to issues. For more event-driven automation patterns, see:- SDK GitHub Workflows Guide - Build custom workflows triggered by GitHub events
- GitHub Action Integration - Use the OpenHands resolver for issue triage

