{"id":30046709,"url":"https://github.com/whoamaiii/devxp-cli","last_synced_at":"2026-04-19T02:03:33.427Z","repository":{"id":308557847,"uuid":"1033252301","full_name":"whoamaiii/devxp-cli","owner":"whoamaiii","description":"🎮 A gamified CLI tool for developers that tracks coding activities and rewards XP for development milestones","archived":false,"fork":false,"pushed_at":"2025-08-06T14:36:10.000Z","size":239,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-06T16:36:17.418Z","etag":null,"topics":["cli","developer-tools","gamification","git-hooks","npm-package","productivity","typescript","xp-system"],"latest_commit_sha":null,"homepage":null,"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/whoamaiii.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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-08-06T14:24:36.000Z","updated_at":"2025-08-06T14:36:13.000Z","dependencies_parsed_at":"2025-08-06T16:36:21.264Z","dependency_job_id":"36eecf3a-a1cd-4606-b91d-cc1c3704d735","html_url":"https://github.com/whoamaiii/devxp-cli","commit_stats":null,"previous_names":["whoamaiii/devxp-cli"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/whoamaiii/devxp-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoamaiii%2Fdevxp-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoamaiii%2Fdevxp-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoamaiii%2Fdevxp-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoamaiii%2Fdevxp-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whoamaiii","download_url":"https://codeload.github.com/whoamaiii/devxp-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoamaiii%2Fdevxp-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269227883,"owners_count":24381837,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","developer-tools","gamification","git-hooks","npm-package","productivity","typescript","xp-system"],"created_at":"2025-08-07T08:53:30.510Z","updated_at":"2026-04-19T02:03:33.352Z","avatar_url":"https://github.com/whoamaiii.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DevXP CLI\n\n🚀 **Gamify Your Development Experience** - Track your coding progress, earn achievements, and level up your skills!\n\n[![npm version](https://img.shields.io/npm/v/devxp-cli.svg)](https://www.npmjs.com/package/devxp-cli)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/node/v/devxp-cli.svg)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)\n\n## 🎮 What is DevXP?\n\nDevXP CLI is a command-line tool that gamifies your development workflow. It tracks your Git commits, coding sessions, and development activities to provide:\n\n- 🏆 **Achievement System** - Unlock achievements as you code\n- 📊 **XP \u0026 Leveling** - Gain experience points and level up\n- 📈 **Statistics Tracking** - Monitor your coding habits and productivity\n- 🏅 **Leaderboards** - Compare your progress with other developers\n- 🎨 **Beautiful Visualizations** - See your progress in stunning terminal graphics\n- 🔧 **Shell Integration** - Automatic tracking with your favorite shell\n\n## 📸 Screenshots\n\n```\n╔═══════════════════════════════════════════════╗\n║                  DevXP Status                  ║\n╠═══════════════════════════════════════════════╣\n║  Level 42 Developer                            ║\n║  ████████████████░░░░░  12,450 / 15,000 XP   ║\n║                                                ║\n║  🔥 Current Streak: 7 days                     ║\n║  ⚡ Today's XP: 450                            ║\n║  🎯 Next Achievement: Code Warrior (78%)       ║\n╚═══════════════════════════════════════════════╝\n```\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install globally via npm\nnpm install -g devxp-cli\n\n# Or using yarn\nyarn global add devxp-cli\n\n# Or using pnpm\npnpm add -g devxp-cli\n```\n\n### Initial Setup\n\n```bash\n# Run the interactive setup wizard\ndevxp install\n\n# Or manually configure\ndevxp config set name \"Your Name\"\ndevxp config set shell bash  # or zsh, fish\n```\n\n### Basic Usage\n\n```bash\n# Check your current status\ndevxp status\n\n# View your achievements\ndevxp achievements\n\n# Show statistics\ndevxp stats\n\n# View leaderboard\ndevxp leaderboard\n\n# Configure settings\ndevxp config\n```\n\n## 🎯 Features in Detail\n\n### Achievement System\n\nUnlock achievements based on your coding activities:\n\n- **First Commit** - Make your first commit\n- **Streak Master** - Maintain a 30-day coding streak\n- **Night Owl** - Code after midnight\n- **Early Bird** - Start coding before 6 AM\n- **Refactor King** - Perform multiple refactoring commits\n- **Bug Squasher** - Fix bugs consistently\n- **Documentation Hero** - Write comprehensive documentation\n- And many more!\n\n### XP System\n\nEarn XP through various activities:\n\n| Activity | XP Earned |\n|----------|----------|\n| Git Commit | 10-50 XP |\n| Pull Request | 100 XP |\n| Code Review | 75 XP |\n| Issue Resolved | 50 XP |\n| Documentation | 30 XP |\n| Test Writing | 40 XP |\n\n### Shell Integration\n\nAutomatically track your development activities by integrating with your shell:\n\n```bash\n# For Bash\necho 'eval \"$(devxp shell-integration bash)\"' \u003e\u003e ~/.bashrc\n\n# For Zsh\necho 'eval \"$(devxp shell-integration zsh)\"' \u003e\u003e ~/.zshrc\n\n# For Fish\ndevxp shell-integration fish | source\necho 'devxp shell-integration fish | source' \u003e\u003e ~/.config/fish/config.fish\n```\n\n## 🛠️ Advanced Configuration\n\n### Configuration File\n\nDevXP stores configuration in `~/.config/devxp/config.json`:\n\n```json\n{\n  \"name\": \"John Doe\",\n  \"theme\": \"neon\",\n  \"notifications\": true,\n  \"trackingEnabled\": true,\n  \"excludePaths\": [\"/node_modules\", \"/.git\"],\n  \"xpMultiplier\": 1.0\n}\n```\n\n### Environment Variables\n\n```bash\n# Set custom config directory\nexport DEVXP_CONFIG_DIR=\"$HOME/.myconfig/devxp\"\n\n# Set custom database location\nexport DEVXP_DB_PATH=\"$HOME/.mydata/devxp.db\"\n\n# Enable debug mode\nexport DEVXP_DEBUG=true\n```\n\n### Git Hooks Integration\n\nAutomatically track Git activities:\n\n```bash\n# Install Git hooks for current repository\ndevxp install --git-hooks\n\n# Install globally for all repositories\ndevxp install --git-hooks --global\n```\n\n## 📚 API Reference\n\n### Commands\n\n#### `devxp status [options]`\nDisplay current level, XP, and recent activity.\n\n**Options:**\n- `-v, --verbose` - Show detailed information\n- `-j, --json` - Output in JSON format\n\n#### `devxp achievements [options]`\nList all achievements and progress.\n\n**Options:**\n- `--unlocked` - Show only unlocked achievements\n- `--locked` - Show only locked achievements\n- `--recent` - Show recently unlocked achievements\n\n#### `devxp stats [period]`\nDisplay coding statistics.\n\n**Arguments:**\n- `period` - Time period: `today`, `week`, `month`, `year`, `all` (default: `week`)\n\n#### `devxp leaderboard [options]`\nShow leaderboard rankings.\n\n**Options:**\n- `--global` - Show global leaderboard\n- `--friends` - Show friends leaderboard\n- `--limit \u003cn\u003e` - Number of entries to show\n\n#### `devxp config \u003caction\u003e [key] [value]`\nManage configuration settings.\n\n**Actions:**\n- `get \u003ckey\u003e` - Get configuration value\n- `set \u003ckey\u003e \u003cvalue\u003e` - Set configuration value\n- `list` - List all configuration\n- `reset` - Reset to defaults\n\n## 🧪 Development\n\n### Prerequisites\n\n- Node.js \u003e= 18.0.0\n- npm, yarn, or pnpm\n- Git\n\n### Setup Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/devxp-cli.git\ncd devxp-cli\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n\n# Build for production\nnpm run build\n```\n\n### Project Structure\n\n```\ndevxp-cli/\n├── src/\n│   ├── index.ts              # CLI entry point\n│   ├── commands/             # Command implementations\n│   │   ├── status.command.ts\n│   │   ├── achievements.command.ts\n│   │   ├── stats.command.ts\n│   │   └── ...\n│   ├── modules/              # Core modules\n│   │   ├── xp-system.ts     # XP calculation logic\n│   │   ├── achievements.ts   # Achievement system\n│   │   ├── database.ts       # SQLite database\n│   │   └── ...\n│   ├── types/                # TypeScript definitions\n│   └── utils/                # Utility functions\n├── tests/                    # Test files\n├── docs/                     # Documentation\n└── package.json\n```\n\n### Available Scripts\n\n| Script | Description |\n|--------|-------------|\n| `npm run build` | Build for production |\n| `npm run dev` | Run in development mode |\n| `npm run test` | Run all tests |\n| `npm run test:watch` | Run tests in watch mode |\n| `npm run test:coverage` | Generate coverage report |\n| `npm run lint` | Lint code |\n| `npm run format` | Format code with Prettier |\n\n### Creating Custom Commands\n\n```typescript\n// src/commands/mycommand.command.ts\nimport { Command } from '../types/command.js';\nimport { logger } from '../utils/logger.js';\n\nexport class MyCommand implements Command {\n  readonly name = 'mycommand';\n  readonly description = 'Description of my command';\n  readonly aliases = ['mc'];\n  \n  async execute(args: ReadonlyArray\u003cstring\u003e): Promise\u003cvoid\u003e {\n    logger.info('Executing my command');\n    // Your implementation here\n  }\n}\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📝 Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for a list of changes.\n\n## 🐛 Bug Reports\n\nFound a bug? Please [open an issue](https://github.com/yourusername/devxp-cli/issues) with a detailed description.\n\n## 💡 Feature Requests\n\nHave an idea? We'd love to hear it! [Open an issue](https://github.com/yourusername/devxp-cli/issues) with the `enhancement` label.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Commander.js](https://github.com/tj/commander.js/)\n- Terminal graphics powered by [Chalk](https://github.com/chalk/chalk) and [Boxen](https://github.com/sindresorhus/boxen)\n- Database management with [Better SQLite3](https://github.com/WiseLibs/better-sqlite3)\n- Inspired by gaming achievement systems\n\n## 📧 Contact\n\n- **Author**: Your Name\n- **Email**: your.email@example.com\n- **Twitter**: [@yourhandle](https://twitter.com/yourhandle)\n- **Website**: [yourwebsite.com](https://yourwebsite.com)\n\n---\n\n\u003cp align=\"center\"\u003eMade with ❤️ by developers, for developers\u003c/p\u003e\n\u003cp align=\"center\"\u003e⭐ Star us on GitHub — it helps!\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoamaiii%2Fdevxp-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhoamaiii%2Fdevxp-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoamaiii%2Fdevxp-cli/lists"}