devKataCLI

Master dev habits, one kata at a time

Three progressive kata types:

mini (10-15min) → nami (15-30min) → dev (30-45min)

devKata DEMO

Why devKataCLI?

Building consistent development habits is hard. You know you should practice regularly, review code, and stay sharp—but life gets in the way.

devKataCLI gives you structure without overwhelming you:

• Start small - Begin with just 10-15 minutes
• Build progressively - Grow your practice as habits form
• Zero setup - Run from anywhere in your terminal
• Fully customizable - Create your own katas or use defaults
• Track progress - See your consistency over time

Perfect for developers who want to establish morning routines, sharpen skills through spaced repetition, or simply build more intentional coding habits.

Installation

Prerequisites

• Node.js 18+ (Required for all installation methods)

Choose Your Installation Method

Option 1: Homebrew (macOS/Linux)

brew tap fern-d3v/devkatacli
brew install devkatacli

Option 2: npm (Cross-platform)

npm install -g devkatacli

Option 3: npx (No installation)

npx devkatacli start

Option 4: From source

git clone https://github.com/fern-d3v/devKataCLI.git
cd devKataCLI
npm install
npm link

Verify Installation

devkata --help

You should see the command options and be ready to start!

Quick Start

1. Create Your First Kata - Start by creating a kata routine:

devkata new

You'll be guided through an interactive setup:

• Choose kata type: mini (10-15min), nami (15-30min), or dev (30-45min)

• Select template: Use defaults or create custom tasks

• Link git repositories for code reviews

• Configure coding sandbox languages

• Build your personalized routine

2. Start Your Daily Practice -Run your morning kata:

 devkata start

The CLI will:

• Load your saved kata

• Guide you through each task

• Track completion status

• Save your progress

3. Configure Kata's After Setup

devkata config

The CLI will run a similar setup to the devkata new command:

• Choose which Kata to configure

• Link git repositories

• Select coding languages for sandbox

Example Workflow

Create a mini kata with default tasks

$ devkata new

✨ Create a new devKata routine

? What type of kata would you like to create? › miniKata (10-15 minutes)

? How would you like to configure this kata? › Use default kata

✅ miniKata created successfully with default tasks

Start your daily practice

$ devkata start

? Select a kata to start: › miniKata

⠋ loading your kata...

✅ kata loaded!

⠋ Review yesterday's code for 10 minutes

? complete Review yesterday's code for 10 minutes? › Yes

✅ Review yesterday's code for 10 minutes completed!

⠋ Check today's tickets and prioritize

? complete Check today's tickets and prioritize? › Yes

✅ Check today's tickets and prioritize completed!

✨ kata saved! see you tomorrow <3

What's Included in Each Kata?

miniKata (10-15 minutes)

• Posture check with ergonomic tips
• Set 3 daily goals
• Discover a tech article from Dev.to
• Explore a random GitHub repository

namiKata (15-30 minutes)

• All miniKata tasks, plus:
• Hydration reminder
• Check communications (email, Slack, etc.)
• Review yesterday's code commits
• Practice typing skills on MonkeyType

devKata (30-45 minutes)

• All miniKata + namiKata tasks, plus:
• Stretching exercises
• Complete a coding challenge (LeetCode or CodeWars)
• Practice in your coding sandbox

Available Commands

| Command | Description | | ----------------------- | ---------------------------------------------- | | devkata new | Create a new kata routine (mini, nami, or dev) | | devkata start | Start your daily kata practice | | devkata config | Config kata after creation | | devkata stats | View your practice statistics and progress | | devkata stats --reset | Reset all statistics (with backup option) | | devkata stats --restore | Restore statistics from a backup | | devkata --help | Show all available commands |

Features

• Progressive Kata Types: Start small with miniKata (10-15min), build up to devKata (30-45min)

• Interactive CLI Experience: Beautiful prompts with Dracula-themed colors

• API Integrations: Search Dev.to articles and GitHub repos directly from your kata

• Git Integration: Review yesterday's commits from your linked repositories

• Coding Challenges: Quick access to LeetCode and CodeWars

• Typing Practice: Launch MonkeyType for skill improvement

• Coding Sandbox: Daily practice files for multiple languages

• Progress Tracking: Automatic session logging with detailed metrics

• Statistics & Analytics: View completion history, streaks, and GitHub-style activity calendar

• Data Management: Reset statistics with backup/restore functionality

• Default Templates: Pre-built kata routines based on developer best practices

• Fully Customizable: Create your own tasks or modify existing ones

Track Your Progress

View detailed statistics with the devkata stats command:

• Completion History: View katas completed over 7/30/90 days, this year, or all time
• GitHub-Style Calendar: Visual heatmap of your activity
• Current Streak: Track consecutive days of practice
• Category Breakdown: See your most practiced categories
• Articles & Repos: List of articles read and repositories reviewed
• Average Duration: Monitor your session lengths

Manage your data:

• devkata stats --reset - Reset all statistics (creates backup first)
• devkata stats --restore - Restore from a previous backup

Configuration

Your configuration and logs are stored in ~/.config/devKata/:

• kata.json - Your saved kata routines
• config.json - Git repositories and sandbox languages
• logs/ - Daily session logs with detailed metrics
• coding-sandbox.* - Your practice files

Contributing

We welcome contributions! Please see our Contributing Guidelines for details on:

• Setting up the development environment

• Code style and conventions

• Submitting pull requests

• Reporting issues

For questions or discussions, feel free to open an issue.

License

This project is licensed under the MIT License - see the LICENSE file for details.