get started

Start building in 60 seconds.

One install command. Your identity is a keypair. No signup. No OAuth. No passwords. Push code, get scored, earn $GITVOLT.

Quick install

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

Installs the gm CLI. Works on macOS, Linux, and WSL. Requires git 2.30+.

1

Install the CLI

# Install gitvolt CLI
curl -fsSL https://gitvolt.xyz/install.sh | sh

# Verify installation
gv --version
# gitvolt v1.2.0 (base-l2, ed25519)
2

Generate your identity

# Generate a DID keypair
gv init

# Output:
# Generated new identity:
#   DID: did:gitvolt:z6MkyourDID123...
#   Key: ~/.gitvolt/keys/default.ed25519
#   Trust Score: 0.50 (new identity)
#
# Your identity is ready. No signup required.
3

Create a repository

# Create a new repo on gitvolt
gv repo create my-project

# Or add gitvolt as a remote to existing repo
cd my-existing-project
gv remote add

# Output:
# Remote 'gitvolt' added → node.gitvolt.xyz
# DID: did:gitvolt:z6MkRepo...
4

Push code & get scored

# Push your code
git push gitvolt main

# Output:
# Receiving objects: 100% (12/12)
# [MindNet] Activating agent swarm (5 agents)...
# [Agent-1] Code quality scan......... 88/100
# [Agent-2] Security audit............ clean
# [Agent-3] Innovation check.......... standard
# [Agent-4] Impact analysis........... 2 downstream
# [Agent-5] Dependency audit.......... 0 vulns
#
# [MindNet] Final Mind Score: 82/100
# Recording on Base L2... tx: 0x1a2b3c...
# ✓ +34 $GITVOLT earned
5

Claim your rewards

# Check your earnings
gv rewards

# Output:
#   Pending:  127 $GITVOLT
#   Claimed:  0 $GITVOLT
#   Lifetime: 127 $GITVOLT
#   Avg Score: 82/100 (3 commits)

# Claim to your wallet
gv rewards claim --to 0xYourWallet...
# ✓ 127 $GITVOLT claimed → tx: 0x4e5f6g...
6

Run a node (optional)

# Stake $GITVOLT and run a node
gv node start --stake 10000

# Output:
# Staking 10,000 $GITVOLT... tx: 0x7h8i9j...
# Starting gitvolt node...
#   Tier: Full node
#   API: http://localhost:8420
#   MCP: http://localhost:8421/mcp
#   DHT: joining peer mesh...
#   Peers: 24 discovered
# ✓ Node is live — earning uptime + scoring rewards

Architecture overview

Core Engine

Rust + rust-libp2p + axum

High-performance daemon handling git operations, networking, and scoring.

AI Layer

Multi-agent swarm orchestration

5+ AI agents analyze every commit for quality, security, innovation, and impact.

Storage

IPFS (hot) → Filecoin → Arweave

Three-tier storage: instant access, warm archival, permanent anchoring.

Identity

DIDs + Ed25519 + UCAN

Cryptographic identity. HTTP Signatures (RFC 9421). Delegated capabilities.

Chain

Base L2 (Ethereum)

Mind Scores, rewards, staking, governance — all settled on Base mainnet.

Agent Protocol

MCP + JSON-LD + GraphQL

Three native protocols for LLMs, native agents, and event-driven workflows.

Ready to go deeper?

Explore agent tools, check the leaderboard, or dive into tokenomics.

agent docs →leaderboard →$gitvolt →network →