CodeChron Documentation
Everything you need to understand CodeChron — from first install to advanced intelligence features.
Getting Started
Download the macOS desktop app, add a project folder, and CodeChron starts tracking automatically. No configuration needed.
- Drag any local folder to add a project
- File changes are captured in real-time via a background watcher
- Sessions are created, summarized, and indexed automatically
- All data stays on your machine — local-first architecture
Session Intelligence
Every coding session becomes a structured narrative with intent, impact, and risk analysis — powered by Gemini.
- AI-generated narrative summarizing what happened and why
- Developer intent detection from code patterns
- Impact analysis showing downstream effects
- Risk factor identification with severity levels
Intelligence Layer
CodeChron captures signals from AI tools, file saves, diffs, and commits — then builds structured intelligence.
- Cursor, Claude Code, and Antigravity conversation tracking
- File-level and function-level change detection
- Dependency graph analysis for impact propagation
- Semantic indexing for codebase-aware intelligence
Timeline
A living record of every session across all projects with search, filters, and status tracking.
- Chronological feed of all coding sessions
- Filter by project, status, date range, or source
- Session details with file-level diffs
- Real-time updates via WebSocket
AI Attribution
See which sessions were AI-assisted, which were manual, and the source conversations behind every change.
- Automatic detection of AI-assisted vs manual coding
- Linked AI conversations with attribution confidence
- Change type classification (feature, bugfix, refactor)
- Model-level attribution (which AI model wrote what)
AI Intelligence Center
Executive-level insights materialized from your sessions — velocity KPIs, risk heatmaps, and weekly narratives.
- Weekly narrative summaries of coding activity
- Velocity sparklines: sessions/week, AI adoption rate, risk exposure
- Risk heatmap showing high-churn files
- Developer intent cloud and AI tool usage breakdown
Analytics
Track daily coding time, project breakdowns, and language distribution at a glance.
- Daily time-logged chart across all projects
- Per-project time breakdown
- Language distribution by lines changed
- Trend indicators and daily averages
Project Management
Add local folders or GitHub repos. Semantic indexing runs automatically in the background.
- One-click project addition from local filesystem
- AST-aware semantic indexing with Tree-sitter
- Dependency graph generation for impact analysis
- Project health and sync status monitoring
GitHub Integration
Connect your GitHub account, sync PRs and commits, and get the same intelligence for remote work.
- OAuth or Personal Access Token connection
- Automatic PR and commit ingestion with AST analysis
- Unified timeline merging local and GitHub sessions
- Public and private repository support
Skills Intelligence
AI-powered skill extraction from your coding sessions — proficiency levels, categories, and weekly trends.
- Automatic skill detection from code patterns
- Proficiency scores: Expert, Proficient, Familiar
- Categories: Programming, Technology, Database, Infrastructure
- Weekly skill snapshot timeline with trend analysis
Chat & Prompt Tuning
Ask questions about your codebase or enrich a rough prompt with full project context before sending to an AI tool.
- Natural language queries against your indexed codebase
- Prompt enrichment with relevant file context and package summaries
- Context-aware responses using semantic search
- Copy enriched prompts directly to Cursor, Claude, or Antigravity