terminal-jarvis 0.0.79 → 0.0.81

package/README.md

@@ -4,13 +4,15 @@
 
 **Unified command center for AI coding tools**
 
-Manage Claude, Gemini, Qwen, and 19 more AI assistants from one terminal interface.
+Manage Claude, Gemini, Qwen, and 20 more AI assistants from one terminal interface.
 
 [![NPM Version](https://img.shields.io/npm/v/terminal-jarvis.svg?logo=npm&style=flat-square)](https://www.npmjs.com/package/terminal-jarvis)
 [![Crates.io](https://img.shields.io/crates/v/terminal-jarvis.svg?logo=rust&style=flat-square)](https://crates.io/crates/terminal-jarvis)
 [![Homebrew](https://img.shields.io/badge/Homebrew-Available-blue.svg?logo=homebrew&style=flat-square)](https://github.com/BA-CalderonMorales/homebrew-terminal-jarvis)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Mentioned in Awesome](https://img.shields.io/badge/Mentioned%20in-Awesome-6f42c1?style=flat-square)](https://github.com/Piebald-AI/awesome-gemini-cli)
+[![Docs](https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square)](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/)
+[![Coverage](https://img.shields.io/badge/coverage-report-green.svg?style=flat-square)](/coverage)
 
 <img src="https://raw.githubusercontent.com/BA-CalderonMorales/terminal-jarvis/docs/screenshots_and_demos/screenshots_and_demo/promo_image_for_readme.png" alt="Terminal Jarvis Interface" width="100%">
 
@@ -52,7 +54,7 @@ brew tap ba-calderonmorales/terminal-jarvis && brew install terminal-jarvis  # H
 | Feature | Description |
 |:--------|:------------|
 | **Interactive Interface** | Beautiful terminal UI with ASCII art, themed menus, and keyboard navigation for a polished command-line experience. |
-| **22 AI Tools Supported** | Claude, Gemini, Qwen, OpenCode, Codex, Aider, Goose, Amp, Crush, LLXPRT, and many more - all manageable from a single interface. |
+| **25 AI Tools Supported** | Claude, Gemini, Qwen, OpenCode, Codex, Aider, Goose, Amp, Crush, LLXPRT, and many more - all manageable from a single interface. |
 | **Integrated Installation** | Install, update, or uninstall any supported AI tool directly from the menu without leaving the terminal. |
 | **Session Continuity** | Preserves your terminal session state during browser-based authentication flows. Currently in development with expanding coverage. |
 
@@ -67,7 +69,7 @@ Full guides at **[Terminal Jarvis Docs](https://ba-calderonmorales.github.io/my-
 | Guide | Description |
 |:------|:------------|
 | [Installation](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/quick_start/installation/) | Step-by-step platform setup for NPM, Cargo, and Homebrew with troubleshooting tips for common issues. |
-| [AI Tools](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/quick_start/ai-tools/) | Detailed overview of all 11 supported AI coding assistants including authentication requirements and capabilities. |
+| [AI Tools](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/quick_start/ai-tools/) | Detailed overview of all 25 supported AI coding assistants including authentication requirements and capabilities. |
 | [Configuration](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/quick_start/configuration/) | Customize themes, keybindings, default tools, and environment variables to match your workflow. |
 | [Architecture](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/details/architecture/) | Technical deep-dive into the Rust codebase, module organization, and design decisions. |
 
@@ -81,7 +83,7 @@ terminal-jarvis/
 ├── src/                           # Rust application
 │   ├── main.rs                    # Entry point
 │   ├── cli.rs                     # CLI definitions
-│   ├── cli_logic/                 # Business logic (22 modules)
+│   ├── cli_logic/                 # Business logic (19 modules)
 │   ├── auth_manager/              # Authentication (8 modules)
 │   ├── config/                    # Configuration (6 modules)
 │   ├── services/                  # External integrations (6 modules)

package/config/tools/code.toml

@@ -8,7 +8,7 @@ config_key = "code"
 description = "Fork of Codex AI - multi-provider coding agent"
 homepage = "https://github.com/just-every/code"
 documentation = "https://github.com/just-every/code"
-cli_command = "code"
+cli_command = "coder"
 requires_npm = true
 requires_sudo = false
 status = "experimental"
@@ -16,13 +16,13 @@ status = "experimental"
 [tool.install]
 command = "npm"
 args = ["install", "-g", "@just-every/code"]
-verify_command = "code --version"
-post_install_message = "Code installed! If 'code' conflicts with VS Code, check alias."
+verify_command = "coder --version"
+post_install_message = "Code installed! Run it with 'coder'."
 
 [tool.update]
 command = "npm"
 args = ["update", "-g", "@just-every/code"]
-verify_command = "code --version"
+verify_command = "coder --version"
 
 [tool.auth]
 env_vars = ["OPENAI_API_KEY"]

package/config/tools/hermes.toml

@@ -0,0 +1,60 @@
+# =============================================================================
+# HERMES AGENT - Nous Research terminal agent
+# =============================================================================
+
+[tool]
+display_name = "Hermes Agent"
+config_key = "hermes"
+description = "Nous Research's terminal AI agent with CLI, TUI, tools, skills, and messaging gateway support"
+homepage = "https://hermes-agent.nousresearch.com/"
+documentation = "https://hermes-agent.nousresearch.com/docs/"
+cli_command = "hermes"
+requires_npm = false
+requires_sudo = false
+status = "experimental"
+
+[tool.install]
+command = "bash"
+args = [
+    "-lc",
+    "curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-setup",
+]
+verify_command = "hermes --version"
+post_install_message = "Hermes Agent installed successfully! Run 'hermes setup' or 'hermes model' to configure a provider."
+
+[tool.update]
+command = "hermes"
+args = ["update"]
+verify_command = "hermes --version"
+
+[tool.auth]
+env_vars = [
+    "OPENROUTER_API_KEY",
+    "AI_GATEWAY_API_KEY",
+    "HF_TOKEN",
+    "ANTHROPIC_API_KEY",
+    "OPENAI_API_KEY",
+    "GOOGLE_API_KEY",
+    "GEMINI_API_KEY",
+]
+setup_url = "https://hermes-agent.nousresearch.com/docs/integrations/providers/"
+browser_auth = true
+auth_instructions = "Run 'hermes setup', 'hermes model', or set a supported provider key in ~/.hermes/.env. Hermes supports browser/OAuth providers and API-key providers such as OpenRouter, AI Gateway, Hugging Face, Anthropic, OpenAI-compatible endpoints, and Gemini."
+auth_mode = "any"
+default_env_var = "OPENROUTER_API_KEY"
+cli_auth_command = "hermes setup"
+providers = [
+    {name = "OpenRouter", env_var = "OPENROUTER_API_KEY", key_hint = "sk-or-*", setup_url = "https://openrouter.ai/keys"},
+    {name = "AI Gateway", env_var = "AI_GATEWAY_API_KEY", setup_url = "https://ai-gateway.vercel.sh/"},
+    {name = "Hugging Face", env_var = "HF_TOKEN", key_hint = "hf_*", setup_url = "https://huggingface.co/settings/tokens"},
+    {name = "Anthropic", env_var = "ANTHROPIC_API_KEY", key_hint = "sk-ant-*", setup_url = "https://console.anthropic.com/"},
+    {name = "OpenAI-compatible", env_var = "OPENAI_API_KEY", key_hint = "sk-*", setup_url = "https://platform.openai.com/api-keys"},
+    {name = "Google Gemini", env_var = "GOOGLE_API_KEY", key_hint = "AIza*", setup_url = "https://aistudio.google.com/app/apikey"},
+]
+
+[tool.features]
+supports_files = true
+supports_streaming = true
+supports_conversation = true
+max_context_tokens = 200000
+supported_languages = ["all"]

package/config/tools/nanocoder.toml

@@ -6,8 +6,8 @@
 display_name = "Nanocoder"
 config_key = "nanocoder"
 description = "Local-first coding agent"
-homepage = "https://github.com/motesoftware/nanocoder"
-documentation = "https://github.com/motesoftware/nanocoder"
+homepage = "https://github.com/Nano-Collective/nanocoder"
+documentation = "https://github.com/Nano-Collective/nanocoder"
 cli_command = "nanocoder"
 requires_npm = true
 requires_sudo = false
@@ -15,13 +15,13 @@ status = "experimental"
 
 [tool.install]
 command = "npm"
-args = ["install", "-g", "@motesoftware/nanocoder"]
+args = ["install", "-g", "@nanocollective/nanocoder"]
 verify_command = "nanocoder --version"
 post_install_message = "Nanocoder installed!"
 
 [tool.update]
 command = "npm"
-args = ["update", "-g", "@motesoftware/nanocoder"]
+args = ["update", "-g", "@nanocollective/nanocoder"]
 verify_command = "nanocoder --version"
 
 [tool.auth]

package/config/tools/openclaw.toml

@@ -0,0 +1,44 @@
+# =============================================================================
+# OPENCLAW - AI gateway and coding agent
+# =============================================================================
+
+[tool]
+display_name = "OpenClaw"
+config_key = "openclaw"
+description = "Open-source AI coding assistant and multi-channel local gateway"
+homepage = "https://openclaw.ai/"
+documentation = "https://docs.openclaw.ai/"
+cli_command = "openclaw"
+requires_npm = true
+requires_sudo = false
+status = "experimental"
+
+[tool.install]
+command = "npm"
+args = ["install", "-g", "openclaw"]
+verify_command = "openclaw --version"
+post_install_message = "OpenClaw installed successfully! Run 'openclaw onboard' or 'openclaw setup' to configure providers and gateway settings."
+
+[tool.update]
+command = "openclaw"
+args = ["update", "--yes", "--no-restart"]
+verify_command = "openclaw --version"
+
+[tool.auth]
+env_vars = ["OPENROUTER_API_KEY"]
+setup_url = "https://docs.openclaw.ai/"
+browser_auth = true
+auth_instructions = "Run 'openclaw onboard' to configure providers. For headless OpenRouter setup, use 'openclaw onboard --auth-choice openrouter-api-key'. OpenClaw can manage local gateway services, ports, webhooks, and token storage, so review gateway and provider settings before enabling persistent services."
+auth_mode = "any"
+default_env_var = "OPENROUTER_API_KEY"
+cli_auth_command = "openclaw onboard"
+providers = [
+    {name = "OpenRouter", env_var = "OPENROUTER_API_KEY", key_hint = "sk-or-*", setup_url = "https://openrouter.ai/keys"},
+]
+
+[tool.features]
+supports_files = true
+supports_streaming = true
+supports_conversation = true
+max_context_tokens = 200000
+supported_languages = ["all"]

package/config/tools/pi.toml

@@ -6,8 +6,8 @@
 display_name = "Pi"
 config_key = "pi"
 description = "Terminal-based coding agent"
-homepage = "https://github.com/mariozechner/pi-coding-agent"
-documentation = "https://github.com/mariozechner/pi-coding-agent"
+homepage = "https://github.com/earendil-works/pi-mono"
+documentation = "https://github.com/earendil-works/pi-mono"
 cli_command = "pi"
 requires_npm = true
 requires_sudo = false
@@ -15,13 +15,13 @@ status = "experimental"
 
 [tool.install]
 command = "npm"
-args = ["install", "-g", "@mariozechner/pi-coding-agent"]
+args = ["install", "-g", "@earendil-works/pi-coding-agent"]
 verify_command = "pi --version"
 post_install_message = "Pi installed!"
 
 [tool.update]
 command = "npm"
-args = ["update", "-g", "@mariozechner/pi-coding-agent"]
+args = ["update", "-g", "@earendil-works/pi-coding-agent"]
 verify_command = "pi --version"
 
 [tool.auth]

package/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Terminal Jarvis - TypeScript Type Definitions
+ *
+ * A thin wrapper that provides a unified interface for managing
+ * and running AI coding tools including Claude, Gemini, Qwen,
+ * OpenCode, Codex, Aider, Goose, Amp, Crush, LLXPRT, and more.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for running Terminal Jarvis
+ */
+export interface JarvisOptions {
+  /** Run in headless mode without interactive prompts */
+  headless?: boolean;
+  /** UI theme to use */
+  theme?: "default" | "classic" | "matrix";
+  /** Enable verbose logging */
+  verbose?: boolean;
+  /** Configuration file path */
+  config?: string;
+}
+
+/**
+ * Execute a terminal-jarvis command with the specified tool
+ *
+ * @param tool - The AI tool to run (e.g., "claude", "gemini", "codex")
+ * @param options - Optional configuration for the execution
+ * @returns Promise that resolves when the command completes
+ *
+ * @example
+ * ```typescript
+ * import { run } from "terminal-jarvis";
+ *
+ * await run("claude", { theme: "matrix" });
+ * ```
+ */
+export function run(tool: string, options?: JarvisOptions): Promise<void>;
+
+/**
+ * Execute terminal-jarvis with raw command arguments
+ *
+ * @param args - Array of command-line arguments to pass to terminal-jarvis
+ * @returns Promise that resolves with the exit code
+ *
+ * @example
+ * ```typescript
+ * import { runRaw } from "terminal-jarvis";
+ *
+ * const exitCode = await runRaw(["--version"]);
+ * ```
+ */
+export function runRaw(args: string[]): Promise<number>;
+
+/**
+ * Get the path to the bundled Rust binary
+ *
+ * @returns The absolute path to the binary, or null if not found
+ */
+export function getBinaryPath(): string | null;
+
+/**
+ * Check if terminal-jarvis is properly installed and available
+ *
+ * @returns Promise that resolves to true if available
+ */
+export function isAvailable(): Promise<boolean>;
+
+/**
+ * Supported AI tools that can be managed through Terminal Jarvis
+ */
+export type SupportedTool =
+  | "claude"
+  | "gemini"
+  | "qwen"
+  | "opencode"
+  | "codex"
+  | "aider"
+  | "goose"
+  | "amp"
+  | "crush"
+  | "llxprt"
+  | string;
+
+/**
+ * Version information for Terminal Jarvis
+ */
+export interface VersionInfo {
+  /** NPM wrapper version */
+  npmVersion: string;
+  /** Core Rust binary version */
+  coreVersion: string;
+  /** Platform binary was built for */
+  platform: string;
+}
+
+/**
+ * Get version information for Terminal Jarvis
+ *
+ * @returns Promise that resolves with version information
+ */
+export function getVersion(): Promise<VersionInfo>;

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "terminal-jarvis",
-  "version": "0.0.79",
+  "version": "0.0.81",
   "description": "AI Coding Tools Wrapper - Unified interface for claude-code, gemini-cli, qwen-code, opencode, llxprt, codex, crush, goose, amp, and aider",
   "bin": {
     "terminal-jarvis": "bin/terminal-jarvis"
   },
+  "types": "index.d.ts",
   "files": [
     "lib/",
     "bin/",
     "scripts/",
     "config/",
     "README.md",
-    "package.json"
+    "package.json",
+    "index.d.ts"
   ],
   "scripts": {
     "generate-tools": "../../scripts/utils/generate-readme-tools.sh",
@@ -30,6 +32,7 @@
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit && echo 'TypeScript type check passed'",
     "test:e2e": "npm run build-rust && vitest run",
     "build": "npm run copy-configs && npm run sync-readme-npm",
     "prepack": "npm run build",