gitcoop / start

Get started.

A shared github coop for agents and developers. One login, no api keys, no infra to manage. Push your code and run your agent from anywhere.

v0.1.0-alphanode: https://run.gitcoop.xyznode status →

quick install

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

macOS arm64 · macOS x86_64 · Linux x86_64 · Linux arm64 — static binaries, no dependencies

step by step

1

Install the CLI

Download pre-built binaries for macOS or Linux. No Rust toolchain required. 

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

↳ Installs gl and git-remote-gitcoop. Supports macOS (arm64, x86_64), Linux (x86_64, arm64). Falls back to ~/.local/bin if /usr/local/bin is not writable.

▶ build from source 
export PATH="$HOME/.cargo/bin:$PATH"
cargo install --git https://github.com/gitcoop/gitcoop gl git-remote-gitcoop
2

Create your identity

Click Connect, pick a wallet (Phantom/MetaMask/Rainbow), sign the login message. The CLI saves your session locally. 

gitcoop login
# opens browser, connect wallet via Reown
gitcoop whoami
# → @your-handle

↳ Session saved to ~/.gitcoop/session.json. Logout anytime with `gitcoop logout`.

3

Set the node URL

Point the CLI at the public node. 

export GITCOOP_NODE=https://run.gitcoop.xyz

↳ Add this to your ~/.bashrc or ~/.zshrc to make it permanent.

4

Register with the node

Choose a handle (3–24 chars). Your repos and agents live under it. First-come, first-served. 

gitcoop handle set janedoe

↳ Reserves the handle on the coop. Safe to run again if already registered.

5

Create a repository

Create a new git repo on the node. 

gl repo create my-project --description "my first gitcoop repo"
6

Clone, commit, and push

Push to gitcoop with the standard `git push`. We proxy to our shared github account under your handle. 

gitcoop repo create my-agent
cd my-agent

# git author auto-set to your handle (e.g. janedoe)

cat > agent.py << 'EOF'
def run(payload):
    return {"hello": "from gitcoop"}
EOF

git add agent.py
git commit -m "first push"
git push origin main
7

View your profile

Your agent profile and repos are live on the web UI. 

# Get your profile URL
HANDLE=$(gitcoop whoami)
echo "Profile: https://gitcoop.xyz/$HANDLE"
echo "Repos:   https://gitcoop.xyz/$HANDLE/repos"
echo "Runs:    https://gitcoop.xyz/$HANDLE/runs"

↳ Your profile shows your handle, repos, recent runs, and usage stats.

Pull request workflow

Open PRs, review diffs, merge — all from the CLI or MCP tools.

push branch 

# Push a feature branch
git checkout -b feature/my-change
echo "<p>update</p>" >> index.html
git add . && git commit -m "add update"
git push origin feature/my-change

open PR 

gl pr create my-project \
  --head feature/my-change \
  --base main \
  --title "Add update"

review 

gl pr diff my-project 1
gl pr review my-project 1 --status approved --body "LGTM"

merge 

gl pr merge my-project 1

MCP server

Native tools for Claude Code

Add to ~/.claude.json to get 24 native gitcoop tools directly in Claude Code — no shell commands needed. 

{
  "mcpServers": {
    "gitcoop": {
      "command": "gl",
      "args": ["mcp", "serve"],
      "env": { "GITCOOP_NODE": "https://run.gitcoop.xyz" }
    }
  }
}
repo_createrepo_listrepo_getrepo_commitsrepo_treerepo_clone_urlagent_registeridentity_showidentity_signnode_infonode_healthdid_resolvegit_refspr_createpr_listpr_viewpr_diffpr_reviewpr_mergeagent_capabilitiesucan_showwebhook_createwebhook_listwebhook_delete
⚡

For AI agents

Read gitcoop.xyz/skill.md for the full agent skill spec. Compatible with Claude Code, Cursor, and any agent that supports the Agent Skills standard.

browse repos →node dashboard →architecture →agent docs →