Roguelike CLI

  |
  |
  + \
  \.G_.*=.
   `(#'/.\ |
    .>' (_--.
 _=/d   ,^\
~~ \)-'   '
   / |   rlc
  '  '

╔═════════════════════════╗
║      Roguelike CLI      ║
╚═════════════════════════╝

Turn your backlog into a dungeon crawl. Roguelike CLI is a terminal-based task manager that transforms productivity into an RPG experience. Complete quests, level up, and conquer your goals.

Features

• RPG Engine — Tasks are quests. Completing them earns XP, unlocks achievements, and levels you up.
• AI Game Master — Integrated AI helps decompose complex tasks and generates structured plans.
• Local-First — Your data stays on your machine in simple folders and JSON files.
• Customizable Rules — Choose adventure style: Fantasy, Space Opera, Star Wars, Cyberpunk, and more.

Install

npm i -g roguelike-cli
rlc

Quick Start

> todo launch my startup

├── Research [BOSS]
│   ├── Market analysis
│   └── User interviews [DUE: +7d]
├── Development
│   ├── Backend API [DUE: Jan 20]
│   └── Frontend UI
└── Launch [MILESTONE]

[Type "save" to create folders]
> save
Created: launch-my-startup/

> cd launch-my-startup/research
> done

=== QUEST COMPLETED ===

+45 XP
*** LEVEL UP! ***

=== NEW ACHIEVEMENTS ===
[x] First Blood: Complete your first quest
[x] Boss Slayer: Defeat a boss

Folder Structure

Every task is a folder. You can drop files directly into task folders — designs, docs, code, anything. Your file manager becomes your task manager.

my-startup/
├── research/
│   ├── market-analysis/
│   │   └── competitors.xlsx    <- attached file
│   └── user-interviews/
│       └── notes.md            <- attached file
├── development/
│   ├── backend-api/
│   │   └── spec.yaml           <- attached file
│   └── frontend-ui/
└── launch/
    └── marketing/

Navigate with cd, view with tree, open in Finder with open. It's just folders.

Rules

Rules change how the AI speaks. Set during init or with config -R="<rules>".

| Preset | Style | |--------|-------| | default | Standard task manager language | | fantasy | Quests, dungeons, dragons, loot | | space | Missions, starships, commanders | | starwars | Jedi, Force, Rebel Alliance | | cyberpunk | Gigs, netrunners, corps | | pirate | Plunder, treasure, seven seas | | western | Bounties, sheriffs, frontier | | warhammer | For the Emperor! Purge heretics | | ninja | Shinobi, shadows, honor, blades | | crusader | Build castles, conquer Holy Land! | | darksouls | YOU DIED. Praise the Sun! |

Custom Rules

> config -R="Speak like a medieval knight. Tasks are 'duties'. Use 'huzzah' for success."

Or select "Custom" during init to enter your own rules.

Dungeon Map

> map

  #########################################
  #                   #                   #
  #   [Research]      #   [Development]   #
  #   x Analysis      +---* Backend       #
  #   x Interviews    #   * Frontend      #
  #                   #                   #
  ##########+###########+#################
            |           |
  ##########+###########+#################
  #                                       #
  #            [Launch]                   #
  #            * Marketing                #
  #            @ SHIP IT! [BOSS]          #
  #                                       #
  #########################################

  Legend: * Task  x Done  @ Boss  + Door

> map --ai
(AI generates creative dungeon layout based on your tasks)

Commands

Navigation

| Command | Description | |---------|-------------| | ls | List tasks (shows status) | | tree | Task tree with deadlines | | tree -A | Include files | | cd <task> | Enter task | | .., ... | Go up levels | | open | Open in Finder |

Task Management

| Command | Description | |---------|-------------| | done | Complete task (earns XP) | | undo | Undo last done | | dl <date> | Set deadline (dl +3d, dl Jan 15) | | boss | Toggle boss (3x XP) | | block [node] | Block by task | | unblock | Remove block | | check | Show deadlines |

Gamification

| Command | Description | |---------|-------------| | stats | XP, level, streaks | | achievements | Achievement list (infinite) | | inventory | Loot collection | | map | Dungeon map | | map --ai | AI-generated map |

File Operations

| Command | Description | |---------|-------------| | mkdir <name> | Create task | | cp, mv, rm | Standard ops |

Configuration

| Command | Description | |---------|-------------| | init | Setup wizard | | config | View settings | | config -K=<key> | or --key=<key> | | config -M=<model> | or --model=<model> | | config -R="<rules>" | or --rules="<rules>" |

Clipboard

| Command | Description | |---------|-------------| | <cmd> \| pbcopy | Copy to clipboard (macOS) | | <cmd> \| clip | Copy to clipboard (Windows) |

Deadlines

> dl today         # Due today
> dl tomorrow      # Due tomorrow
> dl +3d           # In 3 days
> deadline Jan 15  # Specific date

Tree shows deadlines:

├── Backend/ [BOSS] [3d left]
│   ├── Database/ [DONE]
│   └── API/ [OVERDUE 2d]
└── Frontend/ [tomorrow]

XP System

| Factor | XP | |--------|-----| | Base task | 10 | | Per depth level | +5 | | Boss multiplier | 3x |

Achievements

Achievements are infinite and level-based. Keep progressing to unlock more!

| Category | Milestones | |----------|------------| | Tasks | 1, 10, 50, 100, 500, 1000, 2500, 5000... | | Bosses | 1, 5, 10, 25, 50, 100... | | Streaks | 3, 7, 14, 30, 60, 90, 180, 365 days | | Depth | 3, 5, 7, 10, 15, 20 levels | | Special | Speedrunner, Night Owl, Early Bird |

Loot System

Complete tasks to find loot! Higher level = rarer drops.

| Rarity | Drop Rate | Symbol | |--------|-----------|--------| | Common | ~25% | [.] | | Uncommon | ~15% | [+] | | Rare | ~8% | [*] | | Epic | ~3% | [#] | | Legendary | ~1% | [!] |

Bonus drops on:

• Level up: 3x chance
• Achievement: 2.5x chance
• Boss completion: 2x chance

> inventory

=== Inventory (5 items) ===

Legendary:
  [!] Excalibur

Rare:
  [*] Ring of Protection
  [*] Boots of Speed

Common:
  [.] Health Potion
  [.] Torch

Supported Models

claude-sonnet-4-20250514 (default)
claude-opus-4-20250514
gpt-4o
gpt-4-turbo
gemini-3-pro
gemini-2.0-flash
grok-beta

Author

Creative Ventures

License

MIT