Spaces:

Stanicky
/

repolith

Running

File size: 5,567 Bytes

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Repolith — coordination layer for parallel Claude Code sessions</title>
<meta name="description" content="File-level locks, plan-conflict detection, and auto-resume for multiple Claude Code sessions on the same repos.">
<style>
  :root { color-scheme: dark; }
  * { box-sizing: border-box; }
  body {
    margin: 0; background: #0b0d12; color: #d7dbe4;
    font: 16px/1.6 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
    -webkit-font-smoothing: antialiased;
  }
  main { max-width: 880px; margin: 0 auto; padding: 56px 24px 80px; }
  h1 { font-size: 2rem; margin: 0 0 4px; color: #f2f4f8; letter-spacing: -0.02em; }
  .tag { color: #8b93a7; margin: 0 0 28px; font-size: 1.05rem; }
  .hero-sub { max-width: 640px; color: #aab1c2; margin: 0 0 28px; }
  img.demo { width: 100%; border-radius: 10px; border: 1px solid #232838; display: block; }
  .caption { color: #6d7488; font-size: .82rem; margin: 8px 0 36px; }
  .install {
    display: inline-block; background: #141824; border: 1px solid #2a3145; border-radius: 8px;
    padding: 10px 18px; font: 500 .95rem/1 ui-monospace, "Cascadia Code", Consolas, monospace;
    color: #9ee6b8; margin: 0 0 40px;
  }
  .stats { display: flex; flex-wrap: wrap; gap: 12px; margin: 0 0 12px; }
  .stat { background: #10131c; border: 1px solid #1e2434; border-radius: 10px; padding: 14px 18px; flex: 1 1 150px; }
  .stat b { display: block; font-size: 1.35rem; color: #f2f4f8; font-variant-numeric: tabular-nums; }
  .stat span { font-size: .8rem; color: #8b93a7; }
  .stats-note { color: #6d7488; font-size: .82rem; margin: 0 0 44px; }
  h2 { font-size: 1.15rem; color: #f2f4f8; margin: 0 0 10px; }
  .cols { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 16px; margin: 0 0 44px; }
  .col { background: #10131c; border: 1px solid #1e2434; border-radius: 10px; padding: 18px; }
  .col h3 { margin: 0 0 8px; font-size: .95rem; color: #e6e9f0; }
  .col p { margin: 0; font-size: .88rem; color: #9aa1b4; }
  .limits { border-left: 3px solid #4a5268; padding: 4px 0 4px 16px; color: #8b93a7; font-size: .88rem; margin: 0 0 44px; }
  .links a { color: #7fb3ff; text-decoration: none; margin-right: 22px; font-size: .95rem; }
  .links a:hover { text-decoration: underline; }
  footer { margin-top: 48px; color: #59607a; font-size: .8rem; }
</style>
</head>
<body>
<main>
  <h1>repolith</h1>
  <p class="tag">The coordination layer for parallel AI coding agents.</p>
  <p class="hero-sub">File-level locks, plan-conflict detection, and auto-resume for multiple Claude Code
  sessions on the same repos. Worktree isolation defers the conflict to merge time — after every session
  already did the work. Coordination prevents it at plan time and edit time.</p>

  <div class="install">npm i -g repolith</div>

  <img class="demo" src="demo.gif" alt="Two Claude Code sessions edit the same file: session A claims it on first touch, session B is denied with the holder named, waits, and auto-resumes the moment A commits.">
  <p class="caption">Real repolith from npm, nothing mocked — two sessions collide, the second is denied, waits, and auto-resumes.</p>

  <div class="stats">
    <div class="stat"><b>914</b><span>sessions coordinated</span></div>
    <div class="stat"><b>20,994</b><span>file claims</span></div>
    <div class="stat"><b>3,168</b><span>collisions denied</span></div>
    <div class="stat"><b>552</b><span>FIFO auto-resumes</span></div>
    <div class="stat"><b>17</b><span>conflicts caught at plan time</span></div>
  </div>
  <p class="stats-note">9 weeks of dogfooding on the author's own two-repo workspace (Jun 29 – Aug 30, 2026). Exact counts from the coordination journal.</p>

  <h2>How it works</h2>
  <div class="cols">
    <div class="col">
      <h3>Plan-time catch</h3>
      <p>A hook on ExitPlanMode captures each session's plan. Two plans overlapping on the same files? The second session finds out before writing a line.</p>
    </div>
    <div class="col">
      <h3>Edit gate + auto-resume</h3>
      <p>First touch claims the file. A second live session is denied with the holder named, can queue, and resumes FIFO the moment the file frees up. Deadlocks are surfaced, not hung.</p>
    </div>
    <div class="col">
      <h3>Journal + drift control</h3>
      <p>Every file has a journal. Sessions read what the last session did there before editing, and get a catch-up brief on start. Heartbeats + git-verified staleness keep crashed sessions from wedging the store.</p>
    </div>
  </div>

  <p class="limits"><strong>Honest limits:</strong> same-machine only (shared JSON store), cooperative — it
  coordinates sessions that run the hooks. Claude Code today; other agents via the CLI. Advisory by design:
  every hook exits 0 on internal failure, so coordination can never break your edit flow. Also does multi-repo:
  TOML manifest, lockfile with an atomic workspace hash, parallel dispatch, VS Code extension.</p>

  <p class="links">
    <a href="https://github.com/ethanrickyjrjr-wq/repolith">GitHub</a>
    <a href="https://www.npmjs.com/package/repolith">npm</a>
    <a href="https://marketplace.visualstudio.com/items?itemName=stanicky.repolith-vscode">VS Code</a>
    <a href="https://ethanrickyjrjr-wq.github.io/repolith-site/">Site + team-tier waitlist</a>
  </p>

  <footer>MIT · TypeScript on Bun · no daemon, no server — a JSON store and git</footer>
</main>
</body>
</html>