@8gi-foundation/8gent-code 0.20.12 → 0.20.14

package/CHANGELOG.md

@@ -9,6 +9,19 @@ versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.20.14] - 2026-10-22
+
+### Changed
+- Android Termux and proot install path, Node version commands, signal exit ([#4747](https://github.com/8gi-foundation/8gent-code/pull/4747))
+
+### Fixed
+- tui: built-in slash commands run before the skill scan loads and after it fails ([#4745](https://github.com/8gi-foundation/8gent-code/pull/4745))
+
+## [0.20.13] - 2026-10-22
+
+### Fixed
+- tui: the prompt stays live in every view unless a picker owns the keyboard, and Esc always returns (0.20.12 regression) ([#4740](https://github.com/8gi-foundation/8gent-code/pull/4740))
+
 ## [0.20.12] - 2026-10-22
 
 ### Added

package/README.md

@@ -21,7 +21,7 @@
 
 <p align="center">
   <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-E8610A?style=for-the-badge&labelColor=1A1612" alt="Apache 2.0 License" /></a>
-  <a href="https://8gent.dev"><img src="https://img.shields.io/badge/version-0.20.12-2D8A56?style=for-the-badge&labelColor=1A1612" alt="v0.20.12" /></a>
+  <a href="https://8gent.dev"><img src="https://img.shields.io/badge/version-0.20.14-2D8A56?style=for-the-badge&labelColor=1A1612" alt="v0.20.14" /></a>
   <a href="https://eight-vessel.fly.dev"><img src="https://img.shields.io/badge/daemon-Fly.io_Amsterdam-E8610A?style=for-the-badge&labelColor=1A1612" alt="Daemon" /></a>
 </p>
 
@@ -159,7 +159,7 @@ That's it. 8gent uses an adaptive provider router with 16 model providers (plus
 
 **No model yet?** On a machine with no local model and no key, the chat area shows a short card with both ways to connect one: install Ollama and run `ollama pull qwen3.5`, or run `8gent keys` to add `OPENROUTER_API_KEY` to `~/.8gent/keys.env` and then use `/provider openrouter` with `/model auto:free`. `/provider` lists every option. The card goes away once a model is reachable.
 
-**Pick your platform:** [macOS](docs/install/macos.md), [Windows](docs/install/windows.md), [Linux](docs/install/linux.md). Every provider, flag and environment variable is in [docs/install/providers.md](docs/install/providers.md). One-line binary installers (no Bun or Node needed) are in [docs/user/install.md](docs/user/install.md).
+**Pick your platform:** [macOS](docs/install/macos.md), [Windows](docs/install/windows.md), [Linux](docs/install/linux.md), [Android (Termux, kali and arch proots)](docs/install/android-termux.md). Every provider, flag and environment variable is in [docs/install/providers.md](docs/install/providers.md). One-line binary installers (no Bun or Node needed) are in [docs/user/install.md](docs/user/install.md).
 
 **Ollama is optional.** To run on llama.cpp's `llama-server` instead, set `EIGHT_LOCAL_SERVER=llama-server` and start with `8gent --provider=llama-server`. 8gent then never contacts Ollama. See [docs/guides/llama-server.md](docs/guides/llama-server.md).
 
@@ -222,9 +222,9 @@ tar xzf 8gent-<version>-linux-amd64.tar.gz && sudo mv 8gent-*/bin/8gent /usr/loc
 
 > Binaries are code-signed only on releases where the maintainer's certificates are configured (see [SIGNING.md](SIGNING.md)). Unsigned downloads run fine but may prompt Gatekeeper (macOS) or SmartScreen (Windows) - allow them through, or build your own with `bun run build:binaries`.
 
-### npm (old build, 0.17.0)
+### npm
 
-The npm package is behind GitHub. `npm install -g @8gi-foundation/8gent-code` installs 0.17.0 (published 11 May 2026), not the current release, and it needs [Bun](https://bun.sh). Use a one-line installer above until npm is republished.
+The npm package tracks the GitHub release: `npm install -g @8gi-foundation/8gent-code` installs the current version. It runs on Bun, or on Node 22.5 or newer when Bun is not installed. On Android (Termux, kali or arch proot) follow [docs/install/android-termux.md](docs/install/android-termux.md).
 
 ### Build binaries from source
 

package/bin/8gent-run.js

@@ -88,4 +88,11 @@ if (result.error && result.error.code === "ENOENT") {
 	);
 }
 
+// Killed by a signal (status null, e.g. SIGILL in a proot): say so and fail, never a silent 0.
+if (result.status === null && result.signal) {
+	console.error(
+		`8gent: the runtime was killed by ${result.signal}.${wantNode ? "" : " Try EIGHT_RUNTIME=node 8gent to use the Node build."}`,
+	);
+	process.exit(1);
+}
 process.exit(result.status ?? 0);

package/bin/node-version.js

@@ -5,5 +5,10 @@ export function nodeTooOld(version) {
 }
 
 export function tooOldMessage(version) {
-	return `8gent needs Node 22.5 or newer (found ${version}). Install Node 22 or Bun.`;
+	return [
+		`8gent needs Node 22.5 or newer (found ${version}). Install Node 22 or Bun.`,
+		"  Debian / Kali: curl -fsSL https://deb.nodesource.com/setup_22.x -o /tmp/nodesource.sh && bash /tmp/nodesource.sh && apt-get install -y nodejs",
+		"  Arch:          pacman -Syu --noconfirm nodejs npm",
+		"  Any Linux:     install nvm (https://github.com/nvm-sh/nvm), then: nvm install 22",
+	].join("\n");
 }

package/dist/cli.js

@@ -597524,7 +597524,7 @@ function nodeExecPath(execPath = process.execPath, env = process.env, exists = e
 
 // bin/8gent.ts
 refuseIfNested();
-var VERSION5 = "0.20.12";
+var VERSION5 = "0.20.14";
 var RELAUNCH_EXIT_CODE = 75;
 var MODULE_DIR = path158.dirname(fileURLToPath7(import.meta.url));
 var EXEC_DIR = path158.dirname(process.execPath);

package/dist/node/cli.js

@@ -617700,7 +617700,7 @@ function nodeExecPath(execPath = process.execPath, env = process.env, exists = e
 
 // bin/8gent.ts
 refuseIfNested();
-var VERSION5 = "0.20.12";
+var VERSION5 = "0.20.14";
 var RELAUNCH_EXIT_CODE = 75;
 var MODULE_DIR = path158.dirname(fileURLToPath8(import.meta.url));
 var EXEC_DIR = path158.dirname(process.execPath);

package/dist/node/tui.js

@@ -33286,7 +33286,7 @@ var init_permissions = __esm(() => {
 var require_package = __commonJS(function(exports2, module2) {
   module2.exports = {
     name: "@8gi-foundation/8gent-code",
-    version: "0.20.12",
+    version: "0.20.14",
     private: false,
     engines: {
       node: ">=22.5"
@@ -620694,6 +620694,9 @@ function safeLoadTemplates() {
 function getBuiltInSlashCommands() {
   return BUILT_IN_SLASH_COMMANDS;
 }
+function getBuiltInSlashRegistry() {
+  return mergeSlashEntries(buildBuiltInEntries(), [], []);
+}
 async function getSlashRegistry() {
   return mergeSlashEntries(buildBuiltInEntries(), await buildSkillEntries(), buildPromptEntries());
 }
@@ -621149,8 +621152,9 @@ function CommandInput({
   const [historyIndex, setHistoryIndex] = import_react55.useState(-1);
   const draftRef = import_react55.useRef("");
   const [showSlashHelp, setShowSlashHelp] = import_react55.useState(false);
-  const [slashRegistryEntries, setSlashRegistryEntries] = import_react55.useState([]);
-  const [slashByToken, setSlashByToken] = import_react55.useState(new Map);
+  const [initialRegistry] = import_react55.useState(getBuiltInSlashRegistry);
+  const [slashRegistryEntries, setSlashRegistryEntries] = import_react55.useState(initialRegistry.entries);
+  const [slashByToken, setSlashByToken] = import_react55.useState(initialRegistry.byToken);
   const builtInSlashGhosts = import_react55.useMemo(() => buildBuiltInSlashGhostSuggestions(), []);
   const extraSlashContext = import_react55.useMemo(() => [
     ...builtInSlashGhosts,
@@ -621183,8 +621187,8 @@ function CommandInput({
         }
       } catch {
         if (!cancelled) {
-          setSlashRegistryEntries([]);
-          setSlashByToken(new Map);
+          setSlashRegistryEntries(initialRegistry.entries);
+          setSlashByToken(initialRegistry.byToken);
         }
       }
     })();
@@ -630291,6 +630295,25 @@ function settleSetupTranscript(messages) {
   return out;
 }
 
+// apps/tui/src/lib/prompt-focus.ts
+var KEYBOARD_VIEWS = new Set([
+  "model-select",
+  "provider-select",
+  "theme-select",
+  "session-picker",
+  "session-tree",
+  "keys"
+]);
+var ESC_RETURNS_LINE = "Esc returns to the prompt";
+function promptIsLive(s) {
+  if (KEYBOARD_VIEWS.has(s.viewMode))
+    return false;
+  return !s.tabBodyShown && !s.isBubbleNavMode && !s.paletteOpen && !s.djKeys;
+}
+function mayAutoOpenProviderPicker(keyedHostedProviders) {
+  return keyedHostedProviders.length !== 1;
+}
+
 // apps/tui/src/lib/provider-health.ts
 init_text_tool_endpoint();
 init_local_model_server();
@@ -639459,13 +639482,7 @@ function speakOnboardingLine(rawText, preference) {
   })();
 }
 var PLAN_COLUMN_WIDTH = 24;
-var PICKER_VIEWS = new Set([
-  "model-select",
-  "provider-select",
-  "theme-select",
-  "session-picker",
-  "session-tree"
-]);
+var PICKER_VIEWS = KEYBOARD_VIEWS;
 var SESSION_VIEWS = new Set(["session-picker", "session-tree"]);
 var PLAN_EMPTY_LINE = "No plan steps yet. They appear when the 8gent writes a PLAN: with numbered steps while working on a request.";
 var AVENUES_EMPTY_LINE = "No avenues in this session. Nothing produces them yet, so this stays empty rather than showing guesses.";
@@ -640164,6 +640181,7 @@ function App2({
       addSystemMessage(notice);
     setCurrentModel(next);
   }, [modelsLoading, availableModels, modelsOwner, currentProvider, currentModel]);
+  const oneKeyNoModelNotedRef = import_react104.useRef(false);
   import_react104.useEffect(() => {
     if (modelsLoading)
       return;
@@ -640175,6 +640193,13 @@ function App2({
       return;
     if (availableModels.some((m) => !isLikelyEmbeddingModelId(m)))
       return;
+    if (!mayAutoOpenProviderPicker(hostedKeyedProviders())) {
+      if (viewMode === "chat" && !oneKeyNoModelNotedRef.current) {
+        oneKeyNoModelNotedRef.current = true;
+        addSystemMessage(`${currentProvider} listed no chat model. Check the key with /apikeys, or pick one with /provider.`);
+      }
+      return;
+    }
     if (viewMode === "chat")
       setViewMode("provider-select");
   }, [modelsLoading, availableModels, currentModel, viewMode, modelsOwner, currentProvider]);
@@ -644786,8 +644811,14 @@ ${result.commands.map((c) => `  $ ${c}`).join(`
                   }, undefined, false, undefined, this),
                   PICKER_VIEWS.has(viewMode) && activeTabType === "chat" && /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(Box_default, {
                     flexShrink: 0,
-                    children: renderMainContent()
-                  }, undefined, false, undefined, this),
+                    flexDirection: "column",
+                    children: [
+                      renderMainContent(),
+                      /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(MutedText, {
+                        children: ESC_RETURNS_LINE
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
                   approvalPending && /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(InlineApprovalPrompt, {
                     target: approvalPending.target,
                     reason: approvalPending.reason,
@@ -644803,7 +644834,13 @@ ${result.commands.map((c) => `  $ ${c}`).join(`
                       onSubmit: handleSubmit,
                       isProcessing,
                       placeholder: showOnboarding ? onboardingPlaceholder ?? "Type your answer" : nameQuestionOpen ? "Your name" : undefined,
-                      focused: (viewMode === "chat" && activeTabType === "chat" || viewMode === "onboarding") && !isBubbleNavMode && !paletteOpen && !djKeys,
+                      focused: promptIsLive({
+                        viewMode,
+                        tabBodyShown: tabBody != null,
+                        isBubbleNavMode,
+                        paletteOpen,
+                        djKeys
+                      }),
                       typingPaused: djKeys,
                       processingStage,
                       showAnimations,

package/dist/tui.js

@@ -29981,7 +29981,7 @@ var init_permissions = __esm(() => {
 var require_package = __commonJS(function(exports2, module2) {
   module2.exports = {
     name: "@8gi-foundation/8gent-code",
-    version: "0.20.12",
+    version: "0.20.14",
     private: false,
     engines: {
       node: ">=22.5"
@@ -597659,6 +597659,9 @@ function safeLoadTemplates() {
 function getBuiltInSlashCommands() {
   return BUILT_IN_SLASH_COMMANDS;
 }
+function getBuiltInSlashRegistry() {
+  return mergeSlashEntries(buildBuiltInEntries(), [], []);
+}
 async function getSlashRegistry() {
   return mergeSlashEntries(buildBuiltInEntries(), await buildSkillEntries(), buildPromptEntries());
 }
@@ -598114,8 +598117,9 @@ function CommandInput({
   const [historyIndex, setHistoryIndex] = import_react55.useState(-1);
   const draftRef = import_react55.useRef("");
   const [showSlashHelp, setShowSlashHelp] = import_react55.useState(false);
-  const [slashRegistryEntries, setSlashRegistryEntries] = import_react55.useState([]);
-  const [slashByToken, setSlashByToken] = import_react55.useState(new Map);
+  const [initialRegistry] = import_react55.useState(getBuiltInSlashRegistry);
+  const [slashRegistryEntries, setSlashRegistryEntries] = import_react55.useState(initialRegistry.entries);
+  const [slashByToken, setSlashByToken] = import_react55.useState(initialRegistry.byToken);
   const builtInSlashGhosts = import_react55.useMemo(() => buildBuiltInSlashGhostSuggestions(), []);
   const extraSlashContext = import_react55.useMemo(() => [
     ...builtInSlashGhosts,
@@ -598148,8 +598152,8 @@ function CommandInput({
         }
       } catch {
         if (!cancelled) {
-          setSlashRegistryEntries([]);
-          setSlashByToken(new Map);
+          setSlashRegistryEntries(initialRegistry.entries);
+          setSlashByToken(initialRegistry.byToken);
         }
       }
     })();
@@ -607256,6 +607260,25 @@ function settleSetupTranscript(messages) {
   return out;
 }
 
+// apps/tui/src/lib/prompt-focus.ts
+var KEYBOARD_VIEWS = new Set([
+  "model-select",
+  "provider-select",
+  "theme-select",
+  "session-picker",
+  "session-tree",
+  "keys"
+]);
+var ESC_RETURNS_LINE = "Esc returns to the prompt";
+function promptIsLive(s) {
+  if (KEYBOARD_VIEWS.has(s.viewMode))
+    return false;
+  return !s.tabBodyShown && !s.isBubbleNavMode && !s.paletteOpen && !s.djKeys;
+}
+function mayAutoOpenProviderPicker(keyedHostedProviders) {
+  return keyedHostedProviders.length !== 1;
+}
+
 // apps/tui/src/lib/provider-health.ts
 init_text_tool_endpoint();
 init_local_model_server();
@@ -616424,13 +616447,7 @@ function speakOnboardingLine(rawText, preference) {
   })();
 }
 var PLAN_COLUMN_WIDTH = 24;
-var PICKER_VIEWS = new Set([
-  "model-select",
-  "provider-select",
-  "theme-select",
-  "session-picker",
-  "session-tree"
-]);
+var PICKER_VIEWS = KEYBOARD_VIEWS;
 var SESSION_VIEWS = new Set(["session-picker", "session-tree"]);
 var PLAN_EMPTY_LINE = "No plan steps yet. They appear when the 8gent writes a PLAN: with numbered steps while working on a request.";
 var AVENUES_EMPTY_LINE = "No avenues in this session. Nothing produces them yet, so this stays empty rather than showing guesses.";
@@ -617129,6 +617146,7 @@ function App2({
       addSystemMessage(notice);
     setCurrentModel(next);
   }, [modelsLoading, availableModels, modelsOwner, currentProvider, currentModel]);
+  const oneKeyNoModelNotedRef = import_react104.useRef(false);
   import_react104.useEffect(() => {
     if (modelsLoading)
       return;
@@ -617140,6 +617158,13 @@ function App2({
       return;
     if (availableModels.some((m) => !isLikelyEmbeddingModelId(m)))
       return;
+    if (!mayAutoOpenProviderPicker(hostedKeyedProviders())) {
+      if (viewMode === "chat" && !oneKeyNoModelNotedRef.current) {
+        oneKeyNoModelNotedRef.current = true;
+        addSystemMessage(`${currentProvider} listed no chat model. Check the key with /apikeys, or pick one with /provider.`);
+      }
+      return;
+    }
     if (viewMode === "chat")
       setViewMode("provider-select");
   }, [modelsLoading, availableModels, currentModel, viewMode, modelsOwner, currentProvider]);
@@ -621751,8 +621776,14 @@ ${result.commands.map((c) => `  $ ${c}`).join(`
                   }, undefined, false, undefined, this),
                   PICKER_VIEWS.has(viewMode) && activeTabType === "chat" && /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(Box_default, {
                     flexShrink: 0,
-                    children: renderMainContent()
-                  }, undefined, false, undefined, this),
+                    flexDirection: "column",
+                    children: [
+                      renderMainContent(),
+                      /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(MutedText, {
+                        children: ESC_RETURNS_LINE
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
                   approvalPending && /* @__PURE__ */ jsx_dev_runtime67.jsxDEV(InlineApprovalPrompt, {
                     target: approvalPending.target,
                     reason: approvalPending.reason,
@@ -621768,7 +621799,13 @@ ${result.commands.map((c) => `  $ ${c}`).join(`
                       onSubmit: handleSubmit,
                       isProcessing,
                       placeholder: showOnboarding ? onboardingPlaceholder ?? "Type your answer" : nameQuestionOpen ? "Your name" : undefined,
-                      focused: (viewMode === "chat" && activeTabType === "chat" || viewMode === "onboarding") && !isBubbleNavMode && !paletteOpen && !djKeys,
+                      focused: promptIsLive({
+                        viewMode,
+                        tabBodyShown: tabBody != null,
+                        isBubbleNavMode,
+                        paletteOpen,
+                        djKeys
+                      }),
                       typingPaused: djKeys,
                       processingStage,
                       showAnimations,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@8gi-foundation/8gent-code",
-  "version": "0.20.12",
+  "version": "0.20.14",
   "private": false,
   "engines": {
     "node": ">=22.5"