Installation Guide

Click Install on the GitHub Marketplace listing. Select your organization and choose All repositories or specific repositories you want to govern with AgentCraftworks.

The app requires the following GitHub permissions during installation:

• pull_requests: write— to post governance status and handoff updates on pull requests
• issues: write— to assign agent work items to issues
• contents: read— to read CODEOWNERS and .agentcraftworks.yml configuration files
• members: read— to resolve organization membership for agent identity verification

For the Team/Enterprise SaaS tier, the webhook is pre-configured to the AgentCraftworks SaaS endpoint — no action required.

For self-hosted deployments, update the webhook URL in your GitHub App settings to point to your deployment endpoint. The webhook secret is available in your AgentCraftworks dashboard.

Create .agentcraftworks.yml in your repository root. This file controls governance settings for your agents. Below is a minimal starting template:

version: "1"
governance:
  default_engagement_level: 3   # Peer Programmer
  environment_caps:
    staging: 4
    production: 3
agents:
  - id: copilot
    identity: "@github-copilot[bot]"
    engagement_level: 3

See the reference template for the full configuration schema.

Add an [AGENTS] section to your CODEOWNERS file to route agent work items to specific AI agents by path:

[AGENTS]
/src/       @github-copilot[bot]
/infra/     @claude-code-agent

AgentCraftworks reads this section to determine which agent is responsible for a given pull request based on the files changed.

Open a test pull request in your repository. Within a few seconds, you should see an AgentCraftworks check run appear on the PR — it will show the assigned agent and governance status.

Check the AgentCraftworks dashboard to confirm the webhook was received and the governance event was processed.