{
  "markdown": "# WakaTime for Gemini CLI\n\nTrack your AI-assisted coding activity, time spent prompting AI, and lines of code generated using the WakaTime extension for Gemini CLI.\n\n[WakaTime](https://wakatime.com/) is an open source plugin for metrics, insights, and time tracking automatically generated from your programming activity.\n\n## Installation\n\n### 1. Install the Extension\n\n```bash\ngemini extensions install https://github.com/EstebanForge/gemini-cli-wakatime.git\n```\n\n### 2. Configure WakaTime\n\nAdd your [WakaTime API key](https://wakatime.com/api-key) to `~/.wakatime.cfg`:\n\n```ini\n[settings]\napi_key = your_api_key_here\n```\n\n**That's it!** The extension will automatically download and install the WakaTime CLI on first use. No manual CLI installation required.\n\n### What happens on first run\n\n1. Extension detects missing WakaTime CLI\n2. Downloads platform-specific binary from GitHub\n3. Installs to `~/.wakatime/`\n4. Starts tracking your activity automatically\n\n## Usage\n\nThe extension runs automatically in the background, tracking your AI-assisted coding activity. It:\n\n- Monitors file operations (read, write, edit) during Gemini CLI sessions\n- Tracks time spent on AI coding\n- Records line changes generated by AI\n- Sends heartbeats to WakaTime every 60 seconds\n\nVisit [https://wakatime.com](https://wakatime.com) to see your coding activity dashboard.\n\n![WakaTime Dashboard](https://wakatime.com/static/img/ScreenShots/Screen-Shot-2016-03-21.png)\n\n## How It Works\n\nThe extension includes an MCP (Model Context Protocol) server that integrates with Gemini CLI:\n\n1. **Auto-Installation**: Automatically downloads and installs the WakaTime CLI on first run\n2. **File Monitoring**: Tracks which files are read, written, or edited during sessions\n3. **Line Change Calculation**: Measures the lines of code added/modified by AI\n4. **Heartbeat Sending**: Sends data to WakaTime with:\n   - File paths\n   - Line changes count\n   - Category: \"AI coding\"\n   - Plugin: \"gemini-cli-wakatime\"\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/EstebanForge/gemini-cli-wakatime.git\ncd gemini-cli-wakatime\nnpm install\nnpm run build\n```\n\n### Development Workflow\n\n```bash\n# Build the extension\nnpm run build\n\n# Link for development (no need to reinstall after changes)\ngemini extensions link .\n\n# Test changes\ngemini extensions list\n\n# Uninstall when done\ngemini extensions uninstall gemini-cli-wakatime\n```\n\n**Important for Development:**\n- After making changes, run `npm run build` and `git add dist/ && git commit -m \"Update built files\"`\n- The `dist/` directory must be committed as it contains the bundled MCP server\n- Always test after linking with `gemini extensions list` to ensure no connection errors\n\n### Packaging for Release\n\n```bash\n# Create platform-specific archives\nnpm run package -- --platform=darwin --arch=arm64\nnpm run package -- --platform=linux --arch=x64\nnpm run package -- --platform=win32 --arch=x64\n\n# Archives will be in release/ directory\n```\n\n## Extension Management\n\n### List installed extensions\n\n```bash\ngemini extensions list\n```\n\n### Update extension\n\n```bash\ngemini extensions update gemini-cli-wakatime\n```\n\n### Uninstall extension\n\n```bash\ngemini extensions uninstall gemini-cli-wakatime\n```\n\n## Troubleshooting\n\n### Extension not working\n\n1. **Check API key configuration**:\n   ```bash\n   cat ~/.wakatime.cfg\n   ```\n\n2. **Enable debug mode**:\n   Edit `~/.wakatime.cfg`:\n   ```ini\n   [settings]\n   debug = true\n   ```\n   Then check logs at `~/.wakatime/gemini-cli.log`\n\n3. **Verify WakaTime CLI auto-installation**:\n   ```bash\n   ls -la ~/.wakatime/wakatime-cli*\n   ```\n\n4. **Restart Gemini CLI**: Close and reopen your terminal\n\n### No data on dashboard\n\n- Activity may take a few minutes to appear (check https://wakatime.com/dashboard)\n- Verify internet connection\n- Check API key is correct\n- Look for errors in WakaTime logs\n\n### Check extension status\n\n```bash\ngemini extensions list\n```\n\n## Configuration\n\n### WakaTime Settings\n\nEdit `~/.wakatime.cfg`:\n\n```ini\n[settings]\napi_key = your_api_key_here\ndebug = false\nproxy = http://proxy:8080\nno_ssl_verify = false\n```\n\nSee all WakaTime settings: https://github.com/wakatime/wakatime-cli#configuration-file\n\n## License\n\nMIT License - see [LICENSE](LICENSE.md) file for details\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Open an issue to discuss changes\n2. Fork the repository\n3. Create a feature branch\n4. Submit a pull request\n\n## Support\n\n- [GitHub Issues](https://github.com/EstebanForge/gemini-cli-wakatime/issues)\n- [WakaTime Website](https://wakatime.com)\n- [Gemini CLI Documentation](https://geminicli.com/docs/extensions)\n\n## Features\n\n- **Zero Configuration**: Auto-downloads and installs WakaTime CLI\n- **Automatic Tracking**: Monitors all file operations during AI sessions\n- **Line Change Metrics**: Tracks AI-generated code changes\n- **Background Operation**: Runs silently without interrupting workflow\n- **Cross-Platform**: Works on macOS, Linux, and Windows\n- **Auto-Updates**: CLI updates automatically every 4 hours\n\n## Release History\n\n### v1.0.0\n- Initial release\n- Automatic WakaTime CLI installation\n- File operation tracking\n- WakaTime heartbeat integration\n- MCP server implementation\n- Cross-platform support\n",
  "bytes": 5244,
  "sha": "70dbbfae1a1786486d313817892c5de6bc61c57d589f5d5a06179e83cc378265",
  "repo_slug": "estebanforge/gemini-cli-wakatime",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_estebanforge_gemini_cli_wakatime_c726a196/readme"
}