@koush/chatsh 1.0.10 → 1.0.12

package/README.md

@@ -0,0 +1,103 @@
+# @koush/chatsh
+
+A terminal-based shell assistant that connects your shell session to an LLM for context-aware help.
+
+## What it does
+
+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
+
+- **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
+
+## Installation
+
+```bash
+npm install -g @koush/chatsh
+```
+
+Or run directly with:
+
+```bash
+npx @koush/chatsh
+```
+
+## 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"
+  }
+}
+```
+
+## Usage
+
+Start chatsh:
+
+```bash
+chatsh
+```
+
+Use your shell normally. When you need help:
+
+```bash
+$ help what does this error mean?
+$ help how do I grep recursively?
+```
+
+## 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

@@ -10,7 +10,7 @@ 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 CONFIG_PATH = join(homedir(), '.chatsh', 'chatsh.jsonc');
 function loadConfig() {
     if (!existsSync(CONFIG_PATH)) {
         return null;
@@ -34,7 +34,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
 {
@@ -174,17 +174,18 @@ async function main() {
     await once(server, 'listening');
     const address = server.address();
     const port = address && typeof address === 'object' ? address.port : 0;
-    const ptyProcess = spawn('zsh', [], {
+    const shell = process.env.SHELL || '/bin/zsh';
+    const ptyProcess = spawn(shell, ['-i'], {
         name: process.env.TERM || 'xterm',
         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) }
     });
     process.stdin.setRawMode(true);
     process.stdin.resume();
     process.stdin.on('data', (data) => {
-        ptyProcess.write(data.toString());
+        ptyProcess.write(data);
     });
     ptyProcess.onData((data) => {
         const clearSeq = '\x1b[2J';
@@ -199,7 +200,10 @@ async function main() {
         }
         process.stdout.write(data);
     });
-    ptyProcess.write('help() { curl -s -X POST -d "$*" http://localhost:$LLMSH_PORT }\n');
+    ptyProcess.write('help() { curl -s -X POST -d "$*" http://localhost:$CHATSH_PORT }\n');
+    if (shell.includes('zsh')) {
+        ptyProcess.write('bindkey "^R" history-incremental-search-backward\n');
+    }
     ptyProcess.onExit(({ exitCode }) => {
         process.exit(exitCode);
     });

package/package.json

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