hologit

Project declarative virtual holobranches from mapped Git sources with containerized transformations.

23|2|Updated Jul 11, 2016
One-click install
npx skills add https://github.com/JarvusInnovations/hologit --skill hologit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hologit
Source: https://github.com/JarvusInnovations/hologit/tree/main/skills/hologit
Command: npx skills add https://github.com/JarvusInnovations/hologit --skill hologit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Hologit removes the manual, error-prone work of assembling code and generated artifacts across repos by letting you declaratively define virtual branches that combine sources and apply transformations deterministically inside Git.

Core Features & Use Cases

  • Holobranches & holomappings: define what content to include and where it should land in an output tree, using layered inclusion rules and topological ordering.
  • Holosources: pull content from other repositories and branches (including projected holobranches inside sources), and support workspace self-references.
  • Hololenses: transform projected trees via containerized lenses (and optional companion data) with internal (inheritable) and external (branch-specific) execution phases.
  • Efficient projection & caching: compute output trees via Git object primitives and cache lens results using deterministic spec hashes to avoid redoing work.

Quick Start

Initialize a hologit workspace and project a holobranch by running: git holo project my-branch.

Frequently Asked Questions about hologit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I declaratively project Git branches from multiple repositories?

To project Git branches declaratively, define a .holo/ workspace with TOML configs for holosources and holobranches, then run git holo project to compose mapped sources and compute the resulting output tree hash.

What is a declarative virtual holobranch in Git?

A declarative virtual holobranch is a computed Git tree that combines content from multiple mapped sources and applies transformations. It removes manual assembly by using layered inclusion rules and topological ordering to build deterministic output trees.

How do containerized lenses transform projected Git trees?

Containerized lenses transform projected Git trees by executing Docker-based transformations in internal and external phases. You define these lenses in TOML configs to deterministically modify the projected content during the git holo project workflow.

Can I use cached builds to avoid redoing transformations across multiple repositories?

Yes, cached builds avoid redoing transformations by caching lens results using deterministic spec hashes. When projecting Git branches across multiple repositories, the system checks these hashes to skip unchanged work and compute output trees efficiently.

Does generating Kubernetes manifests and documentation from Git require a specific workspace setup?

Generating Kubernetes manifests and documentation from Git requires a .holo/ workspace setup. You must define TOML configurations for holobranches, holosources, holomappings, and hololenses to establish the deterministic rules before executing the projection.

What is the best way to mix multiple repositories and generate artifacts deterministically?

The best way to mix multiple repositories and generate artifacts deterministically is using declarative holobranches with Git object primitives. This approach applies topological ordering and containerized lenses to ensure consistent, cached output trees without manual assembly.