roguelike-cli 1.3.0 → 1.3.2

package/README.md

@@ -17,21 +17,18 @@
 ╚═════════════════════════╝
 ```
 
-## What is this?
+**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.
 
-**A gamified task manager where every task is a folder and every project is a dungeon.**
+## Features
 
-Instead of flat text files, your tasks become a **file system tree**. Nested tasks = nested folders. Complete tasks to earn XP, level up, and unlock achievements.
+- **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.
+- **Themeable** — Choose your adventure style: Fantasy, Space Opera, Star Wars, Cyberpunk, and more.
 
-## Features
+## Why Roguelike CLI?
 
-- **Navigate** your todos like directories (`cd`, `ls`, `tree`)
-- **Track progress** with XP, levels, and streaks
-- **Earn achievements** for completing tasks
-- **Mark milestones** as boss fights (3x XP)
-- **Set deadlines** with human-readable dates
-- **Generate visualizations** - trees, block diagrams, dungeon maps
-- Let **AI help** you structure complex projects
+Most task managers are boring. We make deep work addictive by applying proven RPG mechanics to your daily workflow.
 
 ## Install
 
@@ -40,40 +37,107 @@ npm i -g roguelike-cli
 rlc
 ```
 
+## 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.
+
 ## Quick Start
 
 ```
-> todo launch startup
+> todo launch my startup
 
 ├── Research [BOSS]
 │   ├── Market analysis
-│   └── User interviews
+│   └── User interviews [DUE: +7d]
 ├── Development
-│   ├── Backend API [DUE: +7d]
+│   ├── Backend API [DUE: Jan 20]
 │   └── Frontend UI
 └── Launch [MILESTONE]
-    └── Marketing campaign
 
-[Type "save" to create folder launch-startup/]
+[Type "save" to create folders]
 > save
-Created todo folder: launch-startup/
+Created: launch-my-startup/
 
-> cd launch-startup/research
+> cd launch-my-startup/research
 > done
 
-=== TASK COMPLETED ===
+=== QUEST COMPLETED ===
 
-Tasks completed: 3
-Bosses defeated: 1
 +45 XP
-
 *** LEVEL UP! ***
-You are now level 2!
 
 === NEW ACHIEVEMENTS ===
-[x] First Blood: Complete your first task
-[x] Boss Slayer: Complete a boss task
+[x] First Blood: Complete your first quest
+[x] Boss Slayer: Defeat a boss
+```
+
+## Configuration
+
+Run `init` to set up, or use `config` flags:
+
+```
+> config
+
+Provider:     claude
+Model:        claude-sonnet-4-20250514
+API Key:      sk-ant-a...xxxx
+Storage:      /Users/you/.rlc/workspace
+Theme:        Fantasy RPG
+Rules:        Use fantasy RPG language...
+
+Set with flags:
+  config -k=<key>       Set API key
+  config -m=<model>     Set model
+  config -t=<theme>     Set theme
+  config -r="<rules>"   Set custom rules
+```
+
+### Default Settings
+
+| Setting | Default |
+|---------|---------|
+| Provider | Claude Sonnet 4.5 |
+| Storage | `~/.rlc/workspace` |
+| Theme | Default (no theme) |
+
+## Themes (Rules)
+
+Themes change how the AI speaks. Set with `config -t=<theme>` or during `init`.
+
+| Theme | Style |
+|-------|-------|
+| `default` | Standard task manager language |
+| `fantasy` | Quests, dungeons, dragons, loot |
+| `space` | Missions, starships, commanders |
+| `starwars` | Jedi, Force, Rebel Alliance |
+| `western` | Bounties, sheriffs, frontier |
+| `cyberpunk` | Gigs, netrunners, corps |
+| `pirate` | Plunder, treasure, seven seas |
+
+### 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.
 
 ## Commands
 
@@ -84,22 +148,21 @@ You are now level 2!
 | `ls` | List tasks (shows status) |
 | `tree` | Task tree with deadlines |
 | `tree -A` | Include files |
