@napisani/scute 0.0.6 → 0.0.7

package/README.md

@@ -139,15 +139,32 @@ Notes:
 - `dotenv/config` is loaded at startup, so values in `.env` will be respected.
 - Provider env vars (e.g., `OPENAI_API_KEY`) merge into `providers` and override matching entries.
 
+### Prompt defaults
+
+Use `promptDefaults` to set shared values for all prompts. Any field omitted on a prompt inherits the value from `promptDefaults`. You can still override individual prompts under `prompts`, including `output` via `prompts.<name>.output`.
+
+### Output channels
+
+Output channels control how scute emits results when `--output` is not provided.
+
+- `clipboard`: writes the result to the system clipboard using `clipboardCommand` (or auto-detected clipboard tool). Falls back to stdout if no clipboard command is found.
+- `stdout`: prints the result to stdout with a trailing newline.
+- `prompt`: renders the result at the bottom of the terminal without altering your current input line.
+- `readline`: replaces the current input line (bash/zsh integration).
+
+`--output <channel>` always overrides the config for a single invocation.
+
 ### Minimal config example
 
 ```yaml
 # ~/.config/scute/config.yaml
 
 # Use a compact view for the token editor
+# viewMode values: horizontal | vertical
 viewMode: horizontal
 
 # Define at least one provider for prompts
+# provider name values: openai | anthropic | gemini | ollama
 providers:
   - name: openai
     apiKey: ${OPENAI_API_KEY}
@@ -165,12 +182,14 @@ shellKeybindings:
 # ~/.config/scute/config.yaml
 
 # Layout for the interactive token editor
+# viewMode values: horizontal | vertical
 viewMode: horizontal # horizontal -> annotated view, vertical -> list view
 
 # Clipboard command for output channel "clipboard"
 clipboardCommand: "pbcopy"
 
 # Providers used by prompts (env vars override these)
+# provider name values: openai | anthropic | gemini | ollama
 providers:
   - name: openai
     apiKey: ${OPENAI_API_KEY}
@@ -223,30 +242,31 @@ theme:
   tokenDescription: "#CDD6F4"
   markerColor: "#CDD6F4"
 
+# Prompt defaults (apply to all prompts unless overridden)
+promptDefaults:
+  # provider values: openai | anthropic | gemini | ollama
+  provider: openai
+  model: gpt-4
+  temperature: 0.7
+  maxTokens: 128000
+  userPrompt: ""
+  systemPromptOverride: ""
+  # output values: clipboard | stdout | prompt | readline
+  output: readline
+
 # Prompt behavior per command
 prompts:
   explain:
-    provider: openai
-    model: gpt-4
-    temperature: 0.7
-    maxTokens: 128000
-    userPrompt: ""
-    systemPromptOverride: ""
+    # output values: clipboard | stdout | prompt | readline
+    output: prompt
   suggest:
-    provider: openai
-    model: gpt-4
-    temperature: 0.7
-    maxTokens: 128000
+    # output values: clipboard | stdout | prompt | readline
+    output: readline
   generate:
-    provider: openai
-    model: gpt-4
-    temperature: 0.7
-    maxTokens: 128000
+    # output values: clipboard | stdout | prompt | readline
+    output: readline
   describeTokens:
-    provider: openai
-    model: gpt-4
-    temperature: 0.7
-    maxTokens: 128000
+    # Internal prompt used by the token editor
 ```
 
 ### Environment variables
@@ -317,17 +337,128 @@ The command prints a JSON payload containing the merged configuration and releva
 
 ## Testing
 
