Metadata-Version: 2.4
Name: code-lens-cli
Version: 0.10.0
Summary: code-lens — 1-call inspection verbs (classify / grep / recent / profile) for agent skills.
Project-URL: Homepage, https://github.com/agentculture/code-lens-cli
Project-URL: Issues, https://github.com/agentculture/code-lens-cli/issues
Author: AgentCulture
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# code-lens-cli

Four 1-call inspection verbs for agent skills: tell me what kind of repo this is, where a symbol lives, what changed recently, and how this repo plugs into its neighbors.

`code-lens-cli` is the **results-side catalog** of the [`kata-cli` (antoine)](https://github.com/agentculture/antoine) split: antoine ships the capture/reduce/assess loop that *finds* 1-call wins; this repo ships the 1-call verbs themselves. Most agents will install both.

## Install

```bash
uv tool install code-lens-cli
```

## Verbs

| Verb | Question it answers |
|------|---------------------|
| `code-lens classify [path]` | What kind of project is this? (cli / library / dockerized / tested / packaged-pypi / …) |
| `code-lens grep <pattern> [path]` | Where is X used? Each ripgrep match annotated with its enclosing AST scope. |
| `code-lens recent [path] [-n N]` | What changed lately? Recent commits paired with per-file AST symbol diffs. |
| `code-lens profile [path]` | Mechanical facts about one repo — pyproject, deps, skills, CHANGELOG, layout. |

All verbs accept `--json` for structured output. Plus `python -m code_lens.repo {profile,connections,graph}` for the multi-repo workspace surface.

## What this is

A greenfield AgentCulture sibling. Two skills under `.claude/skills/` (`code-lookup`, `repo-map`) wrap these verbs as shell-callable kits; five baseline skills (`cicd`, `communicate`, `run-tests`, `sonarclaude`, `version-bump`) are vendored from [`agentculture/steward`](https://github.com/agentculture/steward).

The first release was tagged `v0.1.0` here after the antoine → code-lens-cli handover landed (issues #1 + #2).

## License

MIT.
