{"id":29619251,"url":"https://github.com/miwidot/cctracker","last_synced_at":"2026-04-09T20:02:38.931Z","repository":{"id":301588448,"uuid":"1009394529","full_name":"miwidot/CCTracker","owner":"miwidot","description":"Claude code cost Tracker","archived":false,"fork":false,"pushed_at":"2025-07-19T14:18:22.000Z","size":3219,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-19T15:11:28.287Z","etag":null,"topics":["anth","anthropic","claude","claude-ai","claude-code","cost","cost-optimization","electron","gui","react","ui"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miwidot.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.txt","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T04:11:37.000Z","updated_at":"2025-07-19T11:08:42.000Z","dependencies_parsed_at":"2025-06-27T17:27:42.862Z","dependency_job_id":"05dc9278-5d5d-4401-b947-761fbaef3e93","html_url":"https://github.com/miwidot/CCTracker","commit_stats":null,"previous_names":["miwi-fbsd/cctracker","miwidot/cctracker"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/miwidot/CCTracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miwidot%2FCCTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miwidot%2FCCTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miwidot%2FCCTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miwidot%2FCCTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miwidot","download_url":"https://codeload.github.com/miwidot/CCTracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miwidot%2FCCTracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266231764,"owners_count":23896473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anth","anthropic","claude","claude-ai","claude-code","cost","cost-optimization","electron","gui","react","ui"],"created_at":"2025-07-21T03:01:06.990Z","updated_at":"2025-10-24T11:29:37.687Z","avatar_url":"https://github.com/miwidot.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CCTracker - Claude Code CLI Usage Monitor\n\n\u003cdiv align=\"center\"\u003e\n\n![CCTracker Dashboard](img/gh_img.png)\n\n**Professional Claude Code CLI usage monitoring and cost analytics**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![React](https://img.shields.io/badge/React-20232A?logo=react\u0026logoColor=61DAFB)](https://reactjs.org/)\n[![Electron](https://img.shields.io/badge/Electron-191970?logo=Electron\u0026logoColor=white)](https://www.electronjs.org/)\n\n[Features](#features) • [Installation](#installation) • [Usage](#usage) • [Development](#development) • [Contributing](#contributing)\n\n\u003c/div\u003e\n\n## Overview\n\nCCTracker monitors **Claude Code CLI** usage and costs in real-time. Built with React and Electron, it provides comprehensive analytics for developers using the Claude Code command-line tool.\n\n\u003e **Note**: This monitors the Claude Code CLI ([claude.ai/code](https://claude.ai/code)), not the Claude.ai web interface.\n\n## Features\n\n- **📊 Real-time Monitoring**: Live tracking of Claude Code CLI usage and costs\n- **💰 Multi-currency Support**: View costs in USD, EUR, GBP, JPY, CNY, MYR with live rates\n- **📈 Advanced Analytics**: Usage patterns, model efficiency, anomaly detection\n- **🌍 Internationalization**: 6 languages with proper localization\n- **🎨 Professional UI**: Light/dark themes + 4 Catppuccin variants\n- **📤 Data Export**: CSV, JSON, Excel export with flexible filtering\n- **🔒 Privacy-first**: All data stored locally, no cloud sync\n\n## Installation\n\n### Download\n\nGet the latest release from [GitHub Releases](https://github.com/miwi-fbsd/CCTracker/releases):\n- **macOS**: Download `.dmg` file\n- **Linux**: Download `.deb` or `.tar.gz` file\n\n### Prerequisites\n\n- **Claude Code CLI**: Must be installed and configured ([claude.ai/code](https://claude.ai/code))\n- **Operating System**: macOS 10.14+ or Linux (Ubuntu 18.04+)\n\n### From Source\n\n```bash\ngit clone https://github.com/miwi-fbsd/CCTracker.git\ncd CCTracker\nnpm install\nnpm run build\nnpm start\n```\n\n## Usage\n\n1. **Install \u0026 Launch**: Download and install CCTracker\n2. **Auto-detection**: CCTracker automatically monitors `~/.claude/projects/` for Claude CLI usage\n3. **Configure**: Set language, theme, and currency in Settings\n4. **Monitor**: View real-time usage and costs as you use Claude Code CLI\n\n### Key Workflows\n\n- **Dashboard**: Real-time cost tracking and usage analytics\n- **Projects**: Detailed project-level analysis and trends\n- **Export**: Generate CSV/JSON reports for external analysis\n- **Settings**: Customize themes, language, and currency preferences\n\n## Development\n\n### Tech Stack\n\n- **Frontend**: React 18 + TypeScript 5.8\n- **Desktop**: Electron 37\n- **Build**: Webpack 5 + Tailwind CSS\n- **Charts**: Recharts for data visualization\n- **i18n**: react-i18next for 6 languages\n- **File Monitoring**: Chokidar for real-time JSONL parsing\n\n### Architecture\n\n```\nClaude Code CLI → File Monitor → Cost Engine → React Dashboard\n    (JSONL)         (Chokidar)    (Analytics)    (Electron)\n```\n\n### Setup\n\n```bash\ngit clone https://github.com/miwi-fbsd/CCTracker.git\ncd CCTracker\nnpm install\nnpm run dev          # Development with hot reload\nnpm run build        # Production build\nnpm run package      # Create distributable\n```\n\n### Scripts\n\n- `npm run dev` - Start development server\n- `npm run lint` - ESLint checking\n- `npm run type-check` - TypeScript validation\n- `npm test` - Jest test suite\n\n## Contributing\n\n1. Fork the repository and create a feature branch\n2. Follow code standards: ESLint, TypeScript strict mode, React best practices\n3. Add tests for new functionality\n4. Submit a pull request with clear description\n\n### Code Standards\n\n- **TypeScript**: Strict mode enabled, comprehensive type coverage\n- **React**: Modern hooks-based components with Context API\n- **Accessibility**: WCAG 2.1 Level AA compliance\n- **i18n**: All user-facing text must be translatable\n\n## Troubleshooting\n\n**Not detecting Claude CLI usage?**\n- Verify Claude Code CLI is installed ([claude.ai/code](https://claude.ai/code))\n- Check file permissions for `~/.claude/projects/`\n\n**Cost calculations incorrect?**\n- Verify currency rates are updated\n- Check cache token calculations\n\n**App won't start?**\n- Ensure Node.js 18+ is installed\n- Clear and reinstall: `rm -rf node_modules \u0026\u0026 npm install`\n\n## Security \u0026 Privacy\n\n- **Local-only**: All data stored locally, no cloud sync\n- **Read-only**: Only reads Claude CLI logs, never modifies\n- **Sandboxed**: Electron context isolation enabled\n- **Privacy-first**: Your usage data never leaves your device\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/miwi-fbsd/CCTracker/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/miwi-fbsd/CCTracker/discussions)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built for the Claude Code CLI community**\n\n[⭐ Star this repo](https://github.com/miwi-fbsd/CCTracker) if you find it helpful!\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiwidot%2Fcctracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiwidot%2Fcctracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiwidot%2Fcctracker/lists"}