Master vim motions through competitive practice
MoCaCo is a gamified vim motion training application that transforms casual vim users into motion masters through standardized practice rounds. Complete text transformations using vim commands and track your improvement over time.
- 30-Task Rounds - Standardized practice sessions with balanced task categories
- Real-Time Feedback - Instant visual feedback as you type (green for correct, red for incorrect)
- Comprehensive Statistics - Track performance by category, efficiency metrics, and improvement over time
- Multiple Difficulty Levels - From beginner basics to expert-level transformations
- Terminal UI - Beautiful TUI built with Bubble Tea and Lipgloss
- REST API - Server mode for web clients and remote practice
# Install with Go go install github.com/timlinux/macaco/cmd/macaco@latest # Or build from source git clone https://github.com/timlinux/macaco cd macaco make build ./bin/macaco
# Run in combined mode (default) macaco # Start a specific round type macaco --round intermediate # Run as server only macaco --server --addr localhost:8080 # Connect to remote server macaco --client --addr server.example.com:8080 # Show version macaco --version
| Round | Difficulty | Description |
|---|---|---|
| Beginner | Level 1 | Basic motions, simple operations |
| Intermediate | Level 1-2 | Counts, text objects |
| Advanced | Level 2-3 | Complex combinations |
| Expert | Level 3-4 | Multi-step transformations |
| Mixed | Level 1-4 | Random difficulty |
| Key | Action |
|---|---|
Ctrl+R |
Reset current task |
Ctrl+S |
Skip current task |
Ctrl+H |
Show/cycle hints |
Ctrl+P |
Pause/resume timer |
Ctrl+C |
Quit |
? |
Show help |
Each round includes 30 tasks distributed across:
- Motion (6) - Cursor movement without editing
- Delete (6) - Deletion operations (d, x, dd, D)
- Change (6) - Change operations (c, s, C, S, r)
- Insert (6) - Insertion operations (i, a, o, I, A, O)
- Visual (3) - Visual mode selections
- Complex (3) - Multi-step combinations
git clone https://github.com/timlinux/macaco
cd macaco
make build
./bin/macacogo install github.com/timlinux/macaco/cmd/macaco@latest
nix run github:timlinux/macaco
Download from GitHub Releases.
Statistics and preferences are stored in:
~/.config/macaco/stats.json
Full documentation available at https://timlinux.github.io/macaco
# Build make build # Test make test # Lint make lint # Run documentation server make docs
macaco/
├── cmd/macaco/ # Main entry point
├── internal/
│ ├── api/ # REST API server/client
│ ├── config/ # Configuration
│ ├── game/ # Game logic
│ ├── stats/ # Statistics tracking
│ ├── tui/ # Terminal UI
│ └── vim/ # Vim engine
├── docs/ # MkDocs documentation
└── scripts/ # Management scripts
MIT License - see LICENSE for details.
Contributions welcome! Please read the development guide first.
- Bubble Tea - TUI framework
- Lipgloss - Style definitions