Metadata-Version: 2.4
Name: compos-cli
Version: 0.1.1
Summary: Architectural memory CLI for your codebase
Project-URL: Homepage, https://github.com/fer46/compos
Project-URL: Repository, https://github.com/fer46/compos
Project-URL: Issues, https://github.com/fer46/compos/issues
Project-URL: Documentation, https://github.com/fer46/compos#readme
Author: Fer Aliaga
License-Expression: MIT
Keywords: ai-tooling,architectural-memory,architecture,claude,codebase,documentation,llm,mcp,static-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: tree-sitter-javascript>=0.23
Requires-Dist: tree-sitter-typescript>=0.23
Requires-Dist: tree-sitter>=0.23
Requires-Dist: typer
Description-Content-Type: text/markdown

# compos-cli

Command-line interface for [Compos](https://github.com/fer46/compos) — persistent architectural memory for your codebase.

## Install

```bash
uv tool install compos-cli
# or: pipx install compos-cli
```

Requires Python 3.13+.

## Usage

```bash
compos init            # create .compos/map.json in the current project
compos analyze         # run static analysis and populate the map
compos versions        # list map versions
compos snapshot <N>    # view a specific version
compos --version
compos --help
```

## What it does

Runs language analyzers (Python, TypeScript, Docker Compose) to detect:

- **Components** — services, libraries, databases, frontends (with source-file paths)
- **Relationships** — imports, HTTP calls, DB queries, event publishes

Results merge into `.compos/map.json`, a deterministic JSON document versioned on each run.

## Companion tools

- **[compos-mcp](https://pypi.org/project/compos-mcp/)** — MCP server for AI builders
- **[Claude Code plugin](https://github.com/fer46/compos-plugin)** — `/install-plugin github:fer46/compos-plugin`

## Documentation

Full docs, concepts, and tier comparison: **<https://github.com/fer46/compos>**.

## License

MIT.
