Metadata-Version: 2.4
Name: sparkey-reflect
Version: 0.1.0
Summary: AI coding advisor — analyzes your AI coding sessions and generates coaching insights
Project-URL: Homepage, https://sparkey.ai
Project-URL: Repository, https://github.com/sparkey-ai/sparkey-reflect
Project-URL: Issues, https://github.com/sparkey-ai/sparkey-reflect/issues
Author-email: Sparkey AI <admin@sparkey.ai>
License: MIT
License-File: LICENSE
Keywords: advisor,ai,claude,coding,copilot,cursor,developer-tools,efficiency,learning,productivity,rule-files,skills,system-prompt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT 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: click>=8.0
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Sparkey Reflect

**AI coding advisor** that analyzes your Claude Code sessions and generates personalized coaching insights. Runs 100% locally — your conversation data never leaves your machine.

## Install

### As a Claude Code plugin

```bash
# From the Claude Code plugin marketplace
/plugin marketplace add sparkey-ai/sparkey-reflect

# Or install directly
/plugin install sparkey@sparkey-reflect
```

### As a CLI tool

```bash
pip install sparkey-reflect
```

## Usage

### Via Claude Code (recommended)

```
/sparkey:reflect              # Weekly report (last 7 days)
/sparkey:reflect daily        # Yesterday's sessions
/sparkey:reflect monthly      # Last 30 days
/sparkey:reflect full         # Full quarter (90 days)
/sparkey:reflect 14           # Custom day count
/sparkey:reflect deep-dive prompt_engineering   # Skill deep-dive
/sparkey:reflect update-rules # Improve your CLAUDE.md
```

### Via CLI

```bash
sparkey-reflect analyze --tool claude-code --days 7
sparkey-reflect analyze --tool cursor --days 30 --format json
sparkey-reflect status
sparkey-reflect rules
sparkey-reflect trends --days 30
sparkey-reflect learning-path
```

## Parameters

| Parameter | Description |
|-----------|-------------|
| `daily` | Analyze yesterday's sessions |
| `weekly` *(default)* | Last 7 days |
| `monthly` | Last 30 days |
| `full` | Full quarter — 90 days |
| `<number>` | Custom number of days |
| `deep-dive <skill>` | In-depth analysis of one skill |
| `update-rules` | Improve CLAUDE.md based on insights |

### Deep-dive skills

| Skill | What it analyzes |
|-------|-----------------|
| `prompt_engineering` | Prompt clarity, specificity, structure |
| `context_management` | How you manage context window and file references |
| `tool_mastery` | Usage of available tools and features |
| `conversation_flow` | Session structure and conversation patterns |
| `session_habits` | Session length, time-of-day, and workflow patterns |
| `rule_file_quality` | CLAUDE.md and instruction file effectiveness |
| `outcome_quality` | Success rate and task completion quality |

## Teams edition

Get version code + project management integrations, trend tracking, usage analytics, and industry benchmarks at [sparkey.ai](https://sparkey.ai).

## License

MIT
