Metadata-Version: 2.4
Name: clou-ai
Version: 0.1.2
Summary: Agentic coding system for software construction
Project-URL: Homepage, https://github.com/ejmockler/clou
Project-URL: Repository, https://github.com/ejmockler/clou
Project-URL: Issues, https://github.com/ejmockler/clou/issues
Author: ejmockler
License: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: claude-agent-sdk>=0.1.49
Requires-Dist: textual>=1.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# Clou

Clou is an orchestrator for structured work — it manages a three-tier hierarchy of agent sessions, persistent planning state, quality gates, and verification. The planning layer — not generation — is the bottleneck in agentic systems. Clou maintains a persistent, human-readable golden context (`.clou/`) that serves as both the agent's working memory and the human's legibility surface.

## Prerequisites

Clou requires the [Claude CLI](https://docs.anthropic.com/en/docs/claude-code):

```bash
npm install -g @anthropic-ai/claude-code
```

## Installation

```bash
pipx install clou-ai
```

Or with pip:

```bash
pip install clou-ai
```

## Auth Setup

Verify that your Claude CLI is authenticated:

```bash
clou auth
```

If not logged in, the command will guide you through setup.

## Quick Start

```bash
# Initialize a project in the current directory
clou init

# Launch the TUI
clou

# Resume the most recent session
clou --continue

# Resume a specific session
clou --resume SESSION_ID
```

## License

[Apache 2.0](LICENSE)