-Test files use the `.test.ts` suffix. Evaluation tests use `.eval.test.ts` and live in the `evals/` directory.
+Scute uses three complementary testing strategies:
+
+1. **Unit Tests** — Fast, deterministic tests for core logic
+2. **Eval Tests** — AI-powered evaluations that validate LLM output quality
+3. **PTY E2E Tests** — End-to-end shell integration tests in real terminals
+
+### Unit Tests
+
+Unit tests use Bun's built-in test runner and live in the `tests/` directory. They cover core logic, utilities, and component behavior without external dependencies.
 
 ```sh
-# Run standard unit tests
-bun run test
+# Run all unit tests
+make test-unit
 
-# Run evaluation tests
-bun run evals
+# Run with coverage
+make test-coverage
+
+# Run a specific test file
+bun test tests/core/output.test.ts
+```
+
+**Key unit test areas:**
+
+| File | Tests |
+|------|-------|
+| `tests/core/output.test.ts` | Output channel routing (stdout, clipboard, prompt, readline) |
+| `tests/shells.test.ts` | Shell integration (bash/zsh/sh keybindings) |
+| `tests/build-command.test.ts` | Build command argument resolution |
+| `tests/config-overlay.test.ts` | Configuration merging and precedence |
+| `tests/hooks/useVimMode.test.ts` | TUI vim navigation and editing |
+
+### Eval Tests
+
+Eval tests use the `.eval.test.ts` suffix and live in the `evals/` directory. These tests make real LLM calls and validate that the AI produces sensible output for specific tasks.
+
+```sh
+# Run all eval tests
+make test-evals
+
+# Run a specific eval
+bun test evals/suggest-command.eval.test.ts
+```
+
+**Available evals:**
+
+| File | Validates |
+|------|-----------|
+| `evals/suggest-command.eval.test.ts` | Suggest produces valid shell commands |
+| `evals/explain-command.eval.test.ts` | Explain produces helpful explanations |
+| `evals/ai-connectivity.eval.test.ts` | Provider connectivity and API responses |
+| `evals/fetch-token-descriptions.eval.test.ts` | Token description fetching |
+
+> **Note:** Eval tests require valid provider credentials (e.g., `OPENAI_API_KEY`) and make real API calls.
+
+### PTY E2E Tests
+
+PTY tests open a real pseudo-terminal, spawn a clean shell, initialize scute, and run scripted scenarios. These validate the full integration: shell keybindings, output channels, and TUI behavior in an actual terminal environment.
+
+**Prerequisites:**
+- `python3`
+- `bun` (for `./bin/scute`)
+- Provider credentials (e.g., `OPENAI_API_KEY`)
+
+**Configuration:**
+- Default config: `configs/agent-pty.yml` (uses OpenAI GPT-4o-mini, writes clipboard to `/tmp/scute-clipboard.txt`)
+- Override with `--config <path>`
+
+**Running scenarios:**
+
+```sh
+# Run ALL scenarios and get a pass/fail summary
+make test-pty
+
+# Run a single scenario by name
+make test-pty-one SCENARIO=suggest-stdout
+make test-pty-one SCENARIO=explain-stdout
+make test-pty-one SCENARIO=clipboard-file
+
+# Or run directly with extra options
+scripts/agent/run-one suggest-stdout --shell zsh
+scripts/agent/run-all --config configs/openai-config.yml --quiet
+```
+
+**Available scenarios:**
+
+| Scenario | Tests |
+|----------|-------|
+| `suggest-stdout` | `scute suggest` via CLI with stdout output |
+| `suggest-readline` | Alt+G keybinding replaces readline buffer |
+| `explain-stdout` | `scute explain` via CLI with stdout output |
+| `explain-keybinding` | Ctrl+E keybinding shows prompt hint |
+| `build-stdout` | TUI opens, submit with Enter |
+| `generate-stdout` | `scute generate` via CLI with stdout output |
+| `clipboard-file` | Clipboard output writes to file |
+
+**Logs:** Each scenario writes a log to `/tmp/scute-pty-<scenario>.log` for debugging.
+
+**Scenario step types:** Each scenario is a JSON file with steps like:
+
+```json
+{
+  "prompt": "scute-test$ ",
+  "steps": [
+    {"send_line": "export PS1=\"scute-test$ \""},
+    {"wait_for_prompt": true},
+    {"send_line": "scute suggest \"git sta\" --output stdout"},
+    {"wait_for_prompt": true, "timeout": 15},
+    {"assert_output_contains": "git"}
+  ]
+}
+```
+
+Available steps: `send_line`, `send_text`, `send_keys`, `sleep`, `wait_for_prompt`, `wait_for_text`, `assert_output_contains`, `assert_file_exists`, `assert_file_contains`, `clear_buffer`, `drain`, `delete_file`.
+
+**Agent prompt templates:**
+
+```text
+Run scripts/agent/run-one suggest-stdout. If it fails, read /tmp/scute-pty-suggest-stdout.log (last 120 lines) and diagnose the issue.
+```
 
