MTosity

My personal CLI, whatever I need in one place. You can use it too! You may know something about me while using it.

  __  __   _____                 _   _
 |  \/  | |_   _|   ___    ___  (_) | |_   _   _
 | |\/| |   | |    / _ \  / __| | | | __| | | | |
 | |  | |   | |   | (_) | \__ \ | | | |_  | |_| |
 |_|  |_|   |_|    \___/  |___/ |_|  \__|  \__, |
                                           |___/

Quick Start

bunx mtosity

or

npx mtosity

Commands

Type / to see all commands with inline autocomplete. Use Tab or Enter to accept a suggestion, arrow keys to navigate. Each argument position shows either selectable options (e.g. /game → tetris, invaders) or placeholder hints (e.g. /yt → <url>).

About

| Command | Description | |---|---| | /me | Animated terminal resume / about me |

System

| Command | Description | |---|---| | /system | Display system info (OS, CPU, GPU, memory, IP addresses) |

Apps

| Command | Description | |---|---| | /spotify status | Show current Spicetify config | | /spotify theme <name> | Switch theme (mocha, macchiato, frappe, latte, dark, dracula, nord, gruvbox, rosepine, default) | | /spotify apply | Apply Spicetify config | | /spotify restart | Restart Spotify | | /spotify fix | Backup & apply (fixes after Spotify updates) | | /spotify restore | Restore original Spotify | | /whisky status | Check Whisky installation | | /whisky run <file.exe> | Run a Windows .exe via Whisky | | /whisky open | Open Whisky.app GUI | | /whisky install | Install Whisky via Homebrew |

Media

| Command | Description | |---|---| | /yt <url> [start] [end] | Download YouTube video (MP4) | | /yt-mp3 <url> [start] [end] | Download YouTube audio (MP3) | | /harmonica <file> [preset] | Enhance harmonica recording (presets: echo, echo-light, echo-heavy, bass) |

Games

| Command | Description | |---|---| | /game | List available games | | /game tetris | Bastard Tetris — always gives you the worst piece | | /game invaders | nInvaders — Space Invaders clone in the terminal |

Utility

| Command | Description | |---|---| | /clock | World clock showing times across cities | | /clock -p <city> | Add specific cities to the clock (e.g. /clock -p berlin -p "san francisco") | | /weather [city] | Show current weather (via wttr.in) | | /weather [city] -d [date] | Show historical/future weather (via Open-Meteo). Date: YYYY-MM-DD or MM-DD |

General

| Command | Description | |---|---| | /help | Show available commands | | /clear | Clear the terminal | | /exit | Exit the CLI |

Tip: Type / to see autocomplete suggestions. Use ↑/↓ arrows to navigate suggestions or command history. Press Tab to accept a suggestion. Placeholder hints (e.g. <file>, <url>) appear as you type but are non-interactive — just keep typing to fill in the value.

Examples

# System info
/system

# Switch Spotify theme
/spotify theme mocha

# Download a video
/yt https://youtu.be/dQw4w9WgXcQ

# Download and trim audio (start at 0:30, duration 1:00)
/yt-mp3 https://youtu.be/dQw4w9WgXcQ 00:00:30 00:01:00

# Run a Windows exe
/whisky run ~/Downloads/setup.exe

# Enhance a harmonica recording with heavy echo
/harmonica recording.mp4 echo-heavy

# Check weather (auto-locate)
/weather

# Check weather history (London, Y2K)
/weather London -d 2000-01-01

# Check forecast (Tokyo, Christmas)
/weather Tokyo -d 12-25

Project Structure

src/
├── index.ts              Entry point
├── cli.ts                REPL loop & command dispatch
├── commands/
│   ├── help.ts           Help display (registry-driven)
│   ├── registry.ts       Command registry & definitions
│   ├── system.ts         System info (neofetch-style)
│   ├── spicetify.ts      Spotify/Spicetify management
│   ├── whisky.ts         Windows app runner via Whisky
│   ├── youtube.ts        YouTube downloader
│   ├── harmonica.ts      Audio enhancement
│   ├── clock.ts          World clock display
│   ├── weather.ts        Weather (wttr.in & Open-Meteo)
│   └── game.ts           Game launcher (tetris, invaders)
├── ui/
│   ├── renderer.ts       Terminal renderer (ANSI, scroll regions)
│   ├── input.ts          Raw stdin input handler
│   └── suggestions.ts    Autocomplete suggestion engine
├── games/
│   ├── terminal.ts       Shared game infrastructure (keys, ANSI)
│   ├── tetris/
│   │   ├── index.ts      Tetris game loop & state machine
│   │   ├── pieces.ts     Tetromino definitions & rotations
│   │   ├── board.ts      Board state, collision, line clearing
│   │   ├── bastard.ts    Worst-piece selection algorithm
│   │   └── renderer.ts   Board + HUD rendering
│   └── invaders/
│       ├── index.ts      Invaders game loop & state machine
│       ├── entities.ts   Types, sprites, colors
│       ├── wave.ts       Wave creation, speed scaling
│       └── renderer.ts   Scene rendering
└── utils/
    ├── ffmpeg.ts          FFmpeg & yt-dlp setup
    └── network.ts         IP address utilities

Development

# Install dependencies
bun install

# Run in dev mode
bun run dev

# Run tests
bun test

# Build
bun run build

License

MIT