Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (codeshift-learn) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CodeShift

Learn to code. Never leave the terminal.

CodeShift is a fully interactive coding education tool that runs inside your terminal — no browser, no app, no account required. Think Duolingo for programming, built for developers who live in the command line.

Install

npm install -g codeshift-learn

Requirements: Node.js 18+

Quick Start

# 1. Launch CodeShift
codeshift start

# 2. Pick a language track (Python or JavaScript included free)
# 3. Work through lessons with instant feedback

Available Languages

Track	Levels	Lessons	Free / Pro
Python 🐍	3	30	Free
JavaScript 🟡	3	30	Free
TypeScript	3	30	Pro
Rust	3	30	Pro
Go	3	30	Pro
Java	3	30	Pro
C++	3	30	Pro
Kotlin	3	30	Pro
Swift	3	30	Pro
Ruby	3	30	Pro
PHP	3	30	Pro
C#	3	30	Pro

Lesson Types

Read — Concept explanations with syntax-highlighted code examples
Fill in the Blank — Type the missing code with up to 2 attempts
Multiple Choice — Pick from 4 options with arrow key navigation
Write Code — Write a function in your editor; CodeShift runs your code against test cases
Fix the Bug — Find and fix broken code
Mini Project — End-of-level projects (Pro)

Free vs Pro

Feature	Free	Pro
Python track (30 lessons)	✓	✓
JavaScript track (30 lessons)	✓	✓
10 additional language tracks		✓
Mini projects		✓
Progress sync across machines		✓
Priority support		✓

Pro costs $7.99/month with a 14-day free trial.

Activate Pro

codeshift activate XXXX-XXXX-XXXX-XXXX

Purchase a license at codeshift.dev/upgrade

All Commands

codeshift start              # Launch the app (main menu)
codeshift progress           # View XP, streak, and completion stats
codeshift activate <key>     # Activate a Pro license key
codeshift update             # Check for newer versions
codeshift help               # Show command reference
codeshift version            # Print version number

Features

Streaks — Build a daily coding habit. Earn bonus XP for consecutive days
XP System — Earn 10–50 XP per lesson; track your total across sessions
Progress Tracking — Pick up exactly where you left off
Syntax Highlighting — Code examples rendered in full color in your terminal
Code Execution — Write real code; CodeShift runs it against test cases
Cross-Platform — Works on Windows (PowerShell, Git Bash, Windows Terminal), macOS, and Linux

Development Setup

git clone https://github.com/your-org/codeshift
cd codeshift
npm install
npm run dev          # Watch mode with tsx
npm run build        # Production build with tsup
npm test             # Run tests with vitest

Contributing

Fork the repo and create a branch
Add lessons in src/lessons/tracks/<language>/level-0X.json
Follow the existing JSON schema (src/lessons/schema.ts)
Run npm test to validate
Open a pull request

See CONTRIBUTING.md for detailed guidelines.

License

CLI core: MIT License