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, drop a .maintainer.yml, and watch the first loop run.
- .maintainer.yml reference
Every policy field, with examples. The file that bounds what the agent may do.
- 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.
- 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.
- 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.
- 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.