Skip to main content

AI coding advisor — analyzes your AI coding sessions and generates coaching insights

Project description

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

# 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

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

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.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sparkey_reflect-0.1.0.tar.gz (73.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sparkey_reflect-0.1.0-py3-none-any.whl (82.0 kB view details)

Uploaded Python 3

File details

Details for the file sparkey_reflect-0.1.0.tar.gz.

File metadata

  • Download URL: sparkey_reflect-0.1.0.tar.gz
  • Upload date:
  • Size: 73.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sparkey_reflect-0.1.0.tar.gz
Algorithm Hash digest
SHA256 18a53f4eae9e4e7b59c031d1099d25ee88bfc6c7f756b0ee2bc0126c9da0e3dc
MD5 5f6bc80ac0c98f712ca835cfa4897e27
BLAKE2b-256 7ee03aee254b2cfa2eac63c1ad4c0e6d373122439ac61aec1157ed42faeef2bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for sparkey_reflect-0.1.0.tar.gz:

Publisher: publish.yml on Sparkey-AI/sparkey-reflect

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sparkey_reflect-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sparkey_reflect-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 02bdc4d393e2cd7bc6533e75c842c79982c5c28f7a1214b1646c04af4ce4c3b9
MD5 58652642006c33de3a156e7f02b03843
BLAKE2b-256 58337690b729e318a150943f712611fc47b56ac122231252b4a43186a4cc34ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for sparkey_reflect-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Sparkey-AI/sparkey-reflect

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page