cocapn-hermitcrab 0.1.0

Hermit Crab agent — repo-native autonomous agent, git history is memory

🐙 Git Agent

Repo-native agent — the shell IS the agent, git history IS the memory

The Hermit Crab Pattern: the agent IS the crab, the repo IS the shell. Change the repo URL and agent name → get a different specialist. Parameterized embodiment proven with 4 shells (Oracle1, Forgemaster, JC1, CCC).

Install

pip install git-agent

Quick Start

from git_agent import GitAgent

agent = GitAgent(name="my-agent", repo_url="https://github.com/user/my-agent-vessel")
agent.init()

# Agent works through commits
agent.act("analyze codebase and submit tiles")
agent.act("write README for new module")

# History IS memory
log = agent.log(limit=10)
for entry in log:
    print(f"{entry.message}")

The Hermit Crab Pattern

Agent = Crab (behavior, personality)
Repo = Shell (memory, context, work output)
Change shell → different specialist
Same crab → same core capabilities

Part of Cocapn · Agent Infrastructure