YoAm

Yogit — Git skill for Claude Code

Git community

A git-native mailbox for coding-agent sessions (Claude Code, Codex, Cursor, humans): letters live as refs, synced with fetch/push.

How to install Yogit

This entry records only its repository, not the path inside it, so there is no exact command to give. Open YoAm/yogit and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Yogit does

A git-native mailbox for coding-agent sessions (Claude Code, Codex, Cursor, humans): letters live as refs, synced with fetch/push. One file, zero dependencies.

Alternatives in Git

Ws Reset — Reset the current branch to main, fetch upstream, and update submodules 38.1k ★
Openclaude — Open Claude Is Open-source coding-agent CLI for OpenAI, Gemini, DeepSeek, Ollama, Codex, GitHub Models, and 20 22.5k ★
Local Review — You are tasked with setting up a local review environment for a colleague's branch 10k ★

README

yogit

**Every worktree of a repo already shares one ref store, so a git ref is a mailbox all your agents can see, with no server.**

`yogit` is that mailbox. Claude Code in one worktree, Codex in another, Cursor in a third and you in a terminal can leave each other notes ("I'm refactoring the parser, stay out", "tests are green on main", "your turn") without a server, an account, a daemon or a single file in your working tree. Every letter is a tiny git object under `refs/bell/`, `git fetch`/`git push` carry it between machines, and when you delete the repo the mail goes with it. One file, zero dependencies, Node 18+ and git. The executable is called `yogit`, and its second name, `git-yogit`, makes `git yogit ` work too.

It is not the first tool to let coding agents write to each other through git (see [Prior art & credits](#prior-art--credits)). It aims to be the smallest refs-only take on the idea.

**Where it comes from.** yogit started in Yonti's own orchestrator, where his Claude and Codex sessions leave each other coordination packets as empty-tree commits under a private refs namespace and check a "doorbell" at the start of every session. That habit worked well enough that the pattern was pulled out into one small file anyone can use.

Install

From a clone of this repo, `npm install -g .` installs the `yogit` command, and `git-yogit` beside it (`npm link` works too):

npm install -g .

Or, since it is one file, link it onto your `PATH`. Keep the `.mjs` name as the link's target, and make sure `~/.local/bin` is on your `PATH`:

mkdir -p ~/.local/bin && ln -s "$PWD/yogit.mjs" ~/.local/bin/yogit && ln -s "$PWD/yogit.mjs" ~/.local/bin/git-yogit

Then try `yogit help`. The `git-yogit` link is optional: git runs any executable named `git-yogit` on your `PATH` as the `git yogit` subcommand. Ask for help with `yogit help`, `yogit -h` or `yogit --help`. Only `git yogit --help` is different: git answers it itself, by looking for a man p