container-git-environment

Coordinate git data flow between containerized agents and a host bare repository.

2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/buchananwill/ue-claude-scaffold --skill container-git-environment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: container-git-environment
Source: https://github.com/buchananwill/ue-claude-scaffold/tree/main/skills/container-git-environment
Command: npx skills add https://github.com/buchananwill/ue-claude-scaffold --skill container-git-environment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Containers interact with a bare git repository on the host. This skill describes the git data flow.

Core Features & Use Cases

  • Branch Model: Each container agent works on its own branch docker/{project-id}/{agent-name}, with the seed branch docker/{project-id}/current-root that is synced from the exterior repo. Agent branches fork from current-root on first launch.
  • Clone & Working Copy: The container's entrypoint clones from the bare repo at startup, and your workspace is a normal git checkout of your agent's branch.
  • Persistence & Safety: Write agents automatically push to docker/{project-id}/{agent-name}, build-intercept agents push before the host build, and read-only agents keep a ephemeral workspace with no persistence. You can read other branches with specified commands.
  • Visibility & Lifecycle: Branches are visible to the coordination server; the bare repo is persistent and created once by setup.sh.
  • Reading Other Branches: You can inspect other branches locally using git commands such as git show docker/{project-id}/agent-2:Source/MyFile.cpp, git log docker/{project-id}/current-root --oneline -10, git diff HEAD..docker/{project-id}/current-root -- Source/

Quick Start

Launch a container agent; it will clone the bare repository into its dedicated docker/{project-id}/{agent-name} branch on startup.

Frequently Asked Questions about container-git-environment

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

FAQPage Schema
How do I manage git workflows for containerized agents using a bare repository?

Containerized agents clone a bare repository at startup into isolated branches, allowing each container to work independently and push changes through a controlled workflow. This setup ensures branch-persisted history via hooks and host coordination.

What is the best way to isolate git branches for multiple Docker containers working on the same project?

Each container agent operates on its own branch named docker/{project-id}/{agent-name}, forking from a shared seed branch docker/{project-id}/current-root. This model isolates changes while maintaining a synchronized project baseline across containers.

How do containerized agents persist git changes to a host bare repository?

Write agents automatically push commits to their dedicated branch docker/{project-id}/{agent-name}, while build-intercept agents push changes before the host build executes. Read-only agents use an ephemeral workspace with no persistence.

Can a container agent read files from other branches in the host bare git repository?

Yes, container agents can inspect other branches locally using git commands such as git show or git log against branch names like docker/{project-id}/current-root to view file contents and commit history without switching checkouts.

Do I need a central bare git repository to coordinate multiple containerized agents?

Yes, a persistent bare repository created once by setup.sh acts as the central coordination point. Container entrypoints clone this bare repo at startup to establish their working copies and push branches back for visibility.

What are the limitations of using ephemeral workspaces for read-only container agents?

Read-only container agents keep an ephemeral workspace with no persistence, meaning their local changes are lost when the container stops. They cannot push to the bare repository, unlike write agents which automatically persist branch history.