CLI tool for learning software development concepts through test-driven development
🎯 Learn software development concepts through test-driven development
Hackages is an interactive CLI tool that helps developers learn new concepts by generating personalized coding exercises using AI-powered test-driven development.
Install globally via npm:
npm install -g hackages
or
npx hackages
After installation, simply run:
hackages
You'll see a welcoming introduction explaining what Hackages is about, followed by 3 simple options:
Choose one and get your first exercise instantly - no authentication required!
Example Onboarding Flow:
$ hackages
🎉 Welcome to Hackages! 🎉
==================================================
🚀 Learn software development through hands-on coding challenges
🧪 Write code, run tests, get instant review and feedback
🎯 Master concepts by doing, not just reading
==================================================
✨ What you'll get:
• A coding challenge with clear instructions
• Test cases that guide your implementation
• AI-powered feedback on your code
• A fun, interactive learning experience
🎯 Ready to try? Pick one:
? Choose your first exercise: › 1. JavaScript Array Methods
🎉 Great choice!
You'll be learning: JavaScript Array Methods
🔄 Generating your first exercise...
🎉 Your first exercise is ready!
==================================================
📁 Files created:
✓ tests/exercise.spec.js (Your test cases)
✓ src/exercise.js (Your implementation file)
🚀 Next steps:
1. Read the instructions and test file to understand what to implement
2. Open src/exercise.js and start coding
3. Run 'npx hackages test' to validate your implementation
4. Run 'npx hackages review' to get feedback on your code
💡 Want to continue learning?
Run 'npx hackages' again to create more exercises and track your progress!
If you've used Hackages before and are logged in, you'll get the full personalized experience with custom learning goals and progress tracking.
# Start learning (default) - creates new exercise
hackages
# Continue working on existing exercise (interactive mode)
hackages continue
# Run tests for your current exercise
hackages test
# Get code review and feedback
hackages review
# Login with GitHub account
hackages login
# Logout from your account
hackages logout
# Show help
hackages --help
Run hackages and answer a few questions:
Hackages automatically detects your preferred technology and clones the appropriate template repository:
git@github.com:hackages/ts-template.git (SSH) or https://github.com/hackages/ts-template.git (HTTPS)git@github.com:hackages/js-template.git (SSH) or https://github.com/hackages/js-template.git (HTTPS)git@github.com:hackages/go-template.git (SSH) or https://github.com/hackages/go-template.git (HTTPS)git@github.com:hackages/python-template.git (SSH) or https://github.com/hackages/python-template.git (HTTPS)The system detects your Git protocol preference (SSH vs HTTPS) and uses the appropriate URL.
Hackages creates exercise files in the cloned repository:
tests/exercise-1.spec.ts - Test cases that define what to buildsrc/exercise-1.ts - Empty implementation file for you to codeinstructions/exercise-1.mdx - Detailed instructions and learning objectivescd <exercise-name>npx hackages test to check your progressnpx hackages reviewUse hackages continue to access the interactive menu:
The "Next Learning" option only appears if you have previous feedback from a code review, and it shows up to 3 AI-recommended learning steps plus an option to write your own goal.
$ hackages
🎯 Hackages Lab
==================================================
✔ 💡 What software development concept would you like to learn today? › TypeScript map function
✅ Detected language: TypeScript
✔ 🛠️ Please confirm your technology choice: › TypeScript (Your selection)
✔ 📊 Select your skill level: › Beginner
🔐 You'll be logging in with your GitHub account to track your progress.
Press Enter to continue...
📥 Cloning TypeScript template repository...
✅ Repository template cloned to: typescript-map-function
🎉 Your learning exercise is ready!
📁 Repository cloned:
✓ typescript-map-function/ (Your exercise directory)
✓ typescript-map-function/tests/exercise-1.spec.ts (Your test cases)
✓ typescript-map-function/src/exercise-1.ts (Your implementation file)
✓ typescript-map-function/instructions/exercise-1.mdx (Exercise instructions)
🚀 Next steps:
1. cd typescript-map-function (navigate to your exercise directory)
2. Read the instructions and test file to understand what to implement
3. Open src/exercise-1.ts and start coding
4. Run 'npx hackages test' to validate your implementation
5. Run 'npx hackages review' to get feedback on your code
$ cd typescript-map-function
$ npx hackages test
🧪 Running tests...
📁 Running tests in: typescript-map-function
❌ 2 tests failed
$ hackages review
📋 Code Review
==================================================
📁 Files to be reviewed:
✓ exercise-1.ts
✓ utils.ts
Great start! Here's some feedback...
🎉 Code review completed!
📝 Feedback saved to: feedback/exercise-1.mdx
🌐 HTML page generated: feedback-exercise-1.html
💡 Opening feedback page in browser...
==================================================
🚀 Continue Your Learning Journey
==================================================
Choose your next learning step:
1. Explore Different Number Types
2. Learn About Function Overloading
3. Error Handling
4. Generic Functions
5. Advanced TypeScript Features
6. Write your next learning goal
🔄 Generating your next exercise...
🎉 Your next exercise is ready!
📁 Next exercise created:
✓ tests/exercise-2.spec.ts (Your test cases)
✓ src/exercise-2.ts (Your implementation file)
✓ instructions/exercise-2.mdx (Exercise instructions)
Get feedback on your implementations with multiple output formats:
src/ directory automaticallyfeedback/exercise-1.mdx in your exercise directoryfeedback-exercise-1.html~/.hackages/ for safekeepingHackages uses technology-specific repository templates that provide:
src/ and tests/ directoriesThe system automatically detects your Git protocol preference:
git@github.com:hackages/<template>.githttps://github.com/hackages/<template>.gitHackages uses GitHub OAuth for user authentication:
# Login with GitHub (opens browser)
hackages login
# Check if you're logged in
hackages --help # Shows your username if logged in
# Logout
hackages logout
This enables personalized learning experiences and progress tracking.
Hackages features a modern CLI interface with:
© Hackages
Happy Learning! 🚀
Built with ❤️ by the Hackages team
FAQs
CLI tool for learning software development concepts through test-driven development
The npm package hackages receives a total of 6 weekly downloads. As such, hackages popularity was classified as not popular.
We found that hackages demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
A malicious Chrome extension posing as an Ethereum wallet steals seed phrases by encoding them into Sui transactions, enabling full wallet takeover.
Security News
Socket is heading to London! Stop by our booth or schedule a meeting to see what we've been working on.
Security News
OWASP’s 2025 Top 10 introduces Software Supply Chain Failures as a new category, reflecting rising concern over dependency and build system risks.