Docs / Overview
Documentation
Install the GitHub App, write your maintainer.yml policy, and learn how the fleet triages, hands off, and ships. Every action audited.
# yaml-language-server: $schema=https://developerz.ai/schemas/maintainer.v1.json
version: 1Start here
- Quickstart
Install the GitHub App, add a policy file, your model key and a server, and follow one issue to a merged pull request.
- Dashboard screens
The product, screen by screen, in the order work moves: Overview, Plans, Fleet, CI runs, Pending actions, Blockers and Audit log.
- Bring your own boxes
Add your own server to run the work: what it needs, the command that connects it, how to lock it down, and what never reaches it.
- BYOK
Use your own AI model key. Every model call runs on it, so your provider bills you directly.
- Security
The GitHub permissions the app asks for and why, how secrets are encrypted, and the audit log whose entries are never edited.
Configure the agent
- maintainer.yml reference
Every policy field, with examples. The file that bounds what the agent may do.
- Stacks
How we recognise a repository's stack, the three scripts it gets (install, run, check), and how a check says it could not test a change.
- AI code review
AI code review on your own model key. Keep your .coderabbit.yaml, or set review rules in your policy file.
- Migrating from CodeRabbit
Move review onto your own key without rewriting config: your .coderabbit.yaml keeps working.
- Dependency bots
How Dependabot and Renovate pull requests get reviewed, fixed and merged under your policy, plus a recommended dependabot.yml.
- Stale issues and PRs
Remind, then close, issues and pull requests that wait on the person who opened them. Off until you set it, with the settings we recommend.
- Escalations
When the agent stops and asks a maintainer first: security, licences, breaking changes, and the other categories you switch on.
- Policy replay
Test a policy change on past work: see which decisions a new maintainer.yml would change. Changes nothing, saves nothing.
Connect your tools
- MCP client onboarding
Connect Claude Code, Cursor, ChatGPT or the Claude app to our MCP server, then file your first request and check the work.
- GitHub Copilot
Hand fixes to GitHub Copilot. Copilot opens the pull request; your policy decides whether it merges.
- Claude Code
Send issues to Claude Code, running on your own machines with your own model key. Every call it makes to our MCP server is logged.
- OpenHands
Send tasks to OpenHands, running on your own machine with your own model key. Every handoff is logged.
- Self-hosted CI
Run GitHub Actions jobs on servers you enrol by changing the runs-on line; public repos opt in first.
- Outbound webhooks
Signed events sent to a URL you own: what each one holds, how to check it came from us, retries, and which events exist today.
- Error tracking (Sentry)
Send Sentry alerts to developerz.ai: each new error becomes a request the agent can turn into a fix, merged under your policy.
Manage your account
- Artifact storage
Files the agents make, like screenshots, reports and builds, kept in our bucket for up to 7 days, or in your own S3 bucket for as long as you choose.
- BYO log sink & retention
We keep raw run, review and CI logs for 72 hours. Connect a Postgres database you own to keep them as long as you choose.
- Realtime dashboards
Build live boards from any MCP client or the REST API. They update on their own, and every widget only reads data.
- Billing
Seats, spend caps and the Stripe billing portal, and why AI model costs never appear on our invoice.
- Teams & roles
Owner, admin, member and viewer: what each can do, how people are added, and the rules for changing roles.
- Troubleshooting
The agent is quiet, the PR will not merge, the box is offline. The checks that resolve most reports.
Reference
- MCP verb reference
Every tool on our MCP server: what it does and the permission it needs.
- REST API
Reach your repos, tasks, policy, billing and audit log from your own code.
- Rate limits
How many API reads and writes you get each minute, the limit on calls before your token is checked, and what an over-limit reply looks like.
- Glossary
AI dev, box, seat, lane, handoff, disposition. The words this documentation uses, defined once.