-# Or via Make targets
-make test
+```text
+Run scripts/agent/run-all and report the pass/fail summary. For any failures, include the last 120 lines of the corresponding log file.
 ```
 
 ## Usage

package/package.json

@@ -1,86 +1,89 @@
 {
-  "name": "@napisani/scute",
-  "version": "0.0.6",
-  "description": "AI-powered shell assistant",
-  "module": "index.ts",
-  "type": "module",
-  "keywords": [
-    "shell",
-    "ai",
-    "explain",
-    "bash",
-    "zsh",
-    "suggestion",
-    "tui"
-  ],
-  "homepage": "https://github.com/napisani/scute",
-  "bugs": {
-    "url": "https://github.com/napisani/scute/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/napisani/scute.git"
-  },
-  "license": "MIT",
-  "author": "Nick Pisani",
-  "main": "src/index.ts",
-  "bin": {
-    "scute": "bin/scute"
-  },
-  "directories": {
-    "test": "tests"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "bun run build:bin",
-    "build:bin": "bun build ./src/index.ts --compile --outfile dist/scute",
-    "clean": "rm -rf dist",
-    "lint": "bunx tsc --noEmit",
-    "test": "bun test tests/",
-    "coverage": "bun test tests/ --coverage",
-    "evals": "bun test evals --pattern \\\"\\.eval\\.test\\.ts$\\\"",
-    "prepublishOnly": "bun run lint && bun run test"
-  },
-  "dependencies": {
-    "@opentui/core": "^0.1.75",
-    "@opentui/react": "^0.1.75",
-    "@tanstack/ai": "^0.2.2",
-    "@tanstack/ai-anthropic": "^0.2.0",
-    "@tanstack/ai-gemini": "^0.3.2",
-    "@tanstack/ai-ollama": "^0.3.0",
-    "@tanstack/ai-openai": "^0.2.1",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "dotenv": "^17.2.3",
-    "js-yaml": "^4.1.1",
-    "react": "^19.2.4",
-    "shell-quote": "^1.8.3"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.3.12",
-    "@testing-library/react": "^16.3.2",
-    "@types/bun": "latest",
-    "@types/js-yaml": "^4.0.9",
-    "@types/jsdom": "^27.0.0",
-    "@types/node": "^25.0.10",
-    "@types/react": "^19.2.9",
-    "@types/shell-quote": "^1.7.5",
-    "happy-dom": "^20.5.0",
-    "jsdom": "^28.0.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  },
-  "os": [
-    "darwin",
-    "linux"
-  ]
+	"name": "@napisani/scute",
+	"version": "0.0.7",
+	"description": "AI-powered shell assistant",
+	"module": "index.ts",
+	"type": "module",
+	"keywords": [
+		"shell",
+		"ai",
+		"explain",
+		"bash",
+		"zsh",
+		"suggestion",
+		"tui"
+	],
+	"homepage": "https://github.com/napisani/scute",
+	"bugs": {
+		"url": "https://github.com/napisani/scute/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/napisani/scute.git"
+	},
+	"license": "MIT",
+	"author": "Nick Pisani",
+	"main": "src/index.ts",
+	"bin": {
+		"scute": "bin/scute"
+	},
+	"directories": {
+		"test": "tests"
+	},
+	"files": [
+		"bin/",
+		"src/",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "bun run build:bin",
+		"build:bin": "bun build ./src/index.ts --compile --outfile dist/scute",
+		"clean": "rm -rf dist",
+		"lint": "bunx tsc --noEmit",
+		"test": "bun test tests/",
+		"test:coverage": "bun test tests/ --coverage",
+		"test:unit": "bun test tests/",
+		"test:evals": "bun test evals --pattern \\\"\\.eval\\.test\\.ts$\\\"",
+		"test:pty": "python3 scripts/agent/run-all",
+		"test:pty:one": "python3 scripts/agent/run-one",
+		"prepublishOnly": "bun run lint && bun run test"
+	},
+	"dependencies": {
+		"@opentui/core": "^0.1.75",
+		"@opentui/react": "^0.1.75",
+		"@tanstack/ai": "^0.2.2",
+		"@tanstack/ai-anthropic": "^0.2.0",
+		"@tanstack/ai-gemini": "^0.3.2",
+		"@tanstack/ai-ollama": "^0.3.0",
+		"@tanstack/ai-openai": "^0.2.1",
+		"chalk": "^5.6.2",
+		"commander": "^14.0.2",
+		"dotenv": "^17.2.3",
+		"js-yaml": "^4.1.1",
+		"react": "^19.2.4",
+		"shell-quote": "^1.8.3"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.12",
+		"@testing-library/react": "^16.3.2",
+		"@types/bun": "latest",
+		"@types/js-yaml": "^4.0.9",
+		"@types/jsdom": "^27.0.0",
+		"@types/node": "^25.0.10",
+		"@types/react": "^19.2.9",
+		"@types/shell-quote": "^1.7.5",
+		"happy-dom": "^20.5.0",
+		"jsdom": "^28.0.0"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"engines": {
+		"bun": ">=1.0.0"
+	},
+	"os": [
+		"darwin",
+		"linux"
+	]
 }

package/src/config/index.ts

@@ -5,8 +5,14 @@ import path from "node:path";
 import yaml from "js-yaml";
 import { SUPPORTED_PROVIDERS } from "../core/constants";
 import { getEnv, resetEnvGetter, setEnvGetter } from "../core/environment";
+import type { OutputChannel } from "../core/output";
 import type { TokenType } from "../core/shells/common";
-import type { PromptName, ShellKeybindingAction, ThemeConfig } from "./schema";
+import type {
+	PromptName,
+	PromptOverridesConfig,
+	ShellKeybindingAction,
+	ThemeConfig,
+} from "./schema";
 import { type Config, ConfigSchema, ShellKeybindingActions } from "./schema";
 
 const CONFIG_DIR = path.join(os.homedir(), ".config", "scute");
@@ -189,7 +195,13 @@ export function getThemeColorFor(attr: ThemeColorAttribute): string {
 }
 
 export function getPromptConfig(name: PromptName) {
-	return { ...config.prompts[name] };
+	const defaults = config.promptDefaults;
+	const overrides = config.prompts[name] as PromptOverridesConfig;
+	return { ...defaults, ...overrides };
+}
+
+export function getPromptOutput(name: PromptName): OutputChannel | undefined {
+	return getPromptConfig(name).output as OutputChannel | undefined;
 }
 
 export function getShellKeybindings(): Record<ShellKeybindingAction, string[]> {

package/src/config/schema.ts

@@ -38,16 +38,39 @@ export const ProviderSchema = z.object({
 
 export type ProviderConfig = z.infer<typeof ProviderSchema>;
 
-export const PromptConfigSchema = z.object({
-	provider: z.string().default(resolvedDefaultProvider),
+const OutputChannelSchema = z.enum([
+	"clipboard",
+	"stdout",
+	"prompt",
+	"readline",
+]);
+export type OutputChannelConfig = z.infer<typeof OutputChannelSchema>;
+
+export const PromptDefaultsSchema = z.object({
+	provider: z.enum(SUPPORTED_PROVIDERS).default(resolvedDefaultProvider),
 	model: z.string().default(resolvedDefaultModel),
 	temperature: z.number().default(DEFAULT_TEMPERATURE),
 	maxTokens: z.number().default(DEFAULT_MAX_TOKENS),
 	userPrompt: z.string().optional(),
 	systemPromptOverride: z.string().optional(),
+	output: OutputChannelSchema.optional(),
 });
 
-export type PromptConfig = z.infer<typeof PromptConfigSchema>;
+export const PromptOverridesSchema = z
+	.object({
+		provider: z.enum(SUPPORTED_PROVIDERS).optional(),
+		model: z.string().optional(),
+		temperature: z.number().optional(),
+		maxTokens: z.number().optional(),
+		userPrompt: z.string().optional(),
+		systemPromptOverride: z.string().optional(),
+		output: OutputChannelSchema.optional(),
+	})
+	.default({});
+
+export type PromptDefaultsConfig = z.infer<typeof PromptDefaultsSchema>;
+export type PromptOverridesConfig = z.infer<typeof PromptOverridesSchema>;
+export type PromptConfig = PromptDefaultsConfig;
 
 export const KeybindingsSchema = z
 	.object({
@@ -148,7 +171,7 @@ export const ShellKeybindingActions = [
 ] as const;
 export type ShellKeybindingAction = (typeof ShellKeybindingActions)[number];
 
-function buildDefaultPromptConfig() {
+function buildDefaultPromptDefaults() {
 	return {
 		provider: resolvedDefaultProvider,
 		model: resolvedDefaultModel,
@@ -183,18 +206,19 @@ export const ConfigSchema = z.object({
 			build: "Ctrl+G",
 			suggest: "Alt+G",
 		}),
+	promptDefaults: PromptDefaultsSchema.default(buildDefaultPromptDefaults()),
 	prompts: z
 		.object({
-			explain: PromptConfigSchema.default(buildDefaultPromptConfig()),
-			suggest: PromptConfigSchema.default(buildDefaultPromptConfig()),
-			generate: PromptConfigSchema.default(buildDefaultPromptConfig()),
-			describeTokens: PromptConfigSchema.default(buildDefaultPromptConfig()),
+			explain: PromptOverridesSchema.default({}),
+			suggest: PromptOverridesSchema.default({}),
+			generate: PromptOverridesSchema.default({}),
+			describeTokens: PromptOverridesSchema.default({}),
 		})
 		.default({
-			explain: buildDefaultPromptConfig(),
-			suggest: buildDefaultPromptConfig(),
-			generate: buildDefaultPromptConfig(),
-			describeTokens: buildDefaultPromptConfig(),
+			explain: {},
+			suggest: {},
+			generate: {},
+			describeTokens: {},
 		}),
 });
 export type PromptName = keyof z.infer<typeof ConfigSchema>["prompts"];

package/src/core/command-output.ts

@@ -0,0 +1,119 @@
+function stripAnsiSequences(text: string): string {
+	let output = "";
+	for (let i = 0; i < text.length; i += 1) {
+		const char = text[i];
+		if (char !== "\u001b") {
+			output += char;
+			continue;
+		}
+		const next = text[i + 1];
+		if (next === "[") {
+			i += 1;
+			while (i + 1 < text.length) {
+				i += 1;
+				const code = text.charCodeAt(i);
+				if ((code >= 65 && code <= 90) || (code >= 97 && code <= 122)) {
+					break;
+				}
+			}
+			continue;
+		}
+		if (next === "]") {
+			i += 1;
+			while (i + 1 < text.length) {
+				i += 1;
+				if (text.charCodeAt(i) === 7) {
+					break;
+				}
+			}
+		}
+	}
+	return output;
+}
+
+function stripControlCharacters(text: string): string {
+	const normalized = text.replace(/\r\n?/g, "\n");
+	let output = "";
+	for (let i = 0; i < normalized.length; i += 1) {
+		const code = normalized.charCodeAt(i);
+		if (
+			(code >= 0 && code <= 8) ||
+			code === 11 ||
+			code === 12 ||
+			(code >= 14 && code <= 31) ||
+			code === 127
+		) {
+			continue;
+		}
+		output += normalized[i];
+	}
+	return output;
+}
+
+function extractFencedContent(text: string): string {
+	const fenceMatch = text.match(/```[a-zA-Z0-9_-]*\n([\s\S]*?)```/);
+	if (fenceMatch?.[1]) {
+		return fenceMatch[1];
+	}
+	return text;
+}
+
+function stripLinePrefix(line: string): string {
+	const trimmed = line.trim();
+	const labelMatch = trimmed.match(
+		/^(command|cmd|suggestion|answer)\s*:\s*(.*)$/i,
+	);
+	if (labelMatch?.[2]) {
+		return labelMatch[2].trim();
+	}
+	if (trimmed.startsWith("$ ") || trimmed.startsWith("> ")) {
+		return trimmed.slice(2).trimStart();
+	}
+	if (trimmed.startsWith("# ")) {
+		return trimmed.slice(2).trimStart();
+	}
+	return trimmed;
+}
+
+function isLabelLine(line: string): boolean {
+	return /:$/.test(line.trim());
+}
+
+function stripWrappingBackticks(line: string): string {
+	const trimmed = line.trim();
+	if (/^`[^`]+`$/.test(trimmed)) {
+		return trimmed.slice(1, -1).trim();
+	}
+	return trimmed;
+}
+
+function pickCommandLine(lines: string[]): string {
+	for (let i = 0; i < lines.length; i += 1) {
+		const line = lines[i];
+		if (!line) continue;
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		if (trimmed.startsWith("```")) continue;
+		if (isLabelLine(trimmed)) continue;
+		const normalized = stripWrappingBackticks(stripLinePrefix(trimmed));
+		if (normalized) {
+			return normalized;
+		}
+	}
+	return "";
+}
+
+function normalizeCommandLine(line: string): string {
+	return line.replace(/\t/g, " ").trim();
+}
+
+export function sanitizeCommandOutput(text: string): string | null {
+	if (!text) return null;
+	const withoutAnsi = stripAnsiSequences(text);
+	const withoutControl = stripControlCharacters(withoutAnsi);
+	const content = extractFencedContent(withoutControl);
+	const lines = content.split("\n");
+	const picked = pickCommandLine(lines);
+	const normalized = normalizeCommandLine(picked);
+	return normalized.length ? normalized : null;
+}

package/src/core/llm.ts

@@ -10,6 +10,7 @@ import {
 	getProviderBaseUrl,
 } from "../config";
 import type { PromptName } from "../config/schema";
+import { sanitizeCommandOutput } from "./command-output";
 import { buildCommandContext } from "./llm-context";
 import { logDebug } from "./logger";
 import { buildManPageContext, type ManPage } from "./manpage";
@@ -172,8 +173,7 @@ export async function suggest(commandLine: string): Promise<string | null> {
 			userPrompt,
 			getSuggestSystemPrompt(),
 		);
-		const suggestion = extractFirstLine(raw);
-		return suggestion.length ? suggestion : raw.trim() || null;
+		return sanitizeCommandOutput(raw);
 	} catch (error) {
 		logDebug("suggest:error", error);
 		return null;
@@ -238,8 +238,7 @@ export async function generateCommand(prompt: string): Promise<string | null> {
 			trimmed,
 			getGenerateSystemPrompt(),
 		);
-		const suggestion = extractFirstLine(raw);
-		return suggestion.length ? suggestion : raw.trim() || null;
+		return sanitizeCommandOutput(raw);
 	} catch (error) {
 		logDebug("generate:error", error);
 		return null;

package/src/core/prompts.ts

@@ -15,11 +15,11 @@ You will be provided with a JSON payload containing:
 - "input": the partial ${shell} command the user has typed (may include inline comments that describe intent)
 - "tokens": an array of parsed tokens for the current input
 - "context": concise excerpts from relevant man pages and documentation
-Your job is to produce the single best complete ${shell} command that satisfies the described intent.
-- You may replace or reorder the tokens as needed; do not merely append text.
-- Honor any intent described in comments or obvious from the tokens.
-- Return exactly one command line with no trailing commentary, explanations, or markdown.
-- Do not include surrounding quotes, code fences, or additional notes.
+ Your job is to produce the single best complete ${shell} command that satisfies the described intent.
+ - You may replace or reorder the tokens as needed; do not merely append text.
+ - Honor any intent described in comments or obvious from the tokens.
+ - Return exactly one command line with no trailing commentary, explanations, or markdown.
+ - Do not include surrounding quotes, code fences, prompt characters (like "$"), or additional notes.
 `;
 }
 export function getExplainSystemPrompt(): string {
@@ -42,9 +42,9 @@ export function getGenerateSystemPrompt(): string {
 	return `
 ${getRoleVerbiage()}
 You will be provided with a natural language prompt describing a task. 
-Your task is to generate the single, most likely ${shell} command that achieves the user's goal. 
-The shell command can be multiple commands combined with pipes, conditionals, or other shell operators as needed, but it must be a single line.
-ONLY return the command itself, with no additional explanation or formatting.
+ Your task is to generate the single, most likely ${shell} command that achieves the user's goal. 
+ The shell command can be multiple commands combined with pipes, conditionals, or other shell operators as needed, but it must be a single line.
+ ONLY return the command itself, with no additional explanation or formatting (no prompt characters like "$" or "> ").
 `;
 }
 

package/src/core/shells/bash.ts

@@ -121,6 +121,10 @@ export const bashShellHelper: ShellHelper = {
 		// Bash uses READLINE_LINE for the current input line
 		// Use ANSI sequences to clear the current line and replace it
 		const normalizedText = normalizeReadlineText(text);
+		if (!process.stdout.isTTY) {
+			process.stdout.write(normalizedText);
+			return;
+		}
 		const clearLine = "\x1b[2K"; // Clear entire line
 		const carriageReturn = "\r"; // Move cursor to beginning of line
 		process.stdout.write(`${carriageReturn}${clearLine}${normalizedText}`);

package/src/core/shells/sh.ts

@@ -108,6 +108,10 @@ export const shShellHelper: ShellHelper = {
 		// Standard sh uses READLINE_LINE (when readline is available)
 		// Use ANSI sequences to clear the current line and replace it
 		const normalizedText = normalizeReadlineText(text);
+		if (!process.stdout.isTTY) {
+			process.stdout.write(normalizedText);
+			return;
+		}
 		const clearLine = "\x1b[2K"; // Clear entire line
 		const carriageReturn = "\r"; // Move cursor to beginning of line
 		process.stdout.write(`${carriageReturn}${clearLine}${normalizedText}`);

package/src/core/shells/zsh.ts

@@ -126,6 +126,10 @@ export const zshShellHelper: ShellHelper = {
 		// Zsh uses BUFFER for the current input line
 		// Use ANSI sequences to clear the current line and replace it
 		const normalizedText = normalizeReadlineText(text);
+		if (!process.stdout.isTTY) {
+			process.stdout.write(normalizedText);
+			return;
+		}
 		const clearLine = "\x1b[2K"; // Clear entire line
 		const carriageReturn = "\r"; // Move cursor to beginning of line
 		process.stdout.write(`${carriageReturn}${clearLine}${normalizedText}`);

package/src/index.ts

@@ -8,7 +8,11 @@ import { explain } from "./commands/explain";
 import { generate } from "./commands/generate";
 import { init } from "./commands/init";
 import { suggest } from "./commands/suggest";
-import { loadConfigFromPath, setConfigOverride } from "./config";
+import {
+	getPromptOutput,
+	loadConfigFromPath,
+	setConfigOverride,
+} from "./config";
 import type { OutputChannel } from "./core/output";
 
 const program = new Command();
@@ -42,6 +46,18 @@ function resolveOutputChannel(
 		}
 		return requested as OutputChannel;
 	}
+	if (
+		commandName === "suggest" ||
+		commandName === "explain" ||
+		commandName === "generate"
+	) {
+		const promptOutput = getPromptOutput(
+			commandName as "suggest" | "explain" | "generate",
+		);
+		if (promptOutput) {
+			return promptOutput;
+		}
+	}
 	if (commandName === "suggest") return "readline";
 	if (commandName === "explain") return "prompt";
 	if (commandName === "build") return "readline";