-| `tree --depth=N` | Limit depth |
 | `cd <task>` | Enter task |
-| `..`, `...` | Go up 1 or 2 levels |
-| `pwd` | Current path |
+| `..`, `...` | Go up levels |
 | `open` | Open in Finder |
 
 ### Task Management
 
 | Command | Description |
 |---------|-------------|
-| `done` | Complete task (recursive, earns XP) |
+| `done` | Complete task (earns XP) |
+| `undo` | Undo last done |
 | `deadline <date>` | Set deadline |
-| `boss` | Toggle boss status (3x XP) |
-| `block [reason]` | Mark as blocked |
-| `unblock` | Remove blocked status |
-| `status` | Show task details |
+| `boss` | Toggle boss (3x XP) |
+| `block [node]` | Block by task |
+| `unblock` | Remove block |
+| `check` | Show deadlines |
 
 ### Gamification
 
@@ -107,77 +170,63 @@ You are now level 2!
 |---------|-------------|
 | `stats` | XP, level, streaks |
 | `achievements` | Achievement list |
-| `map` | Dungeon map view |
-| `map --ai` | AI-generated dungeon |
+| `map` | Dungeon map |
+| `map --ai` | AI-generated map |
 
 ### File Operations
 
 | Command | Description |
 |---------|-------------|
 | `mkdir <name>` | Create task |
-| `cp <src> <dst>` | Copy |
-| `mv <src> <dst>` | Move/rename |
-| `rm <name>` | Delete file |
-| `rm -rf <name>` | Delete folder |
+| `cp`, `mv`, `rm` | Standard ops |
 
-### AI Generation
+### Configuration
 
 | Command | Description |
 |---------|-------------|
-| `<description>` | AI generates preview |
-| `save` | Save pending schema |
-| `cancel` | Discard |
+| `init` | Setup wizard |
+| `config` | View settings |
+| `config -k=<key>` | Set API key |
+| `config -m=<model>` | Set model |
+| `config -t=<theme>` | Set theme |
+| `config -r="<rules>"` | Custom rules |
 
 ## Deadlines
 
 ```
 > deadline today       # Due today
 > deadline tomorrow    # Due tomorrow
-> deadline +3d         # Due in 3 days
-> deadline Jan 15      # Due on date
+> deadline +3d         # In 3 days
+> deadline Jan 15      # Specific date
 ```
 
 Tree shows deadlines:
-
 ```
-├── Backend API/ [BOSS] [3d left]
+├── Backend/ [BOSS] [3d left]
 │   ├── Database/ [DONE]
-│   └── Endpoints/ [OVERDUE 2d]
+│   └── API/ [OVERDUE 2d]
 └── Frontend/ [tomorrow]
 ```
 
 ## XP System
 
-- Base XP: 10 per task
-- Depth bonus: +5 XP per nesting level
-- Boss multiplier: 3x XP
-
-| Level | XP Required |
-|-------|-------------|
-| 1 | 0 |
-| 2 | 100 |
-| 3 | 150 |
-| 5 | 337 |
-| 10 | 3,844 |
+| Factor | XP |
+|--------|-----|
+| Base task | 10 |
+| Per depth level | +5 |
+| Boss multiplier | 3x |
 
 ## Achievements
 
-| Achievement | Description |
-|-------------|-------------|
+| Achievement | How to unlock |
+|-------------|---------------|
 | First Blood | Complete first task |
 | Getting Started | Complete 10 tasks |
-| Productive | Complete 50 tasks |
 | Centurion | Complete 100 tasks |
-| Deep Diver | Complete task at depth 5+ |
-| Boss Slayer | Complete a boss task |
-| Boss Hunter | Defeat 5 bosses |
-| Speedrunner | Complete task same day |
-| On a Roll | 3 day streak |
+| Deep Diver | Task at depth 5+ |
+| Boss Slayer | Complete a boss |
+| Speedrunner | Same-day completion |
 | Streak Master | 7 day streak |
