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

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/macaco

go 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