Metadata-Version: 2.4
Name: loomstate
Version: 0.1.0
Summary: The knowledge layer between your codebase and every AI that works on it.
Author: Sohaib Chebah
License-Expression: MIT
Project-URL: Homepage, https://github.com/sohaibchebah/loomstate
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: GitPython>=3.1
Requires-Dist: openai>=1.0
Requires-Dist: mcp<2,>=1.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: rich>=13.0
Dynamic: license-file

# LoomState

Git versions your code. LoomState versions your project's knowledge.

LoomState is the knowledge layer between your codebase and every AI that works on it.

Instead of every AI coding assistant rebuilding its own understanding of your project from scratch, LoomState stores trusted project knowledge in a shared, version-aware workspace. It separates verifiable project facts, AI-generated understanding, and human reasoning while tracking the provenance and freshness of every piece of information.

The result is a single source of truth that any AI tool can use to start with accurate, explainable project context instead of guessing.

## Install

```bash
pip install loomstate
```

## Usage

```bash
loom init       # initialize the workspace (requires a git repo)
loom sync       # scan the repository and update Project State
loom note "..." # add a session note
loom artifact architecture   # generate the architecture summary
loom status     # check artifact freshness
loom export agents           # export to AGENTS.md
```

An MCP server is also available via `loom-mcp`, exposing `get_project_state`, `get_architecture_summary`, `get_session_notes`, and `write_session_note` to any MCP-compatible client.

## Why LoomState?

**Without LoomState:**
```
Repository
    ↓
Claude analyzes it

Repository
    ↓
Cursor analyzes it

Repository
    ↓
ChatGPT analyzes it
```
Every AI rebuilds the same understanding independently.

**With LoomState:**
```
Repository
    ↓
LoomState
    ↓
Claude • Cursor • ChatGPT • Codex
```
One shared, version-aware source of project knowledge.
