@koush/chatsh 1.0.12 → 1.0.13

package/README.md

@@ -2,34 +2,23 @@
 
 A terminal-based shell assistant that connects your shell session to an LLM for context-aware help.
 
-## What it does
+## Quick Start
 
-Chatsh wraps your shell session and maintains a transcript of all terminal activity. Use the `help` command to query an LLM with context about what you're doing.
-
-```
-$ help how do I find large files?
-```
-
-The LLM receives your entire shell transcript and can provide context-aware assistance.
-
-## Features
+```bash
+$ npx @koush/chatsh
+$ ls /nonexistent
+ls: /nonexistent: No such file or directory
 
-- **Shell wrapper** - Wraps zsh/bash/fish in a PTY session
-- **LLM integration** - Multiple provider support (OpenAI, Anthropic, Google, OpenAI-compatible)
-- **Transcript tracking** - Maintains full terminal history
-- **Smart clear detection** - Resets transcript on terminal clear
+$ help why did this command fail
 
-## Installation
+The command failed because the directory /nonexistent does not exist. 
+The ls command lists directory contents, but it cannot find a path 
+that doesn't exist on your filesystem. Try ls without arguments to 
+see your current directory, or use ls / to list the root directory.
 
-```bash
-npm install -g @koush/chatsh
 ```
 
-Or run directly with:
-
-```bash
-npx @koush/chatsh
-```
+The LLM sees your entire terminal transcript and provides context-aware assistance.
 
 ## Configuration
 
@@ -75,20 +64,12 @@ Create `~/.chatsh/chatsh.jsonc`:
 }
 ```
 
-## Usage
-
-Start chatsh:
-
-```bash
-chatsh
-```
-
-Use your shell normally. When you need help:
+## Features
 
-```bash
-$ help what does this error mean?
-$ help how do I grep recursively?
-```
+- Wraps zsh/bash/fish in a PTY session
+- Multiple LLM providers (OpenAI, Anthropic, Google, OpenAI-compatible)
+- Maintains full terminal history
+- Resets transcript on terminal clear
 
 ## How it works
 

package/dist/main.js

@@ -4,12 +4,14 @@ import { once } from 'node:events';
 import { readFileSync, existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import * as jsonc from 'jsonc-parser';
 import { createOpenAI } from '@ai-sdk/openai';
 import { createAnthropic } from '@ai-sdk/anthropic';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
 import { streamText } from 'ai';
+const __filename = fileURLToPath(import.meta.url);
 const CONFIG_PATH = join(homedir(), '.chatsh', 'chatsh.jsonc');
 function loadConfig() {
     if (!existsSync(CONFIG_PATH)) {
@@ -180,7 +182,13 @@ async function main() {
         cols: process.stdout.columns || 80,
         rows: process.stdout.rows || 24,
         cwd: process.cwd(),
-        env: { ...process.env, CHATSH_PORT: String(port) }
+        env: {
+            ...process.env,
+            CHATSH_PORT: String(port),
+            CHATSH_NODE: process.execPath,
+            CHATSH_SCRIPT: __filename,
+            CHATSH_TS: __filename.endsWith('.ts') ? '--experimental-strip-types' : ''
+        }
     });
     process.stdin.setRawMode(true);
     process.stdin.resume();
@@ -200,7 +208,7 @@ async function main() {
         }
         process.stdout.write(data);
     });
-    ptyProcess.write('help() { curl -s -X POST -d "$*" http://localhost:$CHATSH_PORT }\n');
+    ptyProcess.write('help() { "$CHATSH_NODE" --no-warnings $CHATSH_TS "$CHATSH_SCRIPT" --help "$*"; }\n');
     if (shell.includes('zsh')) {
         ptyProcess.write('bindkey "^R" history-incremental-search-backward\n');
     }
@@ -214,4 +222,23 @@ async function main() {
         ptyProcess.resize(process.stdout.columns || 80, process.stdout.rows || 24);
     });
 }
-main();
+// Handle --help flag for shell help command
+if (process.argv[2] === '--help') {
+    const query = process.argv.slice(3).join(' ');
+    const port = process.env.CHATSH_PORT;
+    if (!port) {
+        console.error('CHATSH_PORT not set');
+        process.exit(1);
+    }
+    const response = await fetch(`http://localhost:${port}`, {
+        method: 'POST',
+        body: query
+    });
+    for await (const chunk of response.body) {
+        process.stdout.write(chunk);
+    }
+    process.exit(0);
+}
+else {
+    main();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koush/chatsh",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "type": "module",
   "main": "dist/main.js",
   "bin": {