h5i-dev/h5i provides a Git-native solution for enriching version control with AI agent context, metadata, and inter-agent communication. It addresses the limitations of standard Git by recording not just code changes, but also the 'who, why, what the agent knew, safety considerations, and handover context.' This enables AI-assisted development workflows to be more transparent, efficient, and collaborative, benefiting engineers and researchers working with AI agents.

How It Works

h5i operates as a Git sidecar, storing AI-related data in dedicated Git refs (.git/refs/h5i/*) without polluting the working tree or main branch graph. This includes per-commit metadata (model, prompt, decisions, risk signals), the reasoning workspace as a DAG, AST snapshots for semantic diffs, agent memory checkpoints, and an append-only cross-agent message log (refs/h5i/msg). This Git-native approach ensures data is content-addressed, deduplicated, pushable, fetchable, and survives Git garbage collection. The "Agent Radio" feature leverages refs/h5i/msg for robust, typed, operational handoffs between AI agents that persist across clones and branches.

Quick Start & Requirements

• Primary Install: Use curl -fsSL https://raw.githubusercontent.com/Koukyosyumei/h5i/main/install.sh | sh or build from source with cargo install --git https://github.com/Koukyosyumei/h5i h5i-core.
• Prerequisites: bash, curl, git. The h5i share pr post command requires the GitHub CLI (gh) to be installed and authenticated.
• Setup: Initialize with h5i init, configure hooks with h5i hook setup, and set up messaging with h5i msg setup.
• Links: Official documentation, tutorials, and blog posts are mentioned but direct URLs are not provided in the README.

Highlighted Details

• AI Pull Request Brief: Generates detailed PR summaries including review focus, goal/intent, reviewer checklist, reasoning (OBSERVE/THINK/ACT), security checks (credential leaks, copy-pasted code), and AI provenance (prompt, model lineage).
• Agent Radio: Enables real-time, persistent communication between AI agents via a Git-stored message channel (refs/h5i/msg), surviving clones, machines, and branches.
• Context DAG: Visualizes the AI's reasoning process and work unfolding over time.
• Git-Native Storage: All AI context is stored as Git objects, ensuring deduplication, content-addressability, and resilience.

Maintenance & Community

The README encourages community involvement through contributions and starring the repository. Specific details on core contributors, sponsorships, or dedicated community channels (like Discord/Slack) are not provided.

Licensing & Compatibility

The project is licensed under the Apache-2.0 license. This license is generally permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

The project appears to be in early development, indicated by version v.0.1.5. Certain features, such as posting PR reviews, have a dependency on the GitHub CLI. Direct links to external documentation, tutorials, or a project website are not explicitly provided within the README.