Hello. Zuko here
Zuko
It’s time for you to look inward and begin asking yourself the big questions.
Zuko is a blazing-fast, terminal-first CLI tool to supercharge your Data Structures and Algorithms (DSA) practice.
🧠 Philosophy
Zuko embodies discipline, resilience, and growth. It’s designed to help you build real momentum in your coding journey — by eliminating friction, promoting consistency, and making the terminal your training ground.
That's you 🫵
That’s who you are, Zuko. Someone who keeps fighting even when it’s hard.
🎯 Our Goal
Make the developer terminal the first and only stop for solving, exploring, and practicing questions — even offline — and use version control to track your progress over time.
Inspired by the discipline and drive of Zuko from Avatar: The Last Airbender, this tool helps you stay consistent, focused, and efficient — bringing the full problem-solving experience right into your terminal.
🎬 Demo
✨ Features
- 📦 Project Generator: Instantly scaffold a new problem with boilerplate code in your preferred language (Rust, Python, Java, etc.)
- 🔍 Fuzzy Search with Preview: Browse and preview problems at lightning speed using a terminal UI powered by ratatui and nucleo-matcher
- 📖 Markdown Rendering: View full problem descriptions directly in your terminal with clean formatting via termimad
- 📊 Topic & Difficulty Filters: Practice problems by tag, difficulty level, or let fate decide with a random selection
- 🔁 Streak Tracking: Build daily habits with automatic streak tracking
- 🧠 Offline-First Experience: Train anytime, anywhere with synced local problem sets using SQLite or Turso DB
- 🛠️ Version Control Integration: Automatically manage git repositories per problem — commit as you solve, and track your streak through version control
🛤️ Roadmap
- 🔔 Daily reminders
- 💡 Personalized practice plans
- 📄 Config file for user preferences
- 🌐 Leetcode/Codeforces integration
- 📅 Calendar view of streaks
- ☁️ VCS tracking for maintaining streak
- 🤝 Community support for sourcing problems and content
| Command | Action |
|---|---|
zuko init | Initializes the DB and configs |
zuko list | Fuzzy search and lists all available problems, filter by topic or difficulty |
zuko sync | Syncs with all the available problem sets |
zuko solve | Bootstraps problem files, and opens in your favorite editor |
zuko solve --random | Solve a random question |
zuko streak | Shows your current streak |
zuko push | Pushes to your version control system (VCS) |
🏛️ License
MIT
I’ve walked through fire, lost my way, and found it again. If that’s not worth writing about — what is?
-a project by Jay Gurav.