@koush/chatsh 1.0.11 → 1.0.13

package/README.md

@@ -0,0 +1,84 @@
+# @koush/chatsh
+
+A terminal-based shell assistant that connects your shell session to an LLM for context-aware help.
+
+## Quick Start
+
+```bash
+$ npx @koush/chatsh
+$ ls /nonexistent
+ls: /nonexistent: No such file or directory
+
+$ help why did this command fail
+
+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.
+
+```
+
+The LLM sees your entire terminal transcript and provides context-aware assistance.
+
+## Configuration
+
+Create `~/.chatsh/chatsh.jsonc`:
+
+```jsonc
+// OpenAI
+{
+  "provider": "openai",
+  "model": "gpt-4-turbo",
+  "options": {
+    "apiKey": "sk-..."  // or set OPENAI_API_KEY env var
+  }
+}
+
+// Anthropic (Claude)
+{
+  "provider": "anthropic",
+  "model": "claude-sonnet-4-5",
+  "options": {
+    "apiKey": "sk-ant-..."  // or set ANTHROPIC_API_KEY env var
+  }
+}
+
+// Google (Gemini)
+{
+  "provider": "google",
+  "model": "gemini-2.5-flash",
+  "options": {
+    "apiKey": "..."  // or set GOOGLE_GENERATIVE_AI_API_KEY env var
+  }
+}
+
+// OpenAI-Compatible (Custom Endpoint)
+{
+  "provider": "openai-compatible",
+  "model": "your-model-name",
+  "options": {
+    "name": "custom",
+    "baseURL": "http://localhost:8000/v1",
+    "apiKey": "your-api-key"
+  }
+}
+```
+
+## Features
+
+- 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
+
+1. Spawns an interactive shell in a pseudo-terminal (PTY)
+2. Starts a local HTTP server on a random port
+3. Tracks all terminal output in a transcript
+4. The `help` command sends the transcript + your question to an LLM
+5. LLM response streams back to your terminal
+
+## License
+
+ISC

package/dist/main.js

@@ -4,13 +4,15 @@ 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 CONFIG_PATH = join(homedir(), '.llmsh', 'llmsh.jsonc');
+const __filename = fileURLToPath(import.meta.url);
+const CONFIG_PATH = join(homedir(), '.chatsh', 'chatsh.jsonc');
 function loadConfig() {
     if (!existsSync(CONFIG_PATH)) {
         return null;
@@ -34,7 +36,7 @@ function loadConfig() {
 function showConfigHelp() {
     console.error(`Error: No valid config found at ${CONFIG_PATH}
 
-Create a config file at ~/.llmsh/llmsh.jsonc with one of the following formats:
+Create a config file at ~/.chatsh/chatsh.jsonc with one of the following formats:
 
 // OpenAI
 {
@@ -180,7 +182,13 @@ async function main() {
         cols: process.stdout.columns || 80,
         rows: process.stdout.rows || 24,
         cwd: process.cwd(),
-        env: { ...process.env, LLMSH_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:$LLMSH_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.11",
+  "version": "1.0.13",
   "type": "module",
   "main": "dist/main.js",
   "bin": {