@hasna/terminal 0.6.1 → 0.7.0

package/dist/cli.js

@@ -2,6 +2,113 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from "ink";
 const args = process.argv.slice(2);
+// ── Help / Version ───────────────────────────────────────────────────────────
+if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    console.log(`open-terminal v0.6.1 — Smart terminal for AI agents and humans
+
+USAGE:
+  terminal                     Launch interactive NL terminal (TUI)
+  terminal <subcommand>        Run a specific command
+
+SUBCOMMANDS:
+  mcp serve                    Start MCP server (stdio transport)
+  mcp install --claude|--codex|--gemini|--all
+                               Install as MCP server for AI agents
+  hook install --claude        Install Claude Code PostToolUse hook
+  hook uninstall               Remove hooks
+  recipe add <name> <cmd>      Save a reusable command recipe
+  recipe list                  List saved recipes
+  recipe run <name> [--var=X]  Run a recipe with variable substitution
+  recipe delete <name>         Delete a recipe
+  collection create <name>     Create a recipe collection
+  collection list              List collections
+  project init                 Initialize project-scoped recipes
+  repo                         Show git repo state (branch + status + log)
+  symbols <file>               Show file outline (functions, classes, exports)
+  stats                        Show token economy dashboard
+  sessions                     List recent terminal sessions
+  sessions stats               Show session analytics
+  sessions <id>                Show session details
+  snapshot                     Capture terminal state as JSON
+  --help                       Show this help
+  --version                    Show version
+
+MCP TOOLS (20+):
+  execute, execute_smart, execute_diff, expand, browse,
+  search_files, search_content, search_semantic, read_file,
+  read_symbol, symbols, repo_state, explain_error, status,
+  bg_start, bg_stop, bg_status, bg_logs, bg_wait_port,
+  list_recipes, run_recipe, save_recipe, list_collections,
+  snapshot, token_stats, session_history
+
+ENVIRONMENT:
+  CEREBRAS_API_KEY             Cerebras API key (free, open-source default)
+  ANTHROPIC_API_KEY            Anthropic API key (Claude models)
+`);
+    process.exit(0);
+}
+if (args[0] === "--version" || args[0] === "-v") {
+    console.log("0.6.1");
+    process.exit(0);
+}
+// ── Exec command — smart execution for agents ────────────────────────────────
+if (args[0] === "exec") {
+    const command = args.slice(1).join(" ");
+    if (!command) {
+        console.error("Usage: terminal exec <command>");
+        process.exit(1);
+    }
+    const { execSync } = await import("child_process");
+    const { stripAnsi } = await import("./compression.js");
+    const { stripNoise } = await import("./noise-filter.js");
+    const { processOutput, shouldProcess } = await import("./output-processor.js");
+    const { rewriteCommand } = await import("./command-rewriter.js");
+    const { shouldBeLazy, toLazy } = await import("./lazy-executor.js");
+    const { estimateTokens } = await import("./parsers/index.js");
+    // Rewrite command if possible
+    const rw = rewriteCommand(command);
+    const actualCmd = rw.changed ? rw.rewritten : command;
+    if (rw.changed)
+        console.error(`[open-terminal] rewritten: ${actualCmd} (${rw.reason})`);
+    try {
+        const start = Date.now();
+        const raw = execSync(actualCmd, { encoding: "utf8", maxBuffer: 10 * 1024 * 1024, cwd: process.cwd() });
+        const duration = Date.now() - start;
+        const clean = stripNoise(stripAnsi(raw)).cleaned;
+        const rawTokens = estimateTokens(raw);
+        // Lazy mode for huge output
+        if (shouldBeLazy(clean)) {
+            const lazy = toLazy(clean, actualCmd);
+            const savedTokens = rawTokens - estimateTokens(JSON.stringify(lazy));
+            console.log(JSON.stringify({ ...lazy, duration, tokensSaved: savedTokens }));
+            process.exit(0);
+        }
+        // AI summary for medium-large output
+        if (shouldProcess(clean)) {
+            const processed = await processOutput(actualCmd, clean);
+            if (processed.aiProcessed && processed.tokensSaved > 30) {
+                console.log(processed.summary);
+                const savedTokens = rawTokens - estimateTokens(processed.summary);
+                console.error(`[open-terminal] ${rawTokens} → ${rawTokens - savedTokens} tokens (saved ${savedTokens}, ${Math.round(savedTokens / rawTokens * 100)}%)`);
+                process.exit(0);
+            }
+        }
+        // Small/medium output — just noise-strip and return
+        console.log(clean);
+        const savedTokens = rawTokens - estimateTokens(clean);
+        if (savedTokens > 10) {
+            console.error(`[open-terminal] saved ${savedTokens} tokens (noise filter)`);
+        }
+    }
+    catch (e) {
+        // Command failed — show error output
+        const stderr = e.stderr?.toString() ?? "";
+        const stdout = e.stdout?.toString() ?? "";
+        console.log(stripNoise(stripAnsi(stdout + stderr)).cleaned);
+        process.exit(e.status ?? 1);
+    }
+    process.exit(0);
+}
 // ── MCP commands ─────────────────────────────────────────────────────────────
 if (args[0] === "mcp") {
     if (args[1] === "serve" || args.length === 1) {

package/dist/command-rewriter.js

@@ -41,10 +41,10 @@ const rules = [
         rewrite: () => "npm ls --depth=0",
         reason: "full tree is massive, top-level usually enough",
     },
-    // ps aux without filter → add sort and head
+    // ps aux without filter → sort by memory and head (macOS compatible)
     {
         pattern: /^ps\s+aux\s*$/,
-        rewrite: () => "ps aux --sort=-%mem | head -20",
+        rewrite: () => "ps aux | sort -k4 -rn | head -20",
         reason: "full process list is noise, show top consumers",
     },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "bin": {

package/src/cli.tsx

@@ -4,6 +4,119 @@ import { render } from "ink";
 
 const args = process.argv.slice(2);
 
+// ── Help / Version ───────────────────────────────────────────────────────────
+
+if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+  console.log(`open-terminal v0.6.1 — Smart terminal for AI agents and humans
+
+USAGE:
+  terminal                     Launch interactive NL terminal (TUI)
+  terminal <subcommand>        Run a specific command
+
+SUBCOMMANDS:
+  mcp serve                    Start MCP server (stdio transport)
+  mcp install --claude|--codex|--gemini|--all
+                               Install as MCP server for AI agents
+  hook install --claude        Install Claude Code PostToolUse hook
+  hook uninstall               Remove hooks
+  recipe add <name> <cmd>      Save a reusable command recipe
+  recipe list                  List saved recipes
+  recipe run <name> [--var=X]  Run a recipe with variable substitution
+  recipe delete <name>         Delete a recipe
+  collection create <name>     Create a recipe collection
+  collection list              List collections
+  project init                 Initialize project-scoped recipes
+  repo                         Show git repo state (branch + status + log)
+  symbols <file>               Show file outline (functions, classes, exports)
+  stats                        Show token economy dashboard
+  sessions                     List recent terminal sessions
+  sessions stats               Show session analytics
+  sessions <id>                Show session details
+  snapshot                     Capture terminal state as JSON
+  --help                       Show this help
+  --version                    Show version
+
+MCP TOOLS (20+):
+  execute, execute_smart, execute_diff, expand, browse,
+  search_files, search_content, search_semantic, read_file,
+  read_symbol, symbols, repo_state, explain_error, status,
+  bg_start, bg_stop, bg_status, bg_logs, bg_wait_port,
+  list_recipes, run_recipe, save_recipe, list_collections,
+  snapshot, token_stats, session_history
+
+ENVIRONMENT:
+  CEREBRAS_API_KEY             Cerebras API key (free, open-source default)
+  ANTHROPIC_API_KEY            Anthropic API key (Claude models)
+`);
+  process.exit(0);
+}
+
+if (args[0] === "--version" || args[0] === "-v") {
+  console.log("0.6.1");
+  process.exit(0);
+}
+
+// ── Exec command — smart execution for agents ────────────────────────────────
+
+if (args[0] === "exec") {
+  const command = args.slice(1).join(" ");
+  if (!command) { console.error("Usage: terminal exec <command>"); process.exit(1); }
+
+  const { execSync } = await import("child_process");
+  const { stripAnsi } = await import("./compression.js");
+  const { stripNoise } = await import("./noise-filter.js");
+  const { processOutput, shouldProcess } = await import("./output-processor.js");
+  const { rewriteCommand } = await import("./command-rewriter.js");
+  const { shouldBeLazy, toLazy } = await import("./lazy-executor.js");
+  const { estimateTokens } = await import("./parsers/index.js");
+
+  // Rewrite command if possible
+  const rw = rewriteCommand(command);
+  const actualCmd = rw.changed ? rw.rewritten : command;
+  if (rw.changed) console.error(`[open-terminal] rewritten: ${actualCmd} (${rw.reason})`);
+
+  try {
+    const start = Date.now();
+    const raw = execSync(actualCmd, { encoding: "utf8", maxBuffer: 10 * 1024 * 1024, cwd: process.cwd() });
+    const duration = Date.now() - start;
+    const clean = stripNoise(stripAnsi(raw)).cleaned;
+    const rawTokens = estimateTokens(raw);
+
+    // Lazy mode for huge output
+    if (shouldBeLazy(clean)) {
+      const lazy = toLazy(clean, actualCmd);
+      const savedTokens = rawTokens - estimateTokens(JSON.stringify(lazy));
+      console.log(JSON.stringify({ ...lazy, duration, tokensSaved: savedTokens }));
+      process.exit(0);
+    }
+
+    // AI summary for medium-large output
+    if (shouldProcess(clean)) {
+      const processed = await processOutput(actualCmd, clean);
+      if (processed.aiProcessed && processed.tokensSaved > 30) {
+        console.log(processed.summary);
+        const savedTokens = rawTokens - estimateTokens(processed.summary);
+        console.error(`[open-terminal] ${rawTokens} → ${rawTokens - savedTokens} tokens (saved ${savedTokens}, ${Math.round(savedTokens/rawTokens*100)}%)`);
+        process.exit(0);
+      }
+    }
+
+    // Small/medium output — just noise-strip and return
+    console.log(clean);
+    const savedTokens = rawTokens - estimateTokens(clean);
+    if (savedTokens > 10) {
+      console.error(`[open-terminal] saved ${savedTokens} tokens (noise filter)`);
+    }
+  } catch (e: any) {
+    // Command failed — show error output
+    const stderr = e.stderr?.toString() ?? "";
+    const stdout = e.stdout?.toString() ?? "";
+    console.log(stripNoise(stripAnsi(stdout + stderr)).cleaned);
+    process.exit(e.status ?? 1);
+  }
+  process.exit(0);
+}
+
 // ── MCP commands ─────────────────────────────────────────────────────────────
 
 if (args[0] === "mcp") {

package/src/command-rewriter.ts

@@ -47,10 +47,10 @@ const rules: RewriteRule[] = [
     rewrite: () => "npm ls --depth=0",
     reason: "full tree is massive, top-level usually enough",
   },
-  // ps aux without filter → add sort and head
+  // ps aux without filter → sort by memory and head (macOS compatible)
   {
     pattern: /^ps\s+aux\s*$/,
-    rewrite: () => "ps aux --sort=-%mem | head -20",
+    rewrite: () => "ps aux | sort -k4 -rn | head -20",
     reason: "full process list is noise, show top consumers",
   },
 ];