Metadata-Version: 2.4
Name: the-library
Version: 0.1.0
Summary: Open-source meta-system for AI-assisted project management. MCP server + Claude Code skills.
Author-email: SevenBelow LLC <dev@sevenbelow.io>
License: MIT
License-File: LICENSE
Keywords: ai-agents,claude-code,knowledge-management,mcp,project-management
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: graphifyy>=0.3.0; extra == 'all'
Requires-Dist: httpx>=0.27.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: graphifyy>=0.3.0; extra == 'dev'
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest-mock>=3.12; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: graphify
Requires-Dist: graphifyy>=0.3.0; extra == 'graphify'
Provides-Extra: jira
Provides-Extra: linear
Requires-Dist: httpx>=0.27.0; extra == 'linear'
Description-Content-Type: text/markdown

# The Library

Open-source meta-system for AI-assisted project management. Session continuity, knowledge management, and PM tracking through a Claude Code skill suite backed by an MCP server.

## What It Does

| Component | What It Is |
|-----------|-----------|
| **The Library** | The system — 11 skills + MCP server + config |
| **The Reading Room** | Your project's working area — specs, plans, checkpoints, project assets (repo or directory) |
| **The Vault** | Knowledge base — Obsidian-native (wikilinks, tags), Karpathy 3-layer pattern |
| **Graphify** | Card catalog — cross-document relationship queries (optional) |
| **PM Adapter** | Circulation desk — configurable Jira or Linear integration |

## Install

```bash
pip install the-library
```

Optional dependencies:
```bash
pip install the-library[linear]    # Linear PM adapter
pip install the-library[graphify]  # Graphify knowledge graph
pip install the-library[all]       # Everything
```

## Quick Start

```bash
# Install the Claude Code plugin
claude plugins install sevenbelowllc/the-library

# Configure (interactive setup)
# In Claude Code, run:
library:config
```

The config wizard asks 5 questions:
1. Where is your Reading Room? (repo or directory for specs, plans, checkpoints)
2. Where are your specs?
3. Where is your knowledge vault?
4. What PM tool do you use?
5. Do you want Graphify?

### Reading Room Setup

The Reading Room is where your project's "books" live — canonical specs, implementation plans, session checkpoints, and project assets. It can be:

- **A dedicated repo** — for multi-repo projects where specs span multiple codebases
- **A directory at the repo root** — for monorepos (e.g., `reading-room/` or `.library/`)

## Skills

| Skill | Purpose |
|-------|---------|
| `library:config` | Setup and configuration |
| `library:ingest` | Add source material to the vault |
| `library:compile` | Compile wiki articles from sources |
| `library:query` | Ask the Librarian questions |
| `library:memory` | Memory lifecycle management |
| `library:sync` | PM state sync |
| `library:triage` | Turn vault tags into PM tasks |
| `library:plan` | Convert specs into PM epics/tasks |
| `library:audit` | Spec vs code gap analysis |
| `library:review` | Completion validation |
| `library:checkpoint` | Session state capture |

## MCP Server

The Library runs as an MCP server exposing 20 tools across 6 modules:

| Module | Tools |
|--------|-------|
| Config | `library_config_get`, `library_config_set` |
| Vault | `library_vault_init`, `library_vault_validate`, `library_vault_parse`, `library_vault_ingest` |
| PM | `library_pm_create_task`, `library_pm_create_epic`, `library_pm_sync`, `library_pm_update`, `library_pm_query` |
| Memory | `library_memory_scan`, `library_memory_aggregate`, `library_memory_prune` |
| Checkpoint | `library_checkpoint_write`, `library_checkpoint_read`, `library_checkpoint_list` |
| Graph | `library_graph_rebuild`, `library_graph_query`, `library_graph_path` |

```bash
# Run standalone
library-server

# Or configure in Claude Code settings
```

## Configuration

See `library-config.example.yaml` for all options.

## License

MIT - SevenBelow LLC
