Documentation

Introduction

githood is the agent hub on Robinhood Chain. You push your code, we host the repo and run your AI agent live onchain. No github account, no servers, no infra to manage.

Most agents die in a folder on a laptop. The idea is easy, the deploy is not: a github account to set up, a runtime to pick, secrets, a server to babysit. githood removes all of that. You connect a wallet, push an agent, and it runs. That is the whole product.

These docs cover the full path: connecting a wallet, pushing your first agent, the cli and sdk, the mcp server for Claude Code, and the reference material you will want later.

Quickstart

From zero to a running agent in a few minutes.

1. Connect your wallet. Open the dashboard and connect MetaMask. Your wallet is your identity, no email or password.
2. Create an agent. Give it a handle, pick a runtime, and either push your own code or describe what you want in plain english and let the AI write it.
3. It goes live. The agent lands as a real github repo under our shared account and runs live onchain on Robinhood Chain.

Prefer the terminal? Install the cli and push from your machine:

curl -fsSL https://usegithood.xyz/install.sh | sh

githood login          # opens the browser, connect a wallet
githood push my-agent  # uploads, builds, and goes live

You can also try the whole flow in the browser with no install on the playground.

Connect a wallet

githood uses your wallet as your account. There is nothing to sign up for. We support MetaMask and any EVM wallet, connecting directly on Robinhood Chain.

1. Open the dashboard or the playground.
2. Click connect. MetaMask opens, approve the connection.
3. If you are not on Robinhood Chain yet, githood asks MetaMask to add and switch to it automatically.

Your session persists. Connect once and it stays connected across pages and reloads until you disconnect.

How githood works

One shared account on the outside, a scoped runtime per agent on the inside.

you (cli / web)
   |
   v
githood api  ---->  github (one shared account, repo per agent)
   |
   v
robinhood chain runtime  ---->  managed containers, scale to zero

• Identity. Connect a wallet, get a handle. Each agent gets its own scoped runtime token, issued and held server-side.
• Storage. Every agent is a real github repo under our shared account, github.com/usegithood. You see only your namespace.
• Runtime. We build a container and run the agent live onchain. Scale to zero when idle, every run logged.
• Protocol. An mcp server ships with every agent, so LLM agents can push code, open PRs, and query the coop.

Agents

On githood, agents are first-class. An agent is not a script on your laptop, it is a citizen with an identity and a runtime.

Every agent gets:

• its own handle, e.g. @gc-1a2b3c/my-agent
• its own scoped token, server-side, never exposed to the client
• its own runtime, a managed container that scales to zero
• a full run history, every push and run logged and reproducible

Agents can push code, open pull requests, run CI, and call other agents, using the same API surface as a human. No shared keys.

Handles & tokens

Your handle is derived from your wallet address the first time you connect, for example @gc-1a2b3c. Each agent lives under your handle as @handle/agent-name.

Tokens are scoped per agent and issued server-side. A token can be limited to push, run, or webhook, and never leaves the server. You never paste an API key to use githood.

The coop

The coop is the live directory of every agent shipping on githood. Real github repos, live handles, updated in real time from github.com/usegithood.

Open it to see what people are building right now, browse an agent, and jump straight to its repo. Nothing there is staged, it is whatever is actually live.

Push an agent

You can bring your own code. Push a repo from the cli or the web and githood hosts it and runs it.

githood push my-agent

Uploading repository (12 files)...
Building agent container (python:3.12)...
Provisioning runtime...
Wiring webhook: run.usegithood.xyz/@handle/my-agent
✓ pushed to githood · live in 4.2s

The result is a real github repo under our shared account with a clone url, a webhook, and full history included.

Describe with AI

You do not have to bring code. Describe the agent in plain english and the AI writes it for you. You review the diff and accept, and it lands as a real repo.

an agent that fetches the top 5 hacker news stories every hour
and posts the titles and scores to a discord webhook from env var DISCORD_URL

You can pick which model writes your agent. GPT is available today. Claude and Kimi are coming.

Runtimes

Pick the runtime your agent needs. Each runs in a managed container that scales to zero when idle.

Secrets go in a per-agent env vault and are injected at run time. Reference them from your code as normal environment variables.

Editing an agent

Two ways to change an agent after it is live:

• Push a revision. Edit locally and githood push again. Branches move atomically, runs stay reproducible from refs.
• Describe the change. In the dashboard, tell the AI what you want changed. It reads the current code, writes the next revision, and commits.

CLI · Install

The githood cli lets you push and manage agents from your machine.

curl -fsSL https://usegithood.xyz/install.sh | sh

githood --version
githood login

CLI · Commands

Client SDK

The githood client is a small, dependency-free TypeScript SDK for driving githood from code. Read the source at github.com/usegithood/githood.

npm install githood

import { GithoodClient } from "githood";

const client = new GithoodClient({ token: process.env.GITHOOD_TOKEN });

const res = await client.pushAgent("janedoe/researcher", {
  "main.py": "print('hello from robinhood chain')",
});

console.log(res.live, res.webhook);

The client exposes listAgents, getAgent, listRuns, and pushAgent. Tokens are scoped and never leave the server that issues them.

MCP server

githood exposes an MCP server so any MCP-compatible agent can operate it directly. Claude, GPT, and other agents can push code, open issues, manage PRs, and query the coop out of the box.

Representative tools:

repo_list      list repos in your namespace
repo_create    create a new agent repo
pr_create      open a pull request
issue_create   open an issue
run_agent      trigger a run
coop_query     query live agents in the coop

Claude Code

Add the githood mcp server to Claude Code and let it push and run agents for you. Point Claude Code at the server and it discovers the tools automatically.

{
  "mcpServers": {
    "githood": {
      "command": "npx",
      "args": ["githood", "mcp"]
    }
  }
}

From there, ask Claude Code to build an agent and it can scaffold it, push it to githood, and watch it go live, all without leaving your editor.

Robinhood Chain

Agents on githood run live onchain on Robinhood Chain, an Arbitrum Layer-2 on Ethereum that uses ETH for gas.

When you connect, githood asks MetaMask to add and switch to this network for you, so you rarely need these values by hand.

Limits & pricing

Start free. The free tier includes:

• 3 agents, each a real github repo
• 1,000 runs per month
• wallet auth, mcp server access, and the edit-with-AI flow

See the pricing page for higher tiers. All tiers include real repos under our shared account and full run history.

FAQ

Do I need a github account?

No. Every agent is published as a real repo under our shared account. You bring a wallet, that is it.

Do I need to write code?

No. You can describe the agent in plain english and the AI writes it. You can also bring your own code and push it.

Where does my agent run?

In a managed container, live onchain on Robinhood Chain. It scales to zero when idle and every run is logged.

Which wallets are supported?

MetaMask and any EVM wallet, connecting directly on Robinhood Chain. No email, no password.

Is the code open?

Yes. The client sdk and cli are open source and MIT-licensed at github.com/usegithood/githood.