-| Unstoppable | 30 day streak |
-| Adventurer | Reach level 5 |
-| Veteran | Reach level 10 |
-| Legend | Reach level 25 |
 
 ## Dungeon Map
 
@@ -185,42 +234,12 @@ Tree shows deadlines:
 > map
 
   ###########################################
-  #                    #                    #
-  #   [Research]       #   [Development]    #
-  #   * Market         +---* Backend        #
-  #   x Users          #   @ Deploy BOSS    #
-  #                    #                    #
-  ##########+############+##################
-           |            |
-  ##########+############+##################
-  #                                         #
-  #            [Launch]                     #
-  #            * Marketing                  #
-  #            @ SHIP IT! [BOSS]            #
-  #                                         #
-  ###########################################
-
-Legend: * Task  x Done  @ Boss  ! Blocked  + Door
-```
-
-Use `map --ai` for creative AI-generated layouts.
-
-## Block Diagrams
-
-```
-> schema kubernetes cluster
-
-┌─────────────────────────────────────────────────────────────┐
-│                     Kubernetes Cluster                       │
-│                                                              │
-│  ┌──────────────────┐      ┌──────────────────┐            │
-│  │   Control Plane  │      │   Worker Nodes   │            │
-│  └────────┬─────────┘      └────────┬─────────┘            │
-│           └──────────┬───────────────┘                      │
-│  ┌──────────────────┐│┌──────────────────┐                 │
-│  │    PostgreSQL    │││     Redis        │                 │
-│  └──────────────────┘│└──────────────────┘                 │
-└─────────────────────────────────────────────────────────────┘
+  #                   #                     #
+  #   [Research]      #   [Development]     #
+  #   x Analysis      +---* Backend         #
+  #   x Interviews    #   @ Deploy BOSS     #
+  #                   #                     #
+  ##########+###########+###################
 ```
 
 ## Clipboard
@@ -228,15 +247,6 @@ Use `map --ai` for creative AI-generated layouts.
 ```
 > tree | pbcopy     # macOS
 > tree | clip       # Windows
