https://github.com/tyler007-siddesh/ccost
ccost helps you track your Claude API usage accurately and manage costs effectively. With features like intelligent deduplication and multi-currency support, it simplifies your cost analysis. 🛠️✨
https://github.com/tyler007-siddesh/ccost
anthropic api-usage claude cli cost-tracking currency-conversion github-config monitoring rust tui
Last synced: 11 months ago
JSON representation
ccost helps you track your Claude API usage accurately and manage costs effectively. With features like intelligent deduplication and multi-currency support, it simplifies your cost analysis. 🛠️✨
- Host: GitHub
- URL: https://github.com/tyler007-siddesh/ccost
- Owner: Tyler007-siddesh
- Created: 2025-06-15T07:52:46.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-15T15:15:44.000Z (12 months ago)
- Last Synced: 2025-06-15T16:29:43.923Z (12 months ago)
- Topics: anthropic, api-usage, claude, cli, cost-tracking, currency-conversion, github-config, monitoring, rust, tui
- Language: Rust
- Size: 384 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 📊 ccost: Claude API Cost Tracking Tool
Welcome to **ccost**, a powerful tool designed for tracking and analyzing costs associated with the Claude API. This repository provides you with features like intelligent deduplication, multi-currency support, real-time monitoring, and comprehensive project analysis.
  
## 🚀 Features
- **Accurate Tracking**: Monitor your Claude API usage in real-time.
- **Cost Analysis**: Gain insights into your spending with detailed reports.
- **Intelligent Deduplication**: Eliminate duplicate entries for cleaner data.
- **Multi-Currency Support**: Analyze costs in various currencies.
- **Comprehensive Project Analysis**: Break down costs by project for better budgeting.
## 📥 Getting Started
To get started with **ccost**, download the latest release from the [Releases section](https://github.com/Tyler007-siddesh/ccost/releases). You will find a compiled executable that you can run directly.
### Installation
1. Visit the [Releases section](https://github.com/Tyler007-siddesh/ccost/releases).
2. Download the appropriate file for your operating system.
3. Execute the file in your terminal.
### Prerequisites
- Rust programming language installed on your machine.
- Access to the Claude API.
- Basic understanding of command-line interfaces.
## 🔧 Usage
Once you have installed **ccost**, you can start using it by running the following command in your terminal:
```bash
./ccost --help
```
This command will display all available options and commands. You can track your API usage by specifying your API key and other parameters.
### Example Command
```bash
./ccost track --api-key YOUR_API_KEY --currency USD
```
This command will track your API usage and display costs in USD.
## 📊 Project Analysis
**ccost** allows you to analyze costs by project. Use the following command to generate a project report:
```bash
./ccost report --project YOUR_PROJECT_NAME
```
This command will generate a detailed report, helping you understand where your resources are being allocated.
## 💡 Intelligent Deduplication
One of the standout features of **ccost** is its ability to intelligently deduplicate API calls. This ensures that you only pay for unique requests. To enable deduplication, use the following command:
```bash
./ccost deduplicate --enable
```
This will automatically remove duplicate entries from your tracking data.
## 🌍 Multi-Currency Support
With **ccost**, you can analyze costs in various currencies. Simply specify the desired currency when running your commands:
```bash
./ccost track --api-key YOUR_API_KEY --currency EUR
```
This command will track your usage and display costs in Euros.
## 📈 Real-Time Monitoring
**ccost** provides real-time monitoring of your API usage. To enable this feature, run:
```bash
./ccost monitor --api-key YOUR_API_KEY
```
You will receive updates on your usage as they happen, allowing you to manage your costs effectively.
## 📜 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## 📞 Support
If you encounter any issues or have questions, feel free to open an issue in the repository. Your feedback is valuable and helps improve the tool.
## 🤝 Contributing
Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.
## 📚 Topics
This repository covers a range of topics, including:
- **Anthropic**: Understand the ethical implications of AI usage.
- **API Usage**: Learn how to efficiently track API calls.
- **Claude**: Explore the capabilities of the Claude API.
- **CLI**: Get familiar with command-line interfaces.
- **Cost Tracking**: Discover how to monitor expenses.
- **Currency Conversion**: Understand multi-currency support.
- **Deduplication**: Learn about data cleaning techniques.
- **Monitoring**: Implement real-time tracking solutions.
- **Rust**: Utilize Rust for performance and reliability.
- **TUI**: Explore terminal user interfaces.
## 🌟 Acknowledgments
We would like to thank the open-source community for their invaluable contributions. Your support helps make projects like **ccost** possible.
## 📅 Roadmap
- **Version 1.1**: Add support for additional APIs.
- **Version 1.2**: Implement a web interface for easier tracking.
- **Version 1.3**: Enhance reporting features with graphs and charts.
Stay tuned for updates!
## 🛠️ Future Features
- **User Authentication**: Secure your API key with user accounts.
- **Enhanced Analytics**: Provide more detailed insights into usage patterns.
- **Custom Alerts**: Set up notifications for specific usage thresholds.
## 📊 Conclusion
**ccost** is your go-to tool for managing Claude API costs. With features like intelligent deduplication and multi-currency support, you can track your usage accurately and efficiently. For the latest updates, visit the [Releases section](https://github.com/Tyler007-siddesh/ccost/releases).
Thank you for using **ccost**! We look forward to your feedback and contributions.