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: 1- Quickstart
Install the GitHub App, add .dz/maintainer/maintainer.yml, and watch the first loop run.
- Dashboard screens
The product, screen by screen, in the order work moves: Overview, Plans, Fleet, CI runs, Pending actions, Blockers and Audit log.
- maintainer.yml reference
Every policy field, with examples. The file that bounds what the agent may do.
- Stacks
How a repository is recognised, the one-command trio it earns, and the gate exit codes that mean "could not grade".
- MCP verb reference
All MCP tools (user-tier and operator-tier) with scopes and actions.
- MCP client onboarding
Mint a personal access token, point Claude Code, Cursor, or tesote.ai at mcp.developerz.ai, and dispatch your first task.
- GitHub Copilot
Hand fixes to Copilot via webhook. The agent opens a PR; your policy decides what happens next.
- Claude Code
Trigger Claude Code on triaged issues. Full audit trail, every tool call logged.
- OpenHands
Route tasks to OpenHands for autonomous coding. BYOK: your key, your bill.
- AI code review
CodeRabbit-compatible AI review on your own model. Drop in your .coderabbit.yaml or use the native review: block.
- Migrating from CodeRabbit
Move review onto your own key without rewriting config: your .coderabbit.yaml keeps working.
- Dependency bots
Dependabot and Renovate pull requests reviewed, fixed and merged through the merge gate, 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.
- Self-hosted CI
Replace GitHub-hosted runners with your own VPS. One label change, runs-on: [self-hosted, linux, developerz].
- Bring your own boxes
Enrol a VM into your fleet: requirements, the join command, hardening, and what never touches the box.
- Artifact storage
Agents store files in your S3 bucket or the platform bucket. Presigned URLs, expiry by policy.
- BYO log sink & retention
Raw CI/review/run logs are kept 72 hours. Point a Postgres you own at the platform for retention on your terms.
- Realtime dashboards
JSON-defined boards pushed live over SSE. Define from Claude Code or Claude Desktop.
- REST API
Programmatic access to your repos, tasks, runners, billing, and audit log.
- Outbound webhooks
Signed event deliveries to your endpoint: envelope, signature, retries, and which events fire today.
- Error tracking (Sentry)
Sentry issue alerts become asks that triage can turn into fix pull requests, merged on your policy.
- Rate limits
Per-token read and write budgets, the pre-auth per-IP bucket, and exactly what a 429 looks like.
- Escalations
When the agent pages a human: security, breaking changes, and stuck threads.
- Policy replay
Re-decide a recorded session against a candidate maintainer.yml. Executes nothing, stores nothing.
- BYOK
Bring your own model key. We orchestrate; you own the inference bill.
- Billing
Seats, entitlements, spend caps and the Stripe portal, and why inference never appears on our invoice.
- Teams & roles
Owner, admin, member and viewer: what each can do, how membership is granted, and the last-owner rule.
- Security
Least-privilege GitHub scopes, encrypted secrets, and the append-only audit log.
- Troubleshooting
The agent is quiet, the PR will not merge, the box is offline. The checks that resolve most reports.
- Glossary
AI dev, box, seat, lane, handoff, disposition. The words this documentation uses, defined once.