Metadata-Version: 2.4
Name: ai-dev-harness
Version: 0.2.2
Summary: Multi-harness AI coding tool config inspector — scan, visualize, and audit AI assistant ecosystems.
Author: Boris Villazon-Terrazas
License-Expression: MIT
Project-URL: Homepage, https://github.com/boricles/claude-lens
Project-URL: Repository, https://github.com/boricles/claude-lens
Project-URL: Bug Tracker, https://github.com/boricles/claude-lens/issues
Project-URL: Changelog, https://github.com/boricles/claude-lens/blob/main/CHANGELOG.md
Keywords: ai-dev-harness,claude-code,cursor,codex,copilot,windsurf,devtools,observability
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: color
Requires-Dist: rich; extra == "color"
Dynamic: license-file

# ai-dev-harness

[![PyPI version](https://img.shields.io/pypi/v/ai-dev-harness.svg)](https://pypi.org/project/ai-dev-harness/)
[![Python 3.10+](https://img.shields.io/pypi/pyversions/ai-dev-harness.svg)](https://pypi.org/project/ai-dev-harness/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Unified config inspector for AI coding assistants.

## Install

```bash
pip install ai-dev-harness
```

## Usage

```bash
ai-dev-harness scan        # Full JSON scan of all detected tools
ai-dev-harness report      # Formatted CLI report
ai-dev-harness harnesses   # List supported tools and detection status
ai-dev-harness web         # Launch interactive web dashboard
ai-dev-harness diff A B    # Compare two projects' config
ai-dev-harness export P    # Export a project's config bundle
ai-dev-harness clean       # Clean up stale sessions and orphaned data
ai-dev-harness version     # Print version
```

## Supported Tools

- **Claude Code** -- `~/.claude/`, `CLAUDE.md`
- **Cursor** -- `~/.cursor/`, `.cursorrules`
- **Codex CLI** -- `~/.codex/`, `AGENTS.md`
- **GitHub Copilot** -- `~/.config/github-copilot/`, `.github/copilot-instructions.md`
- **Windsurf** -- `~/.windsurf/`, `.windsurfrules`

## Aliases

For backwards compatibility, `liteharness` and `claude-lens` also work as CLI commands.

## Design Principles

- Zero mandatory dependencies (stdlib only)
- Local-first -- web server binds to `127.0.0.1` only
- Privacy-safe -- never reads conversation content from session files
- Non-destructive -- never modifies user files unless in explicit `clean` mode

## Development

```bash
git clone https://github.com/boricles/ai-dev-harness.git
cd ai-dev-harness
pip install -e .
python -m pytest tests/ -v
```

## License

MIT
