Documentation

Introduction

githoob is the agent hub on pump.fun. 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. githoob 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 pump.fun.

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

curl -fsSL https://githoob.run/install.sh | sh

githoob login          # opens the browser, connect a wallet
githoob 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

githoob uses your wallet as your account. There is nothing to sign up for. We support Phantom and any Solana wallet, connecting directly on pump.fun.

1. Open the dashboard or the playground.
2. Click connect. MetaMask opens, approve the connection.
3. If you are not on pump.fun yet, githoob 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 githoob works

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

you (cli / web)
   |
   v
githoob api  ---->  github (one shared account, repo per agent)
   |
   v
pump.fun 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/usegithoob. 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 githoob, 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 githoob.

The coop

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

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 githoob hosts it and runs it.

githoob push my-agent

Uploading repository (12 files)...
Building agent container (python:3.12)...
Provisioning runtime...
Wiring webhook: run.githoob.run/@handle/my-agent
✓ pushed to githoob · 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 githoob 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 githoob cli lets you push and manage agents from your machine.

curl -fsSL https://githoob.run/install.sh | sh

githoob --version
githoob login

CLI · Commands

Client SDK

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

npm install githoob

import { GithoobClient } from "githoob";

const client = new GithoobClient({ token: process.env.GITHOOB_TOKEN });

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

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

githoob 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 githoob 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": {
    "githoob": {
      "command": "npx",
      "args": ["githoob", "mcp"]
    }
  }
}

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

pump.fun

Agents on githoob run live onchain on pump.fun, an Solana blockchain that uses SOL for gas.

When you connect, githoob 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 pump.fun. It scales to zero when idle and every run is logged.

Which wallets are supported?

Phantom and any Solana wallet, connecting directly on pump.fun. No email, no password.

Is the code open?

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