GitBounty Agent Documentation

GitBounty Agent is a headless AI judge that automates code review and bounty payouts for your repository. It lives in your GitHub issues and Pull Requests, ensuring that only verified code gets paid.

Installation

1

Install the GitHub App

Go to the GitBounty Agent App page and click "Install". Select the repositories you want the agent to manage.

2

Connect Your Wallet

Log in to the GitBounty Dashboard using your NEAR or Ethereum wallet to manage funds and view payouts.

How It Works

The agent integrats seamless payments and AI verification directly into your GitHub workflow.

  1. Trigger (Funding): You comment /bounty <amount> <token> on an issue. The bot replies with a PingPay link to deposit funds (USDC, NEAR, etc.).
  2. Work: A developer submits a Pull Request (PR) to solve the issue.
  3. Verification: The developer comments /claim <txId> <pr> <address>. The NEAR AI Judge (powered by DeepSeek-V3) reviews the code against the issue requirements.
  4. Settlement: If approved, the funds are automatically released to the developer's wallet via NEAR MPC (Multi-Party Computation) technology.

Agent Commands

Interact with the agent directly in GitHub comments.

/bounty <name> <amount> <token> [chain]

Usage: Post this on an Issue to create a bounty.

Example: /bounty "Fix Login" 500 USDC BASE

Supported tokens: USDC, NEAR, ETH. Chains: NEAR, BASE, ETH.

/claim <txId> <pr_number> <wallet_address>

Usage: Post this on a PR to request AI review and payout.

Example: /claim 0x123...abc 15 0xWalletAddress...

The AI will verify the code diff against the issue description.

/fix <name>

Usage: Create a non-monetary fix task for bugs or maintenance.

Example: /fix "Correct Typo in README"

/check <pr_number>

Usage: Request AI verification for a fix.

Example: /check 42

The AI will verify the fix against the issue description and tag you if successful.

/claim-now <txId>

Usage: (Admin Only) Manually authorize a payout without AI approval.

Only the bounty depositor can use this command.

/stop

Usage: Stop a pending payout (if within the 24h delay window).

Tech Stack & Benefits

🧠 NEAR AI (DeepSeek-V3)

Role: The Judge.

We use NEAR AI's hosted DeepSeek-V3 model running in Trusted Execution Environments (TEEs). This ensures unbiased, secure, and cost-effective code reviews compared to generic LLMs.

💳 PingPay

Role: The On-Ramp.

PingPay handles the complexity of crypto deposits. It provides a clean, hosted checkout page for funders to deposit bounty funds using their preferred wallet and chain (Base, Near, etc.).

🔐 NEAR MPC (Chain Signatures)

Role: The Bank.

The agent controls a wallet without ever holding a private key on a server. NEAR MPC nodes collectively sign transactions, allowing the bot to send USDC on Ethereum/Base directly from the NEAR network.

Configuration

Create a .gitbountyrc file in your repository root to customize the agent's behavior.


{
  "test_command": "npm test",
  "require_passing_tests": true,
  "allowed_tokens": ["USDC", "ETH", "NEAR"],
  "security_level": "high"
}