Installation, data sources, permissions, and FAQ. CodePulse is a local-first analytics tool that helps you track your AI coding assistant usage.
Learn how CodePulse works and start tracking your AI usage data.
CodePulse supports Claude Code, OpenAI Codex, and Google Gemini CLI. Make sure your session data is stored in the default locations.
CodePulse requires macOS 14.0 (Sonoma) or later, built with the latest SwiftUI framework for the best experience.
On first launch, CodePulse will request access to ~/.claude, ~/.codex, ~/.gemini directories.
Learn how CodePulse collects and processes your AI coding data.
Reads session files from ~/.claude/projects and ~/.claude/transcripts, parsing messages, tool calls, and token usage.
Reads session data from ~/.codex/sessions, extracting conversation records and usage statistics.
Reads ~/.gemini/tmp, ~/.gemini/history, and ~/.gemini/projects.json to aggregate Gemini usage data.
Answers to the most common questions about CodePulse.
CodePulse only accesses LiteLLM's GitHub repository to fetch model pricing data. All session data is parsed and stored locally—nothing is uploaded to any server.
CodePulse fetches the latest model pricing JSON from LiteLLM and combines it with input/output token counts from your local sessions. Pricing data is cached locally to reduce network requests.
Please verify: 1) You have used Claude Code/Codex/Gemini CLI; 2) Session data is stored in default locations; 3) CodePulse has been granted access to relevant directories. If issues persist, please contact support.
All cached data is stored in ~/Library/Application Support/CodePulse/cache.sqlite3. You can clear cache or export data anytime in Settings.
If the FAQ doesn't solve your issue, please contact us with relevant information.
Get help via Telegram or email. We respond within 24 hours.