Skip to content

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.

.maintainer.yml
# yaml-language-server: $schema=https://developerz.ai/schemas/maintainer.v1.json
version: 1
Read the quickstart
  • 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.