roguelike-cli 1.1.0 → 1.2.1

package/README.md

@@ -0,0 +1,308 @@
+# Roguelike CLI
+
+```
+  |
+  |
+  + \
+  \.G_.*=.
+   `(#'/.\ |
+    .>' (_--.
+ _=/d   ,^\
+~~ \)-'   '
+   / |
+  '  '
+
+╔═════════════════════════╗
+║      Roguelike CLI      ║
+╚═════════════════════════╝
+```
+
+## What is this?
+
+**A new format for notes, schemas, and todo lists — where every task is a folder.**
+
+Instead of flat text files, your tasks become a **file system tree**. Nested tasks = nested folders. You can:
+
+- **Navigate** your todos like directories (`cd`, `ls`, `tree`)
+- **Attach files** directly to tasks (just put them in the folder)
+- **Track dependencies** and blockers between tasks
+- **Generate beautiful visualizations** — trees, block diagrams, and even **dungeon maps**
+- Let **AI help** you structure complex projects
+
+## Why folders?
+
+```
+project/
+├── phase-1-research/
+│   ├── market-analysis/
+│   │   └── competitors.xlsx      ← attach files directly!
+│   └── user-interviews/
+├── phase-2-development/
+│   ├── backend-api/
+│   ├── frontend-ui/
+│   └── database-schema/
+└── phase-3-launch/
+    ├── marketing/
+    └── deployment/
+```
+
+Your file manager becomes your task manager. Git tracks your progress. AI generates the structure.
+
+## Install
+
+```bash
+npm i -g roguelike-cli
+rlc
+```
+
+## Workflow
+
+```
+> todo launch my startup
+
+├── Research
+│   ├── Market analysis
+│   ├── Competitor research
+│   └── User interviews
+├── Development
+│   ├── MVP features
+│   ├── Backend API
+│   └── Frontend UI
+├── Launch
+│   ├── Marketing campaign
+│   └── Press release
+└── Growth
+    ├── Metrics tracking
+    └── User feedback
+
+[Type "save" to create folder launch-my-startup/]
+> save
+Created todo folder: launch-my-startup/
+
+> cd launch-my-startup
+> tree
+├── research/
+│   ├── market-analysis/
+│   ├── competitor-research/
+│   └── user-interviews/
+├── development/
+│   ├── mvp-features/
+│   ├── backend-api/
+│   └── frontend-ui/
+├── launch/
+│   ├── marketing-campaign/
+│   └── press-release/
+└── growth/
+    ├── metrics-tracking/
+    └── user-feedback/
+```
+
+Now you can `cd development/backend-api` and drop your actual code files there!
+
+## Visualizations
+
+### Tree View (default)
+
+```
+├── Phase 1: Setup
+│   ├── Create repository
+│   ├── Setup CI/CD
+│   └── Configure environment
+├── Phase 2: Development
+│   ├── Backend API
+│   └── Frontend UI
+└── Phase 3: Deploy
+```
+
+### Block Diagram (for architecture)
+
+```
+> schema kubernetes cluster
+
+┌─────────────────────────────────────────────────────────────┐
+│                  Kubernetes Cluster                         │
+│                                                             │
+│  ┌──────────────┐      ┌──────────────┐                    │
+│  │   postgres   │      │    redis     │                    │
+│  │              │      │              │                    │
+│  │ primary-pod  │      │ cache-pod-1  │                    │
+│  │ replica-pod  │      │ cache-pod-2  │                    │
+│  └──────┬───────┘      └──────┬───────┘                    │
+│         └──────────┬───────────┘                            │
+│                    ▼                                        │
+│            ┌───────────────┐                                │
+│            │ worker-nodes  │                                │
+│            └───────────────┘                                │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Dungeon Map View (roguelike style) 🎮
+
+Visualize your project as a dungeon map! Each room is a task, corridors show dependencies.
+
+```
+> map
+
+  ████████████████████████████████████████
+  █                    █                 █
+  █   [Research]       █   [Development] █
+  █   ♦ Market         █   ♦ Backend     █
+  █   ♦ Users    ──────+───♦ Frontend    █
+  █                    █   ♦ Database    █
+  █████████+███████████████████+██████████
+           │                   │
+  █████████+███████████████████+██████████
+  █                    █                 █
+  █   [Launch]         █   [Growth]      █
+  █   ♦ Marketing      █   ♦ Metrics     █
+  █   ♦ Press    ──────+───♦ Feedback    █
+  █   ♣ BOSS: Ship it! █                 █
+  █                    █                 █
+  ████████████████████████████████████████
+
+Legend: ♦ Task  ♣ Milestone  + Door/Dependency  █ Wall
+```
+
+*Coming soon: Interactive dungeon exploration, XP for completed tasks, achievements!*
+
+## Gamification (Roadmap)
+
+- 🎯 **XP System** — Earn experience for completing tasks
+- 🏆 **Achievements** — "First Blood", "100 Tasks", "Deep Nesting"
+- 🗡️ **Boss Tasks** — Major milestones as boss fights
+- 🗺️ **Dungeon Maps** — Explore your project as a roguelike dungeon
+- 📊 **Stats** — Track velocity, streaks, completion rates
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ls` | List tasks and files |
+| `tree` | Show task tree |
+| `tree -A` | Include files |
+| `cd <task>` | Enter task |
+| `..` | Go back |
+| `mkdir <name>` | Create task |
+| `open` | Open in Finder |
+| `cp`, `mv`, `rm` | File operations |
+| `config` | Settings |
+| `help` | Examples |
+
+## AI Integration
+
+Just describe what you need:
+
+```
+> todo bake cookies
+
+├── Prep
+│   ├── Gather ingredients
+│   └── Preheat oven
+├── Mix
+│   ├── Cream butter + sugar
+│   └── Add flour
+├── Bake (8-10 min)
+└── Cool & store
+
+> add deadline tomorrow for Bake
+> add blocker "buy flour" for Mix
+> shorter
+> more detailed
+> save
+```
+
+AI understands context and refines until you're happy.
+
+## Examples
+
+### Software Project
+
+```
+> todo build saas app
+
+├── Planning
+│   ├── Define MVP scope
+│   ├── Create wireframes
+│   └── Tech stack decision
+├── Backend
+│   ├── Database schema
+│   ├── API endpoints
+│   ├── Authentication
+│   └── Payment integration
+├── Frontend
+│   ├── Components library
+│   ├── Pages
+│   └── State management
+├── DevOps
+│   ├── CI/CD pipeline
+│   ├── Staging environment
+│   └── Production deployment
+└── Launch
+    ├── Beta testing
+    ├── Marketing site
+    └── Product Hunt launch
+```
+
+### Life Goals
+
+```
+> todo learn japanese
+
+├── Basics (Month 1-2)
+│   ├── Hiragana
+│   ├── Katakana
+│   └── Basic grammar
+├── Foundation (Month 3-6)
+│   ├── Kanji (500)
+│   ├── Vocabulary (2000 words)
+│   └── Genki textbook
+├── Intermediate (Month 6-12)
+│   ├── JLPT N4 prep
+│   ├── Reading practice
+│   └── Conversation partner
+└── Advanced
+    ├── JLPT N3
+    ├── Watch anime without subs
+    └── Visit Japan
+```
+
+### Infrastructure
+
+```
+> schema cloud infrastructure
+
+┌─────────────────────────────────────────────────────────────┐
+│                     Production                              │
+│                                                             │
+│  ┌──────────────────┐      ┌──────────────────┐           │
+│  │ Load Balancer    │      │ CDN              │           │
+│  └────────┬─────────┘      └──────────────────┘           │
+│           │                                                 │
+│  ┌────────▼────────┐  ┌────────────┐   ┌────────────────┐ │
+│  │   App Servers   │  │   Redis    │   │   PostgreSQL   │ │
+│  │   (3 replicas)  │──│   Cache    │   │   (Primary +   │ │
+│  └─────────────────┘  └────────────┘   │    Replica)    │ │
+│                                         └────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Clipboard
+
+```
+> tree | pbcopy     # macOS
+> tree | clip       # Windows
+```
+
+## Website
+
+**https://www.rlc.rocks**
+
+## Inspired by
+
+- [roguelike](https://www.npmjs.com/package/roguelike) — 2D dungeon map generator
+- Unix philosophy — everything is a file
+- GTD methodology — capture, organize, do
+
+## License
+
+MIT

package/dist/interactive/startup.js

@@ -16,7 +16,7 @@ const ASCII_ART = [
     '  \'  \'',
     '',
     '╔═════════════════════════╗',
-    '║    Roguelike CLI v1.0   ║',
+    '║      Roguelike CLI      ║',
     '╚═════════════════════════╝',
     '',
     '  Commands: ls, cd, mkdir, open, cp, mv, rm, tree, pwd, clean',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roguelike-cli",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "AI-powered interactive terminal for creating schemas and todo lists",
   "main": "dist/index.js",
   "bin": {

package/src/interactive/startup.ts

@@ -14,7 +14,7 @@ const ASCII_ART = [
   '  \'  \'',
   '',
   '╔═════════════════════════╗',
-  '║    Roguelike CLI v1.0   ║',
+  '║      Roguelike CLI      ║',
   '╚═════════════════════════╝',
   '',
   '  Commands: ls, cd, mkdir, open, cp, mv, rm, tree, pwd, clean',

package/INSTALL.md

@@ -1,108 +0,0 @@
-# Roguelike CLI - Installation Guide
-
-## Local Development Setup
-
-1. Install dependencies:
-```bash
-cd cli
-npm install
-```
-
-2. Build the project:
-```bash
-npm run build
-```
-
-3. Link locally for testing:
-```bash
-npm link
-```
-
-This will make `rlc` command available globally.
-
-4. Test the installation:
-```bash
-rlc
-```
-
-## First Run
-
-Run `init` to configure:
-```bash
-rlc
-> init
-```
-
-Or set API key manually:
-```bash
-> config:apiKey=your-api-key-here
-```
-
-## How to Use
-
-### View config
-```bash
-> config
-Provider:     claude
-Model:        claude-sonnet-4-20250514
-API Key:      sk-ant-a...1234
-Storage:      /Users/you/.rlc/notes
-```
-
-### Create schema or todo
-```bash
-> todo opening company in delaware
-> architecture kubernetes cluster with postgres
-```
-
-### Navigation
-```bash
-> ls                    # list files (columns)
-> cd my-project         # go into folder
-> cd ..                 # go back
-> pwd                   # current path
-> tree                  # show tree structure
-> tree -A               # show tree with files
-> tree --depth=2        # limit depth
-> open                  # open folder in Finder
-> open my-folder        # open specific folder
-```
-
-### Copy to clipboard
-Add `| pbcopy` (macOS), `| copy` or `| clip` (Windows) to any command:
-```bash
-> ls | pbcopy
-> tree | pbcopy
-> config | pbcopy
-> pwd | pbcopy
-```
-
-### File operations
-```bash
-> mkdir my-note         # create folder
-> cp source dest        # copy
-> mv source dest        # move/rename
-> rm file               # delete file
-> rm -rf folder         # delete folder
-```
-
-## Uninstall
-
-```bash
-npm unlink -g roguelike-cli
-```
-
-## Troubleshooting
-
-If you get "command not found":
-- Make sure `npm link` was run successfully
-- Check that `~/.npm-global/bin` or similar is in your PATH
-
-If API errors occur:
-- Verify your API key is set: `config`
-- Check that you have credits/access to Claude API
-
-## Website
-
-https://www.rlc.rocks
-