-> ls | copy         # Alternative
-```
-
-## Configuration
-
-```
-> init              # Setup wizard
-> config            # Show settings
-> config:apiKey=sk-... # Set API key
 ```
 
 ## Website

package/dist/ai/claude.js

@@ -46,7 +46,7 @@ Create a creative, interesting dungeon layout for the given tasks.
 Output ONLY the ASCII map, no JSON wrapper.`;
 async function generateSchemaWithAI(input, config, signal, history) {
     if (!config.apiKey) {
-        throw new Error('API key not set. Use config:apiKey=<key> to set it.');
+        throw new Error('API key not set. Use config -k=<key> to set it.');
     }
     const client = new sdk_1.default({
         apiKey: config.apiKey,
@@ -68,10 +68,15 @@ async function generateSchemaWithAI(input, config, signal, history) {
     });
     try {
         const model = config.model || 'claude-sonnet-4-20250514';
+        // Build system prompt with custom rules
+        let systemPrompt = SYSTEM_PROMPT;
+        if (config.rules) {
+            systemPrompt += '\n\nADDITIONAL STYLE RULES (apply to all responses):\n' + config.rules;
+        }
         const message = await client.messages.create({
             model: model,
             max_tokens: 2000,
-            system: SYSTEM_PROMPT,
+            system: systemPrompt,
             messages: messages,
         });
         const content = message.content[0];
@@ -98,17 +103,22 @@ async function generateSchemaWithAI(input, config, signal, history) {
 }
 async function generateDungeonMapWithAI(treeContent, config, signal) {
     if (!config.apiKey) {
-        throw new Error('API key not set. Use config:apiKey=<key> to set it.');
+        throw new Error('API key not set. Use config -k=<key> to set it.');
     }
     const client = new sdk_1.default({
         apiKey: config.apiKey,
     });
     try {
         const model = config.model || 'claude-sonnet-4-20250514';
+        // Build system prompt with custom rules
+        let systemPrompt = DUNGEON_MAP_PROMPT;
+        if (config.rules) {
+            systemPrompt += '\n\nADDITIONAL STYLE RULES:\n' + config.rules;
+        }
         const message = await client.messages.create({
             model: model,
             max_tokens: 2000,
-            system: DUNGEON_MAP_PROMPT,
+            system: systemPrompt,
             messages: [{
                     role: 'user',
                     content: 'Generate a dungeon map for this task tree:\n\n' + treeContent

package/dist/commands/init.js

@@ -63,7 +63,6 @@ function copyRecursive(src, dest) {
     }
 }
 async function initCommand(existingRl) {
-    // Create our own readline if not provided, or use existing one
     const rl = existingRl || readline.createInterface({
         input: process.stdin,
         output: process.stdout,
@@ -73,7 +72,6 @@ async function initCommand(existingRl) {
         console.log('\n╔═══════════════════════════════════════╗');
         console.log('║   ROGUELIKE CLI INITIALIZATION WIZARD ║');
         console.log('╚═══════════════════════════════════════╝\n');
-        // Get existing config if any
         const existingConfig = await (0, config_1.initConfig)();
         const oldStoragePath = existingConfig?.storagePath;
         // 1. Root directory
@@ -121,7 +119,7 @@ async function initCommand(existingRl) {
         const selectedIndex = parseInt(aiChoice.trim()) - 1 || 0;
         const selectedProvider = aiProviders[selectedIndex] || aiProviders[0];
         console.log(`Selected: ${selectedProvider.name} (${selectedProvider.model})`);
-        // 3. API Key - reuse existing if not provided
+        // 3. API Key
         const existingApiKey = existingConfig?.apiKey || '';
         const hasExistingKey = existingApiKey.length > 0;
         const keyPrompt = hasExistingKey
@@ -130,7 +128,7 @@ async function initCommand(existingRl) {
         const apiKeyInput = await question(rl, keyPrompt);
         const apiKey = apiKeyInput.trim() || existingApiKey;
         if (!apiKey) {
-            console.log('Warning: API key not set. You can set it later with config:apiKey=<key>');
+            console.log('Warning: API key not set. You can set it later with: config -k <key>');
         }
         else if (apiKeyInput.trim()) {
             console.log('API key saved');
@@ -138,6 +136,39 @@ async function initCommand(existingRl) {
         else {
             console.log('Using existing API key');
         }
+        // 4. Theme/Rules selection
+        console.log('\nSelect AI Theme (affects language style):');
+        const presetKeys = Object.keys(config_1.RULES_PRESETS);
+        presetKeys.forEach((key, index) => {
+            console.log(`  ${index + 1}. ${config_1.RULES_PRESETS[key].name}`);
+        });
+        console.log(`  ${presetKeys.length + 1}. Custom (enter your own rules)`);
+        const existingPreset = existingConfig?.rulesPreset || 'default';
+        const defaultPresetIndex = presetKeys.indexOf(existingPreset) + 1 || 1;
+        const themeChoice = await question(rl, `\nEnter choice [1-${presetKeys.length + 1}] (default: ${defaultPresetIndex}): `);
+        const themeIndex = parseInt(themeChoice.trim()) - 1;
+        let selectedRules = '';
+        let selectedPreset = 'default';
+        if (themeIndex >= 0 && themeIndex < presetKeys.length) {
+            selectedPreset = presetKeys[themeIndex];
+            selectedRules = config_1.RULES_PRESETS[selectedPreset].rules;
+            console.log(`Selected: ${config_1.RULES_PRESETS[selectedPreset].name}`);
+        }
+        else if (themeIndex === presetKeys.length) {
+            // Custom rules
+            console.log('\nEnter your custom rules for AI (how it should speak, what terms to use):');
+            console.log('Example: "Use pirate language. Tasks are treasure hunts. Be playful."');
+            const customRules = await question(rl, '\nYour rules: ');
+            selectedRules = customRules.trim();
+            selectedPreset = 'custom';
+            console.log('Custom rules saved');
+        }
+        else {
+            // Default
+            selectedPreset = existingConfig?.rulesPreset || 'default';
+            selectedRules = existingConfig?.rules || '';
+            console.log(`Keeping: ${config_1.RULES_PRESETS[selectedPreset]?.name || 'Default'}`);
+        }
         // Save config
         const config = {
             aiProvider: selectedProvider.name,
@@ -146,9 +177,10 @@ async function initCommand(existingRl) {
             storagePath: rootDir,
             currentPath: rootDir,
             model: selectedProvider.model,
+            rules: selectedRules,
+            rulesPreset: selectedPreset,
         };
         (0, config_1.saveConfig)(config);
-        // Ensure storage directory exists
         if (!fs.existsSync(rootDir)) {
             fs.mkdirSync(rootDir, { recursive: true });
         }
@@ -157,7 +189,8 @@ async function initCommand(existingRl) {
         console.log('╚═══════════════════════════════════════╝\n');
         console.log(`Root directory: ${rootDir}`);
         console.log(`AI Provider: ${selectedProvider.name}`);
-        console.log(`Model: ${selectedProvider.model}\n`);
+        console.log(`Model: ${selectedProvider.model}`);
+        console.log(`Theme: ${config_1.RULES_PRESETS[selectedPreset]?.name || 'Custom'}\n`);
     }
     finally {
         if (shouldCloseRl) {

package/dist/config/config.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RULES_PRESETS = void 0;
 exports.initConfig = initConfig;
 exports.saveConfig = saveConfig;
 exports.getConfig = getConfig;
@@ -40,6 +41,37 @@ exports.updateConfig = updateConfig;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+// Preset rules for different themes
+exports.RULES_PRESETS = {
+    default: {
+        name: 'Default (No theme)',
+        rules: '',
+    },
+    fantasy: {
+        name: 'Fantasy RPG',
+        rules: 'Use fantasy RPG language. Tasks are "quests", completing them is "slaying". Major milestones are "boss battles". Use terms like "adventurer", "dungeon", "loot", "guild". Add flavor text with swords, dragons, magic.',
+    },
+    space: {
+        name: 'Space Opera',
+        rules: 'Use sci-fi space language. Tasks are "missions", completing them is "mission accomplished". Major milestones are "final frontier". Use terms like "commander", "starship", "coordinates", "hyperdrive". Add flavor with stars, planets, aliens.',
+    },
+    starwars: {
+        name: 'Star Wars',
+        rules: 'Use Star Wars language. Tasks are "missions from the Rebel Alliance". Completing is "defeating the Empire". Milestones are "destroying the Death Star". Use "Jedi", "Force", "Padawan", "Master". May the Force be with you.',
+    },
+    western: {
+        name: 'Wild West',
+        rules: 'Use Wild West language. Tasks are "bounties", completing them is "collecting the reward". Milestones are "showdowns". Use terms like "sheriff", "outlaw", "saloon", "frontier", "partner". Add dusty trails and tumbleweeds.',
+    },
+    cyberpunk: {
+        name: 'Cyberpunk',
+        rules: 'Use cyberpunk language. Tasks are "gigs", completing them is "flatlined". Milestones are "megacorp takedowns". Use terms like "netrunner", "chrome", "corpo", "edgerunner", "eddies". Add neon and rain.',
+    },
+    pirate: {
+        name: 'Pirate',
+        rules: 'Use pirate language. Tasks are "plunder", completing them is "claiming the treasure". Milestones are "capturing the flagship". Use "captain", "crew", "booty", "seven seas", "landlubber". Arr matey!',
+    },
+};
 const CONFIG_FILE = path.join(os.homedir(), '.rlc', 'config.json');
 const DEFAULT_STORAGE = path.join(os.homedir(), '.rlc', 'workspace');
 async function initConfig() {