storymode-cli 1.2.1 → 1.2.2

package/README.md

@@ -3,29 +3,31 @@
 AI-animated pixel art companions for your terminal. Reacts to Claude Code in real time.
 
 ```
-npx storymode-cli play 3
+npx storymode-cli play
 ```
 
 ## Quick Start
 
 ```bash
-# Browse available characters
-npx storymode-cli browse
-
-# Run a companion alongside Claude Code
-npx storymode-cli play 3
+npx storymode-cli play
 ```
 
-The companion opens in a tmux side pane and reacts to what Claude Code is doing — switching animations when it reads files, writes code, hits errors, etc. Speech bubbles show in-character lines.
+That's it. A companion opens in a tmux side pane and reacts to what Claude Code is doing — switching animations when it reads files, writes code, hits errors, etc.
+
+Use `browse` to switch characters or visit [storymode.fixmy.codes](https://storymode.fixmy.codes) to see the full gallery.
+
+```bash
+npx storymode-cli browse
+```
 
 ## Options
 
 ```bash
-npx storymode-cli play 3              # full size (default)
-npx storymode-cli play 3 --compact    # smaller pane
-npx storymode-cli play 3 --tiny       # tiny pane
-npx storymode-cli play 3 --no-ai      # disable AI personality
-npx storymode-cli play 3 --classic    # full-screen animation viewer
+npx storymode-cli play              # full size (default)
+npx storymode-cli play --compact    # smaller pane
+npx storymode-cli play --tiny       # tiny pane
+npx storymode-cli play --no-ai      # disable AI personality
+npx storymode-cli play --classic    # full-screen animation viewer
 ```
 
 **Keyboard:** `a` add API key (enables AI personality), `q` quit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storymode-cli",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Play AI-animated pixel art characters in your terminal",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -78,8 +78,8 @@ const HELP = `
   storymode-cli — AI-animated pixel art companions for your terminal
 
   Usage:
-    storymode play <id>       Run a reactive companion alongside Claude Code
-    storymode browse          Browse the gallery and pick a character
+    storymode play            Run a reactive companion alongside Claude Code
+    storymode browse          Browse the gallery and switch characters
 
   Options:
     --compact        Smaller companion pane (default: full)
@@ -110,19 +110,17 @@ function parseFlags(args) {
   return { flags, positional };
 }
 
+const DEFAULT_CHARACTER = 3; // Zephyr
+
 export async function run(args) {
   const cmd = args[0];
   const { flags, positional } = parseFlags(args.slice(1));
-  const id = positional[0];
+  const id = positional[0] || (cmd === 'play' || cmd === 'companion' ? DEFAULT_CHARACTER : undefined);
 
   switch (cmd) {
     // --- Main command: reactive companion ---
     case 'play':
     case 'companion': {
-      if (!id) {
-        console.error('Usage: storymode play <id>');
-        process.exit(1);
-      }
 
       // --classic: old full-screen animation viewer
       if (flags.classic) {