caroushell 0.1.0 → 0.1.1

package/README.md

@@ -1,14 +1,14 @@
 # Caroushell
 
 Caroushell is an interactive terminal carousel that suggests commands from your
-history, AI prompts, and configuration snippets so you can pick the next shell
-command without leaving the keyboard.
+history, and AI suggestions as you type.
 
 ## Features
 
-- Dual-pane carousel that combines history-based and AI-generated command
-  suggestions.
-- Runs the selected command directly in your current terminal session.
+- The top panel of the carousel shows history
+- The bottom panel of the carousel shows AI-generated command suggestions.
+- Go up and down the carousel with arrow keys.
+- Press `Enter` to run the highlighted command.
 - Logs activity under `~/.caroushell/logs` for easy troubleshooting.
 - Extensible config file (`~/.caroushell/config.json`) so you can point the CLI
   at different API keys or settings.
@@ -58,9 +58,9 @@ need to debug AI suggestions or the terminal renderer. Configuration lives at
 
 ```bash
 npm install
-npm run dev        # tsx watch mode
-npm run build      # emits dist/
-npm run test:generate
+npm run dev
+npm run build
+npm run test:generate  # tests ai text generation
 npm publish --dry-run  # verify package contents before publishing
 ```
 

package/dist/app.js

@@ -6,7 +6,7 @@ const keyboard_1 = require("./keyboard");
 const carousel_1 = require("./carousel");
 const history_suggester_1 = require("./history-suggester");
 const ai_suggester_1 = require("./ai-suggester");
-const child_process_1 = require("child_process");
+const spawner_1 = require("./spawner");
 function debounce(fn, ms) {
     // Debounce function to limit the rate at which a function can fire
     let t = null;
@@ -41,10 +41,30 @@ class App {
             await this.carousel.updateSuggestions();
         }, 300);
         const handlers = {
-            "ctrl-c": () => this.exit(),
+            "ctrl-c": () => {
+                if (this.carousel.isPromptRowSelected() &&
+                    !this.carousel.hasInput()) {
+                    this.exit();
+                    return;
+                }
+                this.carousel.clearInput();
+                this.render();
+                updateSuggestions();
+            },
             "ctrl-d": () => {
-                if (this.carousel.getCurrentRow().length === 0)
+                if (this.carousel.isPromptRowSelected() &&
+                    !this.carousel.hasInput()) {
                     this.exit();
+                    return;
+                }
+                this.carousel.deleteAtCursor();
+                this.render();
+                updateSuggestions();
+            },
+            "ctrl-u": () => {
+                this.carousel.deleteToLineStart();
+                this.render();
+                updateSuggestions();
             },
             backspace: () => {
                 this.carousel.deleteBeforeCursor();
@@ -83,9 +103,19 @@ class App {
                 this.carousel.moveCursorRight();
                 this.render();
             },
-            home: () => { },
-            end: () => { },
-            delete: () => { },
+            home: () => {
+                this.carousel.moveCursorHome();
+                this.render();
+            },
+            end: () => {
+                this.carousel.moveCursorEnd();
+                this.render();
+            },
+            delete: () => {
+                this.carousel.deleteAtCursor();
+                this.render();
+                updateSuggestions();
+            },
             escape: () => { },
         };
         this.keyboard.on("key", async (evt) => {
@@ -117,16 +147,7 @@ class App {
         // Ensure command output starts on the next line
         this.terminal.write("\n");
         await this.history.add(cmd);
-        // Spawn shell
-        const isWin = process.platform === "win32";
-        const proc = (0, child_process_1.spawn)(isWin ? "cmd.exe" : "/bin/bash", [isWin ? "/c" : "-lc", cmd], {
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        await new Promise((resolve) => {
-            proc.stdout.on("data", (d) => process.stdout.write(d));
-            proc.stderr.on("data", (d) => process.stderr.write(d));
-            proc.on("close", () => resolve());
-        });
+        await (0, spawner_1.runUserCommand)(cmd);
         // After arbitrary output, reset render block tracking
         this.terminal.resetBlockTracking();
     }

package/dist/carousel.js

@@ -80,6 +80,10 @@ class Carousel {
                 prefix = "> ";
             }
         }
+        if (rowIndex !== 0 && !rowStr) {
+            // The edge of the top or bottom panel
+            prefix = "---";
+        }
         return `${color}${prefix}${rowStr}${reset}`;
     }
     getCurrentRow() {
@@ -129,6 +133,40 @@ class Carousel {
             return;
         this.inputCursor += 1;
     }
+    moveCursorHome() {
+        this.adoptSelectionIntoInput();
+        this.inputCursor = 0;
+    }
+    moveCursorEnd() {
+        this.adoptSelectionIntoInput();
+        this.inputCursor = this.inputBuffer.length;
+    }
+    deleteAtCursor() {
+        this.adoptSelectionIntoInput();
+        if (this.inputCursor >= this.inputBuffer.length)
+            return;
+        const before = this.inputBuffer.slice(0, this.inputCursor);
+        const after = this.inputBuffer.slice(this.inputCursor + 1);
+        this.inputBuffer = `${before}${after}`;
+    }
+    deleteToLineStart() {
+        this.adoptSelectionIntoInput();
+        if (this.inputCursor === 0)
+            return;
+        const after = this.inputBuffer.slice(this.inputCursor);
+        this.setInputBuffer(after, 0);
+    }
+    clearInput() {
+        this.adoptSelectionIntoInput();
+        this.setInputBuffer("", 0);
+        this.index = 0;
+    }
+    hasInput() {
+        return this.inputBuffer.length > 0;
+    }
+    isPromptRowSelected() {
+        return this.index === 0;
+    }
     getPromptCursorColumn() {
         const prefix = this.getPrefixByIndex(0);
         return prefix.length + this.inputCursor;

package/dist/keyboard.js

@@ -7,6 +7,7 @@ const KEYMAP = {
     // Control keys
     '\u0003': { name: 'ctrl-c', ctrl: true }, // ^C
     '\u0004': { name: 'ctrl-d', ctrl: true }, // ^D
+    '\u0015': { name: 'ctrl-u', ctrl: true }, // ^U
     '\r': { name: 'enter' },
     '\n': { name: 'enter' },
     '\u007f': { name: 'backspace' }, // DEL

package/dist/spawner.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUserCommand = runUserCommand;
+const child_process_1 = require("child_process");
+const process_1 = require("process");
+const isWin = process.platform === "win32";
+const shellBinary = isWin ? "cmd.exe" : "/bin/bash";
+const shellArgs = isWin ? ["/c"] : ["-lc"];
+const builtInCommands = {
+    cd: async (args) => {
+        if (args.length === 1) {
+            process.stdout.write(process.cwd() + "\n");
+            return;
+        }
+        const dest = expandVars(args[1]);
+        try {
+            process.chdir(dest);
+        }
+        catch (err) {
+            process.stderr.write(`cd: ${err.message}\n`);
+        }
+    },
+    exit: async () => {
+        (0, process_1.exit)(0);
+    },
+};
+function expandVars(input) {
+    let out = input;
+    if (isWin) {
+        // cmd-style %VAR% expansion
+        out = out.replace(/%([^%]+)%/g, (_m, name) => {
+            const v = process.env[String(name)];
+            return v !== undefined ? v : "";
+        });
+    }
+    else {
+        // POSIX-style $VAR and ${VAR} expansion
+        out = out.replace(/\$(\w+)|\${(\w+)}/g, (_m, a, b) => {
+            const name = a || b;
+            const v = process.env[name];
+            return v !== undefined ? v : "";
+        });
+    }
+    return out;
+}
+async function runUserCommand(command) {
+    const trimmed = command.trim();
+    if (!trimmed)
+        return;
+    const args = command.split(/\s+/);
+    if (typeof args[0] === "string" && builtInCommands[args[0]]) {
+        await builtInCommands[args[0]](args);
+        return;
+    }
+    const proc = (0, child_process_1.spawn)(shellBinary, [...shellArgs, command], {
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: true,
+    });
+    await new Promise((resolve, reject) => {
+        proc.stdout.on("data", (data) => process.stdout.write(data));
+        proc.stderr.on("data", (data) => process.stderr.write(data));
+        proc.on("error", reject);
+        proc.on("close", () => resolve());
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caroushell",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Terminal carousel that suggests commands from history, config, and AI.",
   "type": "commonjs",
   "main": "dist/main.js",
@@ -40,6 +40,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.10.0",
+    "@types/shell-quote": "^1.7.5",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3"
   }