What is gitlord?

GitLord is a Python framework for building and running AI agents that stores every part of a conversation using Git itself as the storage system. Instead of keeping a session's history in a database, each turn of a conversation, whether from a user, the agent, or a subagent, is written as its own Git commit. Because of that, the entire history of an agent session is inspectable with normal Git tools, can be rewound to any earlier point, and can be forked into a new branch of possibilities the same way a codebase can. Under the hood, each session lives on its own Git branch under a dedicated refs namespace, and any subagents spawned during that session get their own nested branches. The actual content of each turn is stored as a JSON file inside the commit's tree, while metadata like the turn number, its type, which agent produced it, and token counts are attached using Git commit trailers. When a subagent finishes its work, its result gets linked back to the parent session through a trailer as well. The project is organized into separate modules that each handle one concern: low level Git operations for building commits and trees, session lifecycle management for creating and resuming conversations, subagent management for spawning and collecting results, context assembly for deduplicating and summarizing history within a token budget, an MCP server integration layer for tool discovery and calling, a model router for translating tool schemas and handling retries across different LLM providers, and an optional vector index built on ChromaDB for retrieval. A command line tool ships alongside the library, letting a user run a session, view its turn history, inspect the branch structure, show the JSON content of a specific turn by its commit hash, rewind a session back to an earlier checkpoint, or diff two turns against each other. Installation is done through pip, with optional extras for MCP server support, LLM routing through litellm, and the ChromaDB vector index. The project is released under the MIT license.