Thank you for your interest in contributing to ccstats! We welcome contributions from the community.
- Fork the repository and create your branch from
main. - Make your changes and ensure the code follows Go conventions.
- Test your changes thoroughly.
- Submit a pull request with a clear description of your changes.
# Clone your fork
git clone https://github.com/yourusername/ccstats.git
cd ccstats
# Install dependencies
go mod download
# Build the project
go build
# Run tests
go test ./...- Follow standard Go formatting (use
gofmt) - Write clear, self-documenting code
- Add comments for complex logic
- Keep functions focused and small
- Add tests for new functionality
- Ensure all tests pass before submitting PR
- Test with real Claude Code JSONL files if possible
- Use GitHub Issues to report bugs
- Include steps to reproduce the issue
- Provide example JSONL data if relevant (sanitized)
- Open an issue to discuss new features
- Explain the use case and benefits
- Consider implementing it yourself!
Thank you for contributing!