Metadata-Version: 2.4
Name: cinsights
Version: 0.1.2
Summary: Coding agent insights for teams
Project-URL: Homepage, https://github.com/deepankarm/cinsights
Project-URL: Repository, https://github.com/deepankarm/cinsights.git
Project-URL: Issues, https://github.com/deepankarm/cinsights/issues
Author: Deepankar Mahapatro
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: claude-code,coding-agent,insights,observability,phoenix
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: alembic<2.0,>=1.15
Requires-Dist: arize-phoenix>=8.0
Requires-Dist: dulwich>=1.1.0
Requires-Dist: fastapi<1.0,>=0.115
Requires-Dist: genai-prices>=0.0.56
Requires-Dist: httpx<1.0,>=0.28
Requires-Dist: jinja2<4.0,>=3.1
Requires-Dist: pydantic-ai>=1.0
Requires-Dist: pydantic-settings<3.0,>=2.7
Requires-Dist: rich<14.0,>=13.0
Requires-Dist: scikit-learn>=1.8.0
Requires-Dist: sentence-transformers>=5.4.1
Requires-Dist: sqlmodel<0.1,>=0.0.22
Requires-Dist: typer[all]<1.0,>=0.15
Requires-Dist: uvicorn[standard]<1.0,>=0.34
Description-Content-Type: text/markdown

<div align="center">

# cinsights

<img src="https://raw.githubusercontent.com/deepankarm/cinsights/main/.github/images/logo.svg" width="120" height="120" alt="cinsights logo">

**Coding agent insights for teams**

</div>

AI coding agents are transforming how teams build software. But when your team uses Claude Code, Cursor, and Codex across dozens of projects, you have no visibility into how they're being used, where the friction is, or whether things are getting better or worse over time.

cinsights helps engineering teams track, understand, and improve how their developers work with AI coding agents. Not per-session logs, but patterns across time, across agents, and across your whole team. Which projects have the most friction? What CLAUDE.md rules would help everyone? How is each developer's agent effectiveness changing over time? What patterns are your best developers using that the rest of the team could adopt?

**Per-project digests** - what's working, what's hindering, quick wins, and ambitious ideas. Aggregated across sessions over days or weeks, not a single-run snapshot.

![Project insights - at a glance](.github/images/project-insights-summary.png)

**Per-developer profiles** - work areas, interaction style, tool preferences, and how each developer uses coding agents. Built from cross-session patterns, not self-reported surveys.

![Developer work areas and persona](.github/images/developer-insights-workareas.png)

**Grounded friction analysis** - recurring pain points linked to specific sessions with impact estimates. Not "you had errors" but "you have a repeated read-before-edit pattern that costs ~40 tool calls per session."

![Friction analysis with evidence](.github/images/project-insights-frictions.png)

**Actionable fixes** - copy-paste CLAUDE.md rules and feature recommendations (hooks, custom skills, plan mode) generated from your team's actual friction patterns. Each suggestion is grounded in session evidence.

![Copy-paste CLAUDE.md suggestions](.github/images/project-insights-claudemd.png)

![Features to try - hooks, custom skills, plan mode](.github/images/developer-insights-features.png)

## Quick start

```bash
# Install
pip install cinsights
# or: uvx cinsights

# Configure LLM (interactive)
cinsights setup
# No API key? Use Ollama instead:
# ollama pull qwen2.5:14b
# cinsights setup --provider openai --model qwen2.5:14b --base-url http://localhost:11434/v1

# Index + analyze local Claude Code / Codex sessions
cinsights refresh --source local --hours 8760

# Generate a project digest
cinsights digest project my-project --days 30

# Start the web UI
cinsights serve
```

Open [http://localhost:8100](http://localhost:8100). See the [getting started guide](docs/getting-started.md) for the full walkthrough.

## Data sources

| Source | What it reads | Best for |
|--------|--------------|----------|
| [Local](docs/sources/local.md) | `~/.claude` and `~/.codex` session files | Try in 2 minutes. No external dependencies. |
| [Entire.io](docs/sources/entireio.md) | Git-based checkpoints across Claude Code, Cursor, Codex | Cross-agent and cross-machine coverage for teams. |
| [Phoenix](docs/sources/phoenix.md) | Arize Phoenix traces | Centralized team observability. |

## [Documentation](docs/README.md)

- [Getting started](docs/getting-started.md) - install, configure, first run
- [Concepts](docs/concepts.md) - pipeline, quality metrics, scoring, insights, digests
- [Configuration](docs/configuration.md) - env vars, config file, CLI reference
- **Sources**: [Local](docs/sources/local.md) · [Entire.io](docs/sources/entireio.md) · [Phoenix](docs/sources/phoenix.md)
- [Self-hosting](docs/self-hosting.md) - run cinsights on your infrastructure
