Metadata-Version: 2.4
Name: cinsights
Version: 0.1.0
Summary: LLM-powered insights from coding agent sessions
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[anthropic]>=1.0
Requires-Dist: pydantic-settings<3.0,>=2.7
Requires-Dist: rich<14.0,>=13.0
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=".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, a fundamental question goes unanswered: *is it actually working?*

cinsights is built for engineering teams that want to understand 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? Which developers are getting the most value? What CLAUDE.md rules would help everyone? Where is token spend going and is it worth it?

**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

# 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
