nexo-brain 2.6.18 → 2.6.20

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "2.6.18",
+  "version": "2.6.20",
   "description": "Local cognitive runtime for Claude Code \u2014 persistent memory, overnight learning, doctor diagnostics, personal scripts, recovery-aware jobs, startup preflight, and optional dashboard/power helper.",
   "author": {
     "name": "NEXO Brain",

package/README.md

@@ -38,7 +38,7 @@ That means NEXO now manages not only the shared runtime and MCP wiring, but also
 - For Codex specifically, `nexo chat` and Codex headless automation inject the current bootstrap explicitly, so Codex starts as NEXO even when plain global Codex startup is inconsistent about global instructions.
 - Deep Sleep now reads both Claude Code and Codex transcript stores, so overnight analysis still works even when the user spends the day in Codex.
 
-Version `2.6.14` closes those parity gaps in practice, `2.6.15` hardens the installed-runtime migration path so existing users actually receive the managed bootstrap updates cleanly, `2.6.16` pushes the system further in three directions, `2.6.17` finishes the annoying last-mile migration bugs for real existing installs, and `2.6.18` tightens the remaining practical gaps around manual Codex use, Deep Sleep horizon artifacts, and retrieval honesty:
+Version `2.6.14` closes those parity gaps in practice, `2.6.15` hardens the installed-runtime migration path so existing users actually receive the managed bootstrap updates cleanly, `2.6.16` pushes the system further in three directions, `2.6.17` finishes the annoying last-mile migration bugs for real existing installs, `2.6.18` tightens the remaining practical gaps around manual Codex use, Deep Sleep horizon artifacts, and retrieval honesty, and `2.6.20` makes the recommended Claude profile explicit across installer, runtime defaults, existing installs, and the update path itself: `Opus 4.6 with 1M context`.
 
 - Codex now gets managed global bootstrap/model sync in `~/.codex/config.toml`, so sessions opened outside `nexo chat` are much less likely to start as plain Codex.
 - Codex config now also persists a managed `mcp_servers.nexo` entry, so the shared brain survives even if ad-hoc Codex MCP state drifts.
@@ -645,7 +645,7 @@ nexo scripts list  # See your personal scripts
 During install, NEXO now asks which interactive clients you want to connect, which one `nexo chat` should open by default, whether to enable background automation, which backend should run that automation, and which model profile each active terminal/backend should use. Shared brain stays on in every mode.
 
 Recommended defaults:
-- Claude Code: `Opus latest`
+- Claude Code: `Opus 4.6 with 1M context`
 - Codex: `gpt-5.4` with `xhigh` reasoning
 
 Or use the shell alias created during install (e.g. `atlas`), which now runs `nexo chat .` so it opens whichever terminal client you selected as default.
@@ -662,6 +662,9 @@ NEXO is being hardened in public, and the best contributions now are not only co
 
 The project still recommends Claude Code as the primary path, but contributions that improve Codex, client parity, installer clarity, and ecosystem integrations are especially valuable.
 
+Maintainers and contributors touching startup, bootstrap, Deep Sleep, or shared-brain behavior should also use the client parity checklist:
+- [docs/client-parity-checklist.md](docs/client-parity-checklist.md)
+
 ### What Gets Installed
 
 | Component | What | Where |
@@ -723,7 +726,7 @@ The Doctor system reads existing health artifacts (immune, watchdog, self-audit)
 - **macOS or Linux** (Windows via [WSL](https://learn.microsoft.com/en-us/windows/wsl/install))
 - **Node.js 18+** (for the installer)
 - **Claude Code is the primary recommended client.** It remains the most mature NEXO path: native hooks, the most battle-tested automation contract, and the clearest parity with historical production behavior.
-- **Recommended profiles:** Claude Code + `Opus latest`; Codex + `gpt-5.4` with `xhigh` reasoning if you prefer Codex as your terminal or automation backend.
+- **Recommended profiles:** Claude Code + `Opus 4.6 with 1M context`; Codex + `gpt-5.4` with `xhigh` reasoning if you prefer Codex as your terminal or automation backend.
 - Python 3, Homebrew, and the selected required client/backend can be installed automatically when NEXO has a supported installer path for that dependency.
 
 ## Architecture
@@ -830,7 +833,7 @@ NEXO Brain is designed as an MCP server. Claude Code remains the primary recomme
 npx nexo-brain
 ```
 
-All 150+ tools are available immediately after installation. The installer configures Claude Code's `~/.claude/settings.json` automatically. The recommended Claude profile is `Opus latest`.
+All 150+ tools are available immediately after installation. The installer configures Claude Code's `~/.claude/settings.json` automatically. The recommended Claude profile is `Opus 4.6 with 1M context`.
 
 ### Claude Desktop
 
@@ -920,6 +923,7 @@ If NEXO Brain is useful to you, consider:
 - **[Sponsor on GitHub](https://github.com/sponsors/wazionapps)** — support ongoing development directly
 - **Share your experience** — tell others how you're using cognitive memory in your AI workflows
 - **Contribute** — see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome
+- **Client parity / shared-brain maintenance** — see [docs/client-parity-checklist.md](docs/client-parity-checklist.md)
 
 [![Star History Chart](https://api.star-history.com/svg?repos=wazionapps/nexo&type=Date)](https://star-history.com/#wazionapps/nexo&Date)
 

package/bin/nexo-brain.js

@@ -33,6 +33,10 @@ const LAUNCH_AGENTS = path.join(
 );
 const MACOS_FDA_SETTINGS_URL = "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles";
 const PUBLIC_CONTRIBUTION_UPSTREAM = "wazionapps/nexo";
+const DEFAULT_CLAUDE_CODE_MODEL = "claude-opus-4-6[1m]";
+const DEFAULT_CLAUDE_CODE_REASONING_EFFORT = "";
+const DEFAULT_CODEX_MODEL = "gpt-5.4";
+const DEFAULT_CODEX_REASONING_EFFORT = "xhigh";
 
 function isEphemeralInstall(nexoHome) {
   const homeDir = require("os").homedir();
@@ -480,12 +484,12 @@ function getDefaultSchedule(timezone) {
     automation_backend: "claude_code",
     client_runtime_profiles: {
       claude_code: {
-        model: "opus",
-        reasoning_effort: "",
+        model: DEFAULT_CLAUDE_CODE_MODEL,
+        reasoning_effort: DEFAULT_CLAUDE_CODE_REASONING_EFFORT,
       },
       codex: {
-        model: "gpt-5.4",
-        reasoning_effort: "xhigh",
+        model: DEFAULT_CODEX_MODEL,
+        reasoning_effort: DEFAULT_CODEX_REASONING_EFFORT,
       },
     },
     client_install_preferences: {
@@ -656,12 +660,12 @@ async function askChoice(question, options, defaultValue) {
 function defaultClientRuntimeProfiles() {
   return {
     claude_code: {
-      model: "opus",
-      reasoning_effort: "",
+      model: DEFAULT_CLAUDE_CODE_MODEL,
+      reasoning_effort: DEFAULT_CLAUDE_CODE_REASONING_EFFORT,
     },
     codex: {
-      model: "gpt-5.4",
-      reasoning_effort: "xhigh",
+      model: DEFAULT_CODEX_MODEL,
+      reasoning_effort: DEFAULT_CODEX_REASONING_EFFORT,
     },
   };
 }
@@ -690,10 +694,11 @@ function runtimeProfileCatalog(lang, client) {
       customModelQuestionEn: `  Enter the model alias/name for ${runtimeClientLabel(client)} > `,
       customEffortQuestion: `  Escribe el effort para ${runtimeClientLabel(client)} (vacío = default) > `,
       customEffortQuestionEn: `  Enter the effort for ${runtimeClientLabel(client)} (blank = default) > `,
-      modelDefault: "opus",
+      modelDefault: DEFAULT_CLAUDE_CODE_MODEL,
       effortDefault: "",
       modelOptions: [
-        { value: "opus", label: `Opus latest${recommended}` },
+        { value: DEFAULT_CLAUDE_CODE_MODEL, label: `Opus 4.6 with 1M context${recommended}` },
+        { value: "claude-opus-4-6", label: "Opus 4.6" },
         { value: "sonnet", label: "Sonnet latest" },
         { value: "custom", label: lang === "es" ? "Modelo personalizado" : "Custom model" },
       ],
@@ -715,8 +720,8 @@ function runtimeProfileCatalog(lang, client) {
     customModelQuestionEn: `  Enter the model name for ${runtimeClientLabel(client)} > `,
     customEffortQuestion: `  Escribe el reasoning effort para ${runtimeClientLabel(client)} > `,
     customEffortQuestionEn: `  Enter the reasoning effort for ${runtimeClientLabel(client)} > `,
-    modelDefault: "gpt-5.4",
-    effortDefault: "xhigh",
+    modelDefault: DEFAULT_CODEX_MODEL,
+    effortDefault: DEFAULT_CODEX_REASONING_EFFORT,
     modelOptions: [
       { value: "gpt-5.4", label: `GPT-5.4${recommended}` },
       { value: "gpt-5.4-pro", label: "GPT-5.4 Pro" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "2.6.18",
+  "version": "2.6.20",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain — Shared brain for AI agents. Persistent memory, semantic RAG, natural forgetting, metacognitive guard, trust scoring, 150+ MCP tools. Works with Claude Code, Codex, Claude Desktop & any MCP client. 100% local, free.",
   "homepage": "https://nexo-brain.com",

package/src/agent_runner.py

@@ -229,6 +229,9 @@ def _resolve_runtime_model_and_effort(
     if client == CLIENT_CODEX:
         if not requested_model or requested_model.lower() in CLAUDE_LEGACY_MODEL_HINTS:
             requested_model = profile["model"]
+    elif client == CLIENT_CLAUDE_CODE:
+        if not requested_model or requested_model.lower() in CLAUDE_LEGACY_MODEL_HINTS:
+            requested_model = profile["model"]
     elif not requested_model:
         requested_model = profile["model"]
 

package/src/client_preferences.py

@@ -36,18 +36,10 @@ INSTALL_PREFERENCE_KEYS = {
     "skip",
     "manual",
 }
-DEFAULT_CLIENT_RUNTIME_PROFILES = {
-    CLIENT_CLAUDE_CODE: {
-        "model": "opus",
-        "reasoning_effort": "",
-    },
-    CLIENT_CODEX: {
-        "model": "gpt-5.4",
-        "reasoning_effort": "xhigh",
-    },
-}
-
-
+DEFAULT_CLAUDE_CODE_MODEL = "claude-opus-4-6[1m]"
+DEFAULT_CLAUDE_CODE_REASONING_EFFORT = ""
+DEFAULT_CODEX_MODEL = "gpt-5.4"
+DEFAULT_CODEX_REASONING_EFFORT = "xhigh"
 def _user_home() -> Path:
     return Path(os.environ.get("HOME", str(Path.home()))).expanduser()
 
@@ -225,8 +217,14 @@ def normalize_client_install_preferences(value) -> dict[str, str]:
 
 def default_client_runtime_profiles() -> dict[str, dict[str, str]]:
     return {
-        client_key: dict(profile)
-        for client_key, profile in DEFAULT_CLIENT_RUNTIME_PROFILES.items()
+        CLIENT_CLAUDE_CODE: {
+            "model": DEFAULT_CLAUDE_CODE_MODEL,
+            "reasoning_effort": DEFAULT_CLAUDE_CODE_REASONING_EFFORT,
+        },
+        CLIENT_CODEX: {
+            "model": DEFAULT_CODEX_MODEL,
+            "reasoning_effort": DEFAULT_CODEX_REASONING_EFFORT,
+        },
     }
 
 

package/src/client_sync.py

@@ -55,7 +55,7 @@ except Exception:
 
     def resolve_client_runtime_profile(client: str, preferences: dict | None = None) -> dict:
         defaults = {
-            "claude_code": {"model": "opus", "reasoning_effort": ""},
+            "claude_code": {"model": "claude-opus-4-6[1m]", "reasoning_effort": ""},
             "codex": {"model": "gpt-5.4", "reasoning_effort": "xhigh"},
         }
         return dict(defaults.get(client, {}))

package/src/runtime_power.py

@@ -65,6 +65,10 @@ MACOS_FDA_PROBE_PATHS = (
     Path.home() / "Library" / "Safari",
     Path.home() / "Library" / "Application Support" / "AddressBook",
 )
+DEFAULT_CLAUDE_CODE_MODEL = "claude-opus-4-6[1m]"
+DEFAULT_CLAUDE_CODE_REASONING_EFFORT = ""
+DEFAULT_CODEX_MODEL = "gpt-5.4"
+DEFAULT_CODEX_REASONING_EFFORT = "xhigh"
 
 
 def _schedule_defaults() -> dict:
@@ -81,12 +85,12 @@ def _schedule_defaults() -> dict:
         "automation_backend": "claude_code",
         "client_runtime_profiles": {
             "claude_code": {
-                "model": "opus",
-                "reasoning_effort": "",
+                "model": DEFAULT_CLAUDE_CODE_MODEL,
+                "reasoning_effort": DEFAULT_CLAUDE_CODE_REASONING_EFFORT,
             },
             "codex": {
-                "model": "gpt-5.4",
-                "reasoning_effort": "xhigh",
+                "model": DEFAULT_CODEX_MODEL,
+                "reasoning_effort": DEFAULT_CODEX_REASONING_EFFORT,
             },
         },
         "client_install_preferences": {