# git-span

> git-span is a CLI for git-native semantic code annotations: declare the couplings in your codebase that nothing enforces, then let every Claude Code and Codex session read them from your source tree.

## Start here

- [Documentation index](https://git-span.com/docs/llms.txt) - The complete, ordered index of every documentation chapter.

## Source

- [GitHub repository](https://github.com/goodfoot-io/git-span) - The git-span source, issue tracker, and release notes.

## CLI

- [Getting started](https://git-span.com/docs/getting-started.md) - Install the git-span CLI, then wire it into Claude Code or OpenAI Codex.
- [Command reference](https://git-span.com/docs/commands.md) - Every subcommand, grouped by task, with flags and exit behavior.

## Agent integrations

- [Agent integration](https://git-span.com/docs/agent-integration.md) - What the Claude Code and Codex plugins wire up.
- [Concepts](https://git-span.com/docs/concepts.md) - Spans, anchors, drift, and the trust boundary around git-span's output.

## Optional

- [Full documentation corpus](https://git-span.com/docs/llms-full.txt) - Every chapter's Markdown concatenated for bulk ingestion; not the default path.