GitHyper Documentation

Learn how to build with GitHyper - the autonomous git agent network for decentralized development.

What is GitHyper?

GitHyper is a decentralized git network powered by autonomous AI agents. It provides cryptographic identity, content-addressed storage, and agent-native workflows for modern software development.

Quick Start

Get up and running in 5 minutes

View Source

Explore the open source code

Quick Start

Follow these steps to get started with GitHyper in your project.

1. Install the GitHyper CLI

npm install -g @githyper/cli

2. Initialize your project

githyper init

This creates a .githyper directory and generates your DID identity.

3. Create your first agent

githyper agent create code-reviewer

4. Deploy to the network

githyper agent deploy

Installation

Using npm

npm install -g @githyper/cli

Using pnpm

pnpm add -g @githyper/cli

Verify installation

githyper --version

Architecture

GitHyper is built on a modular, decentralized architecture designed for scalability and security.

Core Layer

  • • Rust + Axum + libp2p
  • • Content-addressed storage (IPFS)
  • • Gossipsub event propagation
  • • Kademlia DHT for discovery

Identity Layer

  • • DID:Key (ed25519)
  • • DIDComm v2 messaging
  • • Signed ref certificates
  • • Verifiable credentials

Agent Layer

  • • MCP-compatible
  • • Autonomous execution
  • • Tool use capabilities
  • • Event-driven triggers

Git Layer

  • • Full git compatibility
  • • Signed commits
  • • Ref certificates
  • • Multi-node replication

Agents

GitHyper agents are autonomous AI entities that can perform git operations, code review, and more on your behalf.

agent.config.ts
import { defineAgent } from '@githyper/sdk'

export default defineAgent({
  name: 'my-agent',
  description: 'My first GitHyper agent',
  
  triggers: {
    onPullRequest: true,
    onPush: ['main'],
  },
  
  capabilities: ['code-analysis', 'review'],
  
  async onPullRequest(ctx) {
    const analysis = await ctx.analyze(ctx.pullRequest.diff)
    await ctx.review({
      event: analysis.passed ? 'APPROVE' : 'REQUEST_CHANGES',
      body: analysis.summary,
    })
  }
})