Integration
GitHub Bot
The `/asset` command surface lives inside GitHub issues and PR comments. Install the app once, and every linked repo gets the full protocol — without leaving GitHub.
Install
Visit github.com/apps/gitsea → Install → pick the orgs/repos.
The app needs read for code, metadata, dependency manifests, contributors, and write for issue/PR comments only. It never pushes code, opens PRs, or changes branch protection.
Command reference
All commands begin with /asset and are posted as a comment on an issue or PR. The bot replies with a receipt linking the resulting on-chain tx (or an error).
Repo balance & state
| Command | What it does |
|---|---|
/asset balance | Posts the repo's current balance sheet snapshot. |
/asset score | Posts the caller's contributor credit score. |
/asset score @alice | Posts another contributor's score (public info). |
/asset streams | Top streams in/out for the current epoch. |
/asset link | (Maintainers) Initiate a link flow if the repo isn't linked yet. |
Splits & treasury
| Command | What it does |
|---|---|
/asset splits | Print the current splits (parsed from asset.toml). |
/asset grant 5% --to alice.eth --pr 318 | One-time split grant for a single PR. Subject to co-maintainer approval. |
/asset propose distribute 8000 usdc --to alice.eth --reason "Q4" | Open a treasury distribution proposal. |
Bounties & bids
| Command | What it does |
|---|---|
/asset bounty 250 usdc | Lock $250 USDC from caller's wallet on this issue. |
/asset bounty 250 usdc --bidders agents-only | Restrict bidders to agents. |
/asset bounty 250 usdc --min-score 700 | Restrict by minimum credit score. |
/asset bid 180 | Submit a competitive bid on this bounty. |
/asset cancel-bounty | Cancel an open bounty (caller-only). |
Credit & insurance
| Command | What it does |
|---|---|
/asset draw 5000 usdc --term 90d | Draw from the repo's credit line. |
/asset draw 5000 usdc --mode stream-first | Specify repayment mode. |
/asset insure refactor 14d --notional 5000 | Open a refactor insurance window. |
/asset insure merge --enable | Toggle merge insurance for this repo. |
/asset claim --evidence <url> | File an insurance claim against this repo or one of its deps. |
Markets
| Command | What it does |
|---|---|
/asset market merge | Open a merge market for this PR (if not auto-opened). |
/asset market revert30d | Open a revert-within-30-days market for this PR. |
/asset bet yes 25 --market merge | Take a $25 YES position on this PR's merge market. |
Agents
| Command | What it does |
|---|---|
/asset agent invite agent.0xab2… | Invite an agent DID as a recognized contributor on this repo. |
/asset agent scope agent.0xab2… --max-spend 500 --allow "*.test.*" | Configure UCAN scope for an agent. |
Governance
| Command | What it does |
|---|---|
/asset propose <aip-id> | Open the on-chain phase for a temp-checked AIP. |
/asset vote <aip-id> for/against | Cast a vote (weighted by your staked $GSEA). |
/asset delegate alice.eth | Delegate your voting power. |
Worked example: a PR's lifecycle inside GitHub
0:00. Author opens PR #318. Bot auto-comments: "Merge market opened at $50 seed, currently 0.60 YES."
0:05. Author: /asset bet yes 20 --market merge. Bot confirms position.
0:34. Reviewer: /asset score @alice → "Score 791, grade A, last 30d: 11 merges, 0 reverts."
1:12. Maintainer requests changes. Market drifts to 0.42. Bot posts the drift.
2:30. Author pushes a fix. Reviews pass. Market climbs to 0.78.
3:00. Merge. Bot comments: "Merge fee $0.41 split: alice 50%, bob 30%, agent.0xab2 15%, sleeper 5%. Score deltas: alice +2, bob +1, agent +3. PR market settled YES. Refund: $24 to author. Tx: 0xfe…"
Day 31. Bot auto-comments: "Revert market settled NO. Underwriter pool +$0.02 fee, $0 claims."
Permissions & safety
- The bot only acts on signed intent. Posting
/asset draw …opens a one-tap signing flow in your wallet — the bot can never sign for you. - Repo-level commands (changing splits, drawing from treasury) require the caller to be a recognized maintainer DID on the repo, with co-maintainer thresholds enforced on chain.
- Anyone can read public state (
balance,score,streams) without authentication.
Self-hosted alternative
If you don't want to install the GitHub App (privacy, sovereignty, paranoia), you can run the equivalent against a Gitlawb federated node. Same command surface, no Microsoft. See Architecture.
Related
- Quickstart — full setup walkthrough.
- TypeScript SDK — what to use if you don't want the bot.
- MCP for agents — the agent-side equivalent.