⚡ cf-tracker

A simple CLI tool to fetch and display Codeforces submissions directly from your terminal.

Built with Node.js, Commander.js, and the Codeforces public API.

🚀 Features

• 🔍 Fetch recent Codeforces submissions
• 🧠 Useful for tracking problem-solving progress and daily activity
• 📦 Can be used globally from your terminal
• 💡 Extensible for adding profile, rating history, and more

📦 Installation

🛠 From source (for development/testing)

git clone https://github.com/0xEbrahim/cf-tracker-cli.git
cd cf-tracker-cli
npm install
npm link

This links the CLI globally to your system so you can use cf-tracker anywhere.

🌐 Global install via npm (after publishing)

npm install -g cf-tracker

💻 Usage

✅ Fetch submissions for a Codeforces user:

cf-tracker submissions --handle <codeforces-handle>

Example:

cf-tracker submissions --handle tourist

📂 Output Example

[
  {
    "handle": "tourist",
    "platform": "codeforces",
    "verdict": "OK",
    "problemName": "Two Numbers",
    "tags": ["math", "greedy"],
    "timestamp": "2025-04-22T12:34:56.789Z"
  },
  ...
]

This output can be piped, logged, saved, or used in automation.

🗂 Project Structure

cf-tracker-cli/
├── index.js                    # Main CLI entry point
├── services/
│   └── codeforces.service.js   # Codeforces API wrapper
├── package.json
└── README.md

🔧 Future Ideas

• cf-tracker profile --handle <handle> → Show user info
• cf-tracker rating --handle <handle> → Show rating + graph support
• GitHub integration → Automatically push accepted submissions
• JSON output flags, filtering, tags, difficulty levels

🤝 Contributing

Pull requests are welcome!

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature/my-feature
5. Open a pull request

📜 License

MIT License
© 2025 [0xEbrahim]

🌐 Author

Your Name
GitHub: 0xEbrahim
Project: cf-tracker