karajan-code 1.34.3 → 1.34.4

package/README.md

@@ -116,7 +116,7 @@ hu-reviewer? → triage → discover? → architect? → planner? → coder →
 | **Claude** | `claude` | `npm install -g @anthropic-ai/claude-code` |
 | **Codex** | `codex` | `npm install -g @openai/codex` |
 | **Gemini** | `gemini` | See [Gemini CLI docs](https://github.com/google-gemini/gemini-cli) |
-| **Aider** | `aider` | `pip install aider-chat` |
+| **Aider** | `aider` | `pipx install aider-chat` (or `pip3 install aider-chat`) |
 | **OpenCode** | `opencode` | See [OpenCode docs](https://github.com/nicepkg/opencode) |
 
 Mix and match. Use Claude as coder and Codex as reviewer. Karajan auto-detects installed agents during `kj init`.

package/docs/README.es.md

@@ -124,7 +124,7 @@ Guias completas: [`docs/multi-instance.md`](multi-instance.md) | [`docs/install-
 | **Claude** | `claude` | `npm install -g @anthropic-ai/claude-code` |
 | **Codex** | `codex` | `npm install -g @openai/codex` |
 | **Gemini** | `gemini` | Ver [Gemini CLI docs](https://github.com/google-gemini/gemini-cli) |
-| **Aider** | `aider` | `pip install aider-chat` |
+| **Aider** | `aider` | `pipx install aider-chat` (o `pip3 install aider-chat`) |
 
 `kj init` auto-detecta los agentes instalados. Si solo hay uno disponible, se asigna a todos los roles automaticamente.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "1.34.3",
+  "version": "1.34.4",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/src/commands/doctor.js

@@ -8,6 +8,7 @@ import { isSonarReachable } from "../sonar/manager.js";
 import { resolveRoleMdPath, loadFirstExisting } from "../roles/base-role.js";
 import { ensureGitRepo } from "../utils/git.js";
 import { checkBinary, KNOWN_AGENTS } from "../utils/agent-detect.js";
+import { getInstallCommand } from "../utils/os-detect.js";
 
 function getPackageVersion() {
   const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
@@ -205,7 +206,7 @@ async function checkBecariaInfra(config) {
 }
 
 async function checkRtk() {
-  const NOT_FOUND_DETAIL = "Not found — install for 60-90% token savings: brew install rtk";
+  const NOT_FOUND_DETAIL = `Not found — install for 60-90% token savings: ${getInstallCommand("rtk")}`;
   let detail = NOT_FOUND_DETAIL;
   try {
     const res = await runCommand("rtk", ["--version"]);

package/src/commands/init.js

@@ -8,6 +8,7 @@ import { getKarajanHome } from "../utils/paths.js";
 import { detectAvailableAgents } from "../utils/agent-detect.js";
 import { createWizard, isTTY } from "../utils/wizard.js";
 import { runCommand } from "../utils/process.js";
+import { getInstallCommand } from "../utils/os-detect.js";
 
 async function runWizard(config, logger) {
   const agents = await detectAvailableAgents();
@@ -292,7 +293,7 @@ export async function initCommand({ logger, flags = {} }) {
   if (!hasRtk) {
     logger.info("");
     logger.info("RTK (Rust Token Killer) can reduce token usage by 60-90%.");
-    logger.info("  Install: brew install rtk && rtk init --global");
+    logger.info(`  Install: ${getInstallCommand("rtk")}`);
   }
 
   await setupSonarQube(config, logger);

package/src/utils/agent-detect.js

@@ -1,12 +1,13 @@
 import { runCommand } from "./process.js";
 import { resolveBin } from "../agents/resolve-bin.js";
+import { getInstallCommand } from "./os-detect.js";
 
 const KNOWN_AGENTS = [
-  { name: "claude", install: "npm install -g @anthropic-ai/claude-code" },
-  { name: "codex", install: "npm install -g @openai/codex" },
-  { name: "gemini", install: "npm install -g @google/gemini-cli (or check https://geminicli.com/docs/get-started/installation/)" },
-  { name: "aider", install: "pip install aider-chat" },
-  { name: "opencode", install: "curl -fsSL https://opencode.ai/install | bash (or see https://opencode.ai)" }
+  { name: "claude", install: getInstallCommand("claude") },
+  { name: "codex", install: getInstallCommand("codex") },
+  { name: "gemini", install: getInstallCommand("gemini") },
+  { name: "aider", install: getInstallCommand("aider") },
+  { name: "opencode", install: getInstallCommand("opencode") }
 ];
 
 export async function checkBinary(name, versionArg = "--version") {

package/src/utils/os-detect.js

@@ -0,0 +1,45 @@
+import os from "node:os";
+
+/**
+ * Detect platform and return OS-appropriate install commands.
+ */
+export function getPlatform() {
+  const platform = os.platform();
+  return platform === "darwin" ? "macos" : "linux";
+}
+
+const INSTALL_COMMANDS = {
+  rtk: {
+    macos: "brew install rtk && rtk init --global",
+    linux: "curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh && rtk init --global"
+  },
+  claude: {
+    macos: "npm install -g @anthropic-ai/claude-code",
+    linux: "npm install -g @anthropic-ai/claude-code"
+  },
+  codex: {
+    macos: "npm install -g @openai/codex",
+    linux: "npm install -g @openai/codex"
+  },
+  gemini: {
+    macos: "npm install -g @google/gemini-cli",
+    linux: "npm install -g @google/gemini-cli"
+  },
+  aider: {
+    macos: "pipx install aider-chat",
+    linux: "pipx install aider-chat || pip3 install aider-chat"
+  },
+  opencode: {
+    macos: "curl -fsSL https://opencode.ai/install | bash",
+    linux: "curl -fsSL https://opencode.ai/install | bash"
+  },
+  docker: {
+    macos: "brew install --cask docker",
+    linux: "sudo apt install docker.io docker-compose-v2 (or see https://docs.docker.com/engine/install/)"
+  }
+};
+
+export function getInstallCommand(tool) {
+  const platform = getPlatform();
+  return INSTALL_COMMANDS[tool]?.[platform] || INSTALL_COMMANDS[tool]?.linux || `Install ${tool} manually`;
+}