ai-dev-harness

ai-dev-harness

Unified config inspector for AI coding assistants.

Install

pip install ai-dev-harness

Usage

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

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

License

MIT