@agentprojectcontext/apx 1.9.0 → 1.10.1

package/README.md

@@ -26,7 +26,7 @@ npm install -g apx
 # In any directory with an AGENTS.md
 apx init
 
-# Spawn an agent with a full Claude Code runtime
+# Spawn an agent with a full external runtime
 apx run sofia --runtime claude-code "Review the open PRs and summarize them"
 
 # Or a quick one-shot LLM exec
@@ -84,6 +84,7 @@ apx memory <slug>                        # read agent memory
 apx memory <slug> --append "<note>"      # append to memory
 
 apx run   <slug> --runtime claude-code "<prompt>"   # full runtime session
+apx run   <slug> --runtime cursor-agent "<prompt>"  # Cursor Agent runtime
 apx exec  <slug> "<prompt>"                          # quick LLM call
 
 apx session list <slug>                  # list past sessions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/skills/apx/SKILL.md

@@ -26,6 +26,11 @@ apx mcp list                            # MCP servers available to this project
 # Full external session (best for complex, multi-step tasks)
 apx run <slug> --runtime claude-code "<prompt>"
 apx run <slug> --runtime codex        "<prompt>"
+apx run <slug> --runtime opencode     "<prompt>"
+apx run <slug> --runtime aider        "<prompt>"
+apx run <slug> --runtime cursor-agent "<prompt>"
+apx run <slug> --runtime gemini-cli   "<prompt>"
+apx run <slug> --runtime qwen-code    "<prompt>"
 
 # Quick one-shot LLM call (requires engine API key in ~/.apx/config.json)
 apx exec <slug> "<prompt>"

package/src/cli/commands/command.js

@@ -2,6 +2,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import { findApfRoot } from "../../core/parser.js";
+import { http } from "../http.js";
+import { resolveProjectId } from "./project.js";
 
 function commandsDir(root) {
   return path.join(root, ".apc", "commands");
@@ -13,9 +15,28 @@ function listCommandFiles(root) {
   return fs.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
 }
 
-export function cmdCommandList() {
+async function resolveCommandRoot(args = {}) {
+  const explicitProject = args?.flags?.project;
+  if (explicitProject !== undefined && explicitProject !== null && explicitProject !== "") {
+    const pid = await resolveProjectId(explicitProject);
+    const projects = await http.get("/projects");
+    const project = projects.find((p) => p.id === pid);
+    if (!project) throw new Error(`project ${pid} not found`);
+    return project.path;
+  }
+
   const root = findApfRoot();
-  if (!root) throw new Error("not inside an APC project");
+  if (root) return root;
+
+  const pid = await resolveProjectId();
+  const projects = await http.get("/projects");
+  const project = projects.find((p) => p.id === pid);
+  if (!project) throw new Error(`project ${pid} not found`);
+  return project.path;
+}
+
+export async function cmdCommandList(args = {}) {
+  const root = await resolveCommandRoot(args);
   const files = listCommandFiles(root);
   if (files.length === 0) {
     console.log("(no commands — add .md files to .apc/commands/)");
@@ -31,11 +52,10 @@ export function cmdCommandList() {
   }
 }
 
-export function cmdCommandShow(args) {
+export async function cmdCommandShow(args) {
   const name = args._[0];
   if (!name) throw new Error("apx command show: missing <name>");
-  const root = findApfRoot();
-  if (!root) throw new Error("not inside an APC project");
+  const root = await resolveCommandRoot(args);
   const file = path.join(commandsDir(root), `${name}.md`);
   if (!fs.existsSync(file)) throw new Error(`command "${name}" not found in .apc/commands/`);
   process.stdout.write(fs.readFileSync(file, "utf8"));

package/src/cli/commands/runtime.js

@@ -5,7 +5,7 @@ export async function cmdRun(args) {
   const slug = args._[0];
   if (!slug) throw new Error("apx run: usage: apx run <agent> --runtime <id> \"<prompt>\"");
   const runtime = args.flags.runtime === true ? null : args.flags.runtime;
-  if (!runtime) throw new Error("apx run: --runtime required (claude-code | codex | opencode | aider)");
+  if (!runtime) throw new Error("apx run: --runtime required (claude-code | codex | opencode | aider | cursor-agent | gemini-cli | qwen-code)");
 
   let prompt = args._.slice(1).join(" ").trim();
   if (!prompt || prompt === "-") {

package/src/cli/commands/sys.js

@@ -102,16 +102,21 @@ export async function cmdSys(args) {
       return;
     }
 
-    if (handleEditingKey(str, key, state, renderScreen)) return;
-
-    if (key.name === "return") {
+    if (isReturnKey(key)) {
       isRequesting = true;
       await submitPrompt(pid, state, previousMessages, renderScreen, close);
       isRequesting = false;
+      return;
     }
+
+    if (handleEditingKey(str, key, state, renderScreen)) return;
   });
 }
 
+export function isReturnKey(key) {
+  return key?.name === "return" || key?.name === "enter";
+}
+
 async function handlePaletteKey(key, cfg, state, renderScreen, close) {
   if (key.name === "up") {
     state.paletteSelection = Math.max(0, state.paletteSelection - 1);
@@ -189,7 +194,7 @@ function loadModelOptions(cfg, state, renderScreen) {
     });
 }
 
-function handleEditingKey(str, key, state, renderScreen) {
+export function handleEditingKey(str, key, state, renderScreen) {
   if (key.name === "tab") {
     state.currentModeIdx = (state.currentModeIdx + 1) % MODES.length;
     renderScreen();
@@ -261,7 +266,7 @@ function handleEditingKey(str, key, state, renderScreen) {
     return true;
   }
 
-  if (str && str.length === 1 && !key.ctrl && !key.meta) {
+  if (str && str.length === 1 && !key.ctrl && !key.meta && str >= " ") {
     state.inputText = state.inputText.slice(0, state.cursorIndex) + str + state.inputText.slice(state.cursorIndex);
     state.cursorIndex += str.length;
     renderScreen();

package/src/cli/index.js

@@ -60,7 +60,7 @@ import {
   cmdConversationsList,
   cmdConversationsGet,
 } from "./commands/chat.js";
-import { cmdSys } from "./commands/sys.js";
+import { cmdSys as cmdCode } from "./commands/sys.js";
 import { cmdRun, cmdEnvDetect } from "./commands/runtime.js";
 import { cmdSend, cmdConnections } from "./commands/a2a.js";
 import {
@@ -184,7 +184,7 @@ const HELP_TOPICS = new Map(Object.entries({
     title: "apx project add",
     summary: "Register a project with the APX daemon.",
     usage: ["apx project add [path]"],
-    examples: ["apx project add .", "apx add project ../repo"],
+    examples: ["apx project add .", "apx project add ../repo"],
   }),
   "project list": topic({
     title: "apx project list",
@@ -204,19 +204,6 @@ const HELP_TOPICS = new Map(Object.entries({
     usage: ["apx project rebuild [id]"],
     examples: ["apx project rebuild", "apx project rebuild default"],
   }),
-  add: topic({
-    title: "apx add",
-    summary: "Friendly alias namespace for add operations.",
-    usage: ["apx add project [path]"],
-    commands: [["project [path]", "Alias for apx project add [path]."]],
-    examples: ["apx add project ."],
-  }),
-  "add project": topic({
-    title: "apx add project",
-    summary: "Alias for apx project add.",
-    usage: ["apx add project [path]"],
-    examples: ["apx add project ."],
-  }),
   agent: topic({
     title: "apx agent",
     summary: "Create, inspect, import, and vault agent definitions.",
@@ -298,7 +285,7 @@ const HELP_TOPICS = new Map(Object.entries({
   }),
   identity: topic({
     title: "apx identity",
-    summary: "Read or edit daemon identity fields.",
+    summary: "Read or edit APX profile identity fields.",
     usage: ["apx identity <show|set|wizard> [args]"],
     commands: [
       ["show", "Print current identity."],
@@ -309,13 +296,13 @@ const HELP_TOPICS = new Map(Object.entries({
   }),
   "identity show": topic({
     title: "apx identity show",
-    summary: "Print current daemon identity.",
+    summary: "Print current APX profile identity.",
     usage: ["apx identity show"],
     examples: ["apx identity show"],
   }),
   "identity set": topic({
     title: "apx identity set",
-    summary: "Set one daemon identity field.",
+    summary: "Set one APX profile identity field.",
     usage: ["apx identity set <key> <value>"],
     examples: ["apx identity set agent_name Ada", "apx identity set owner_name Sam"],
   }),
@@ -364,7 +351,7 @@ const HELP_TOPICS = new Map(Object.entries({
   }),
   permission: topic({
     title: "apx permission",
-    summary: "Show or set super-agent permission mode.",
+    summary: "Show or set APX tool permission mode.",
     usage: ["apx permission show", "apx permission set <total|automatico|permiso>"],
     commands: [
       ["show", "Print current permission mode."],
@@ -374,13 +361,13 @@ const HELP_TOPICS = new Map(Object.entries({
   }),
   "permission show": topic({
     title: "apx permission show",
-    summary: "Print current super-agent permission mode.",
+    summary: "Print current APX tool permission mode.",
     usage: ["apx permission show"],
     examples: ["apx permission show"],
   }),
   "permission set": topic({
     title: "apx permission set",
-    summary: "Set super-agent permission mode.",
+    summary: "Set APX tool permission mode.",
     usage: ["apx permission set <total|automatico|permiso>"],
     examples: ["apx permission set permiso"],
   }),
@@ -702,14 +689,14 @@ const HELP_TOPICS = new Map(Object.entries({
     ],
     examples: ["apx chat reviewer", "apx chat reviewer --conversation abc123"],
   }),
-  sys: topic({
-    title: "apx sys",
-    summary: "Start an interactive super-agent chat REPL with system and workspace context.",
-    usage: ["apx sys [--project <name|id|path>]"],
+  code: topic({
+    title: "apx code",
+    summary: "Start the APX terminal coding assistant with system and workspace context.",
+    usage: ["apx code [--project <name|id|path>]"],
     options: [
       ["--project <name|id|path>", "Pin command to a specific project."],
     ],
-    examples: ["apx sys", "apx sys --project default"],
+    examples: ["apx code", "apx code --project default"],
   }),
   conversations: topic({
     title: "apx conversations",
@@ -745,9 +732,9 @@ const HELP_TOPICS = new Map(Object.entries({
   run: topic({
     title: "apx run",
     summary: "Launch a full external runtime session for an agent.",
-    usage: ["apx run <agent> --runtime <claude-code|codex|opencode|aider> \"<prompt>\" [--timeout <seconds>] [--project <name|id|path>]"],
+    usage: ["apx run <agent> --runtime <claude-code|codex|opencode|aider|cursor-agent|gemini-cli|qwen-code> \"<prompt>\" [--timeout <seconds>] [--project <name|id|path>]"],
     options: [
-      ["--runtime <id>", "Runtime CLI to launch: claude-code, codex, opencode, aider."],
+      ["--runtime <id>", "Runtime CLI to launch: claude-code, codex, opencode, aider, cursor-agent, gemini-cli, qwen-code."],
       ["--timeout <seconds>", "Runtime timeout."],
       ["--project <name|id|path>", "Pin command to a specific project."],
     ],
@@ -779,17 +766,10 @@ const HELP_TOPICS = new Map(Object.entries({
   connections: topic({
     title: "apx connections",
     summary: "Show an agent communication map.",
-    usage: ["apx connections <agent> [--project <name|id|path>]", "apx graph <agent> [--project <name|id|path>]"],
+    usage: ["apx connections <agent> [--project <name|id|path>]"],
     options: [["--project <name|id|path>", "Pin command to a specific project."]],
     examples: ["apx connections reviewer"],
   }),
-  graph: topic({
-    title: "apx graph",
-    summary: "Alias for apx connections.",
-    usage: ["apx graph <agent> [--project <name|id|path>]"],
-    options: [["--project <name|id|path>", "Pin command to a specific project."]],
-    examples: ["apx graph reviewer"],
-  }),
   routine: topic({
     title: "apx routine",
     summary: "Manage scheduled APX routines.",
@@ -931,11 +911,12 @@ const HELP_TOPICS = new Map(Object.entries({
   command: topic({
     title: "apx command",
     summary: "List or show workflow commands from .apc/commands/.",
-    usage: ["apx command [list]", "apx command show <name>"],
+    usage: ["apx command [list] [--project <name|id|path>]", "apx command show <name> [--project <name|id|path>]"],
     commands: [
       ["list | ls", "List workflow commands."],
       ["show | get <name>", "Print one command file."],
     ],
+    options: [["--project <name|id|path>", "Pin command to a specific project; defaults to current APC project or default."]],
     examples: ["apx command list", "apx command show release"],
   }),
   commands: topic({
@@ -947,13 +928,15 @@ const HELP_TOPICS = new Map(Object.entries({
   "command list": topic({
     title: "apx command list",
     summary: "List workflow commands in .apc/commands/.",
-    usage: ["apx command list", "apx command ls"],
+    usage: ["apx command list [--project <name|id|path>]", "apx command ls [--project <name|id|path>]"],
+    options: [["--project <name|id|path>", "Pin command to a specific project; defaults to current APC project or default."]],
     examples: ["apx command list"],
   }),
   "command show": topic({
     title: "apx command show",
     summary: "Print one workflow command file.",
-    usage: ["apx command show <name>", "apx command get <name>"],
+    usage: ["apx command show <name> [--project <name|id|path>]", "apx command get <name> [--project <name|id|path>]"],
+    options: [["--project <name|id|path>", "Pin command to a specific project; defaults to current APC project or default."]],
     examples: ["apx command show release"],
   }),
   skills: topic({
@@ -1019,6 +1002,7 @@ const HELP_TOPICS = new Map(Object.entries({
 const HELP_ALIASES = new Map(Object.entries({
   "project ls": "project list",
   "project rm": "project remove",
+  "sys": "code",
   "agent ls": "agent list",
   "agent show": "agent get",
   "agent vault ls": "agent vault list",
@@ -1074,11 +1058,12 @@ function buildHelp(version) {
     hCmd("apx setup",                  36, "interactive wizard: provider → model → channels → daemon  (alias: install)"),
     hCmd("apx status",                 36, "full system status: daemon, super-agent, engines, telegram, projects"),
     hCmd("apx update",                 36, "check for updates and upgrade  (alias: upgrade)"),
+
+    hSec("Projects"),
     hCmd("apx project add [path]",     36, "register a project with the daemon"),
     hCmd("apx project list",           36, ""),
     hCmd("apx project remove <id>",    36, ""),
     hCmd("apx project rebuild [id]",   36, "rebuild project index from filesystem"),
-    hCmd("apx add project [path]",     36, "alias for: apx project add"),
 
     hSec("Agents"),
     hCmd("apx agent add <slug>",       36, "--role R  --model M  --skills a,b  --language es-AR  --description D"),
@@ -1088,15 +1073,16 @@ function buildHelp(version) {
     hCmd("apx agent vault list",       36, ""),
     hCmd("apx agent vault add",        36, ""),
 
-    hSec("Identity & Config"),
-    hCmd("apx identity show",          36, "print current agent identity (name, owner, personality)"),
+    hSec("APX Profile"),
+    hCmd("apx identity show",          36, "print current APX identity (name, owner, personality)"),
     hCmd("apx identity set <k> <v>",   36, "set identity field"),
     hCmd("apx identity wizard",        36, "interactive identity setup"),
+
+    hSec("Config"),
     hCmd("apx config show",            36, "--effective  --only-overrides"),
-    hCmd("apx config set <key> <val>", 36, "set key in .apc/config.json  (JSON-aware)"),
-    hCmd("apx permission show",        36, "show super-agent permission mode"),
+    hCmd("apx config set|unset",       36, "<key> [value]  edit .apc/config.json  (JSON-aware)"),
+    hCmd("apx permission show",        36, "show APX tool permission mode"),
     hCmd("apx permission set <mode>",  36, "mode: total | automatico | permiso"),
-    hCmd("apx config unset <key>",     36, "remove key from .apc/config.json"),
 
     hSec("Memory"),
     hCmd("apx memory <slug>",          36, "print memory.md"),
@@ -1123,7 +1109,7 @@ function buildHelp(version) {
     hCmd("apx mcp tools <name>",       36, "list available tools"),
     hCmd("apx mcp check",              36, "audit multi-source merge"),
 
-    hSec("Daemon"),
+    hSec("Daemon Service"),
     hCmd("apx daemon start",           36, ""),
     hCmd("apx daemon stop",            36, ""),
     hCmd("apx daemon status",          36, ""),
@@ -1139,22 +1125,21 @@ function buildHelp(version) {
     hCmd("apx messages chat",          36, "--channel telegram  -n 50"),
     hCmd("apx messages search \"q\"",  36, ""),
 
-    hSec("LLM / Chat"),
-    hCmd("apx exec <agent> \"prompt\"",36, "--model <id>  --max-tokens N  --temperature T"),
-    hCmd("apx chat <agent>",           36, "--conversation <id>  --model <id>  (interactive REPL)"),
-    hCmd("apx sys",                    36, "super-agent chat w/ system+workspace context"),
-    hCmd("apx conversations list",     36, "<agent>"),
+    hSec("LLM / Code"),
+    hCmd("apx code",                   36, "APX terminal coding assistant"),
+    hCmd("apx exec <agent> \"prompt\"",36, "one-shot agent call  --model <id>  --max-tokens N"),
+    hCmd("apx chat <agent>",           36, "interactive agent REPL  --conversation <id>"),
+    hCmd("apx conversations list",     36, "stored exec/chat conversations for <agent>"),
     hCmd("apx conversations get",      36, "<agent> <id>"),
 
     hSec("Runtimes"),
     hCmd("apx run <agent>",            36, "--runtime <id> \"prompt\"  --timeout <s>"),
-    `                                        ${H.DI}runtimes: claude-code | codex | opencode | aider${H.R}`,
+    `                                        ${H.DI}runtimes: claude-code | codex | opencode | aider | cursor-agent | gemini-cli | qwen-code${H.R}`,
     hCmd("apx env detect",             36, "which agent CLIs are installed"),
 
     hSec("Agent-to-Agent"),
     hCmd("apx send <from> <to> \"msg\"",36, "--deliver  log A2A message; --deliver runs target engine"),
     hCmd("apx connections <agent>",    36, "mental map: who/how/when this agent talked"),
-    hCmd("apx graph <agent>",          36, "alias for connections"),
 
     hSec("Routines & Pipeline"),
     hCmd("apx routine list",           36, "list routines + next/last run"),
@@ -1452,8 +1437,9 @@ async function dispatch(cmd, rest) {
         await cmdChat(parseArgs(rest));
         break;
 
+      case "code":
       case "sys":
-        await cmdSys(parseArgs(rest));
+        await cmdCode(parseArgs(rest));
         break;
 
       case "conversations":
@@ -1482,7 +1468,6 @@ async function dispatch(cmd, rest) {
         break;
 
       case "connections":
-      case "graph":
         await cmdConnections(parseArgs(rest));
         break;
 
@@ -1543,8 +1528,8 @@ async function dispatch(cmd, rest) {
       case "commands": {
         const sub = rest[0];
         const a = parseArgs(rest.slice(1));
-        if (!sub || sub === "list" || sub === "ls") cmdCommandList();
-        else if (sub === "show" || sub === "get") cmdCommandShow(a);
+        if (!sub || sub === "list" || sub === "ls") await cmdCommandList(a);
+        else if (sub === "show" || sub === "get") await cmdCommandShow(a);
         else die(`unknown command subcommand: ${sub}`);
         break;
       }
@@ -1563,14 +1548,6 @@ async function dispatch(cmd, rest) {
         await cmdIdentity(parseArgs(rest));
         break;
 
-      case "add": {
-        // apx add <domain> [...args] — consistent alternative to apx <domain> add
-        const sub = rest[0];
-        if (sub === "project") await cmdProjectAdd(parseArgs(rest.slice(1)));
-        else die(`unknown 'add' subcommand: ${sub || "(none)"} — try: project`);
-        break;
-      }
-
       case "status":
         await cmdStatus();
         return; // skip checkForUpdate after status (avoid noise)

package/src/core/apc-context-skill.md

@@ -92,8 +92,8 @@ sanitized fact to `.apc/agents/<slug>/memory.md` only when useful and safe.
 ## APX
 
 APX can provide a local daemon, MCP management, Telegram bridge, routines, and runtime dispatch
-across Codex, Claude Code, OpenCode, Aider, or direct LLM engines. Those are APX runtime features,
-not APC portable-core requirements.
+across Codex, Claude Code, OpenCode, Aider, Cursor Agent, Gemini CLI, Qwen Code, or direct LLM
+engines. Those are APX runtime features, not APC portable-core requirements.
 
 The APX super-agent uses `~/.apx/projects/default` for system-level work when no project is named.
 APX routines can run heartbeat, shell, Telegram, project agent, or super-agent tasks on a schedule.

package/src/core/apx-skill.md

@@ -26,6 +26,10 @@ Use `apx run` only when:
 apx run <slug> --runtime claude-code "<prompt>"
 apx run <slug> --runtime codex        "<prompt>"
 apx run <slug> --runtime opencode     "<prompt>"
+apx run <slug> --runtime aider        "<prompt>"
+apx run <slug> --runtime cursor-agent "<prompt>"
+apx run <slug> --runtime gemini-cli   "<prompt>"
+apx run <slug> --runtime qwen-code    "<prompt>"
 
 # Example: run the qa agent in codex with a specific task
 apx run qa --runtime codex "run the full test suite and report failures"
@@ -84,7 +88,7 @@ apx messages tail --agent <slug> -n 20
 Message rows expose `type` (`user`, `agent`, `tool`, `system`) and `actor_id`; use `messages chat`
 when you need a readable transcript.
 
-## Super-agent permissions
+## APX tool permissions
 
 ```bash
 apx permission show

package/src/daemon/apc-runtime-context.js

@@ -1,4 +1,5 @@
-// Helpers that wrap external runtimes (Claude Code, Codex, OpenCode, Aider)
+// Helpers that wrap external runtimes (Claude Code, Codex, OpenCode, Aider,
+// Cursor Agent, Gemini CLI, Qwen Code)
 // with APC awareness:
 //
 //   1. Create an APX runtime session BEFORE the runtime starts.
@@ -6,7 +7,7 @@
 //      runtime knows the session id, the cwd of the project, and the apx
 //      commands it can use to update memory / append session notes.
 //   3. After the runtime returns, capture the external transcript path
-//      (Claude Code gives one, Codex/OpenCode/Aider don't yet) and write it
+//      (Claude Code gives one; most other runtimes don't yet) and write it
 //      into the APX session frontmatter.
 //   4. Close the session with a synthesised result (truncated stdout).
 //

package/src/daemon/env-detect.js

@@ -11,6 +11,7 @@ const PROBES = [
   { id: "aider",       binary: "aider",     args: ["--version"], category: "runtime" },
   { id: "gemini-cli",  binary: "gemini",    args: ["--version"], category: "runtime" },
   { id: "cursor-agent",binary: "cursor-agent", args: ["--version"], category: "runtime" },
+  { id: "qwen-code",   binary: "qwen",      args: ["--version"], category: "runtime" },
 
   // Local LLM runners (engines/)
   { id: "ollama",      binary: "ollama",    args: ["--version"], category: "engine" },

package/src/daemon/runtimes/cursor-agent.js

@@ -0,0 +1,34 @@
+// Cursor Agent runtime adapter. Uses print mode for non-interactive runs:
+//   cursor-agent --print --output-format text --trust --force "<prompt>"
+// Reference: https://docs.cursor.com/en/cli/headless
+
+import { runProcess } from "./_spawn.js";
+
+export default {
+  id: "cursor-agent",
+  binary: "cursor-agent",
+  versionFlag: "--version",
+
+  async run({ system, prompt, cwd, env, timeoutMs }) {
+    const fullPrompt = system ? `${system}\n\n---\n\n${prompt}` : prompt;
+    const r = await runProcess({
+      command: "cursor-agent",
+      args: [
+        "--print",
+        "--output-format", "text",
+        "--trust",
+        "--force",
+        fullPrompt,
+      ],
+      cwd,
+      env,
+      timeoutMs,
+    });
+    return {
+      exitCode: r.exitCode,
+      output: r.stdout.trim(),
+      stderr: r.stderr,
+      externalSessionPath: null,
+    };
+  },
+};

package/src/daemon/runtimes/gemini-cli.js

@@ -0,0 +1,32 @@
+// Gemini CLI runtime adapter. Uses headless prompt mode:
+//   gemini --prompt "<prompt>" --output-format text --approval-mode yolo
+// Reference: https://google-gemini.github.io/gemini-cli/docs/cli/headless.html
+
+import { runProcess } from "./_spawn.js";
+
+export default {
+  id: "gemini-cli",
+  binary: "gemini",
+  versionFlag: "--version",
+
+  async run({ system, prompt, cwd, env, timeoutMs }) {
+    const fullPrompt = system ? `${system}\n\n---\n\n${prompt}` : prompt;
+    const r = await runProcess({
+      command: "gemini",
+      args: [
+        "--prompt", fullPrompt,
+        "--output-format", "text",
+        "--approval-mode", "yolo",
+      ],
+      cwd,
+      env,
+      timeoutMs,
+    });
+    return {
+      exitCode: r.exitCode,
+      output: r.stdout.trim(),
+      stderr: r.stderr,
+      externalSessionPath: null,
+    };
+  },
+};

package/src/daemon/runtimes/index.js

@@ -1,5 +1,6 @@
 // Runtime adapters: spawn external agent CLIs (Claude Code, Codex, OpenCode,
-// Aider, ...) with the agent's system prompt + the prompt we want to run, and
+// Aider, Cursor Agent, Gemini CLI, Qwen Code, ...) with the agent's system
+// prompt + the prompt we want to run, and
 // capture their output. Unlike engines/ — which talk directly to model APIs —
 // runtimes/ delegate the whole conversation to the external tool. APX only
 // records the invocation, the prompt, the captured output, and where the tool
@@ -18,12 +19,18 @@ import claudeCode from "./claude-code.js";
 import codex from "./codex.js";
 import opencode from "./opencode.js";
 import aider from "./aider.js";
+import cursorAgent from "./cursor-agent.js";
+import geminiCli from "./gemini-cli.js";
+import qwenCode from "./qwen-code.js";
 
 const REGISTRY = {
   "claude-code": claudeCode,
   codex,
   opencode,
   aider,
+  "cursor-agent": cursorAgent,
+  "gemini-cli": geminiCli,
+  "qwen-code": qwenCode,
 };
 
 export const RUNTIME_IDS = Object.keys(REGISTRY);

package/src/daemon/runtimes/qwen-code.js

@@ -0,0 +1,36 @@
+// Qwen Code runtime adapter. Uses non-interactive mode:
+//   qwen --output-format text --approval-mode yolo "<prompt>"
+// Reference: https://qwenlm.github.io/qwen-code-docs/en/cli/index
+
+import { runProcess } from "./_spawn.js";
+
+export default {
+  id: "qwen-code",
+  binary: "qwen",
+  versionFlag: "--version",
+
+  async run({ system, prompt, cwd, env, timeoutMs }) {
+    const args = [
+      "--output-format", "text",
+      "--approval-mode", "yolo",
+    ];
+    if (system) {
+      args.push("--append-system-prompt", system);
+    }
+    args.push(prompt);
+
+    const r = await runProcess({
+      command: "qwen",
+      args,
+      cwd,
+      env,
+      timeoutMs,
+    });
+    return {
+      exitCode: r.exitCode,
+      output: r.stdout.trim(),
+      stderr: r.stderr,
+      externalSessionPath: null,
+    };
+  },
+};

package/src/daemon/super-agent-tools/tools/call-runtime.js

@@ -67,7 +67,7 @@ export default {
     type: "function",
     function: {
       name: "call_runtime",
-      description: "Spawn an external CLI runtime (Claude Code, Codex, OpenCode, Aider), optionally impersonating an APC agent.",
+      description: "Spawn an external CLI runtime (Claude Code, Codex, OpenCode, Aider, Cursor Agent, Gemini CLI, Qwen Code), optionally impersonating an APC agent.",
       parameters: {
         type: "object",
         properties: {
@@ -75,7 +75,7 @@ export default {
           agent: { type: "string", description: "Optional APC agent slug from AGENTS.md, not runtime name. Omit when the user did not name an agent." },
           runtime: {
             type: "string",
-            enum: ["claude-code", "codex", "opencode", "aider"],
+            enum: RUNTIME_IDS,
             description: "external CLI runtime",
           },
           prompt: { type: "string" },

package/src/daemon/super-agent-tools/tools/set-identity.js

@@ -7,7 +7,7 @@ export default {
     type: "function",
     function: {
       name: "set_identity",
-      description: "Update daemon identity fields. Persists to ~/.apx/identity.json.",
+      description: "Update APX profile identity fields. Persists to ~/.apx/identity.json.",
       parameters: {
         type: "object",
         properties: {

package/src/daemon/super-agent-tools/tools/set-permission-mode.js

@@ -9,7 +9,7 @@ export default {
     type: "function",
     function: {
       name: "set_permission_mode",
-      description: "Set the super-agent permission mode in ~/.apx/config.json. Modes: total, automatico, permiso.",
+      description: "Set APX tool permission mode in ~/.apx/config.json. Modes: total, automatico, permiso.",
       parameters: {
         type: "object",
         properties: {

package/src/daemon/super-agent.js

@@ -54,7 +54,7 @@ HARD RULES (do not deviate):
 8. You DO see recent prior turns of this chat as previous messages when applicable. **Use them ONLY to disambiguate references** (e.g. "el primero" → first project mentioned earlier). For ANY factual data — agent details, MCP details, file contents, memory — RE-CALL the tool. Past turns are context, not a cache. Models change, agents change, files change.
 9. /reset or /new from the user means "forget previous turns and answer this one fresh" — if you see those prefixes the operator already cleared the context for you.
 10. DELEGATION RULE: when the user asks an agent to do a task, use call_agent (unless they specify opening it in a runtime, then see rule 11).
-11. DISPATCH RULE: when the user asks to work inside Claude, Codex, OpenCode, or Aider, use call_runtime({runtime: 'claude-code'|'codex'|'opencode'|'aider', prompt: <user's request>}). If they explicitly name an agent to spawn, pass agent: <slug>. If they don't name an agent, DO NOT pass an agent argument. When an agent is passed, its memory + skills become the system prompt of the runtime.
+11. DISPATCH RULE: when the user asks to work inside Claude, Codex, OpenCode, Aider, Cursor, Gemini CLI, or Qwen Code, use call_runtime({runtime: 'claude-code'|'codex'|'opencode'|'aider'|'cursor-agent'|'gemini-cli'|'qwen-code', prompt: <user's request>}). If they explicitly name an agent to spawn, pass agent: <slug>. If they don't name an agent, DO NOT pass an agent argument. When an agent is passed, its memory + skills become the system prompt of the runtime.
 12. PROJECT RULE: when the user gives no project, use project "default". Do not infer a non-default project from old chat history unless the user references it. If they mention a path or project name, look it up or add it with add_project.
 13. VAULT RULE: when the user wants a new existing agent/template, call list_vault_agents first. If a suitable vault agent exists, import_agent into the chosen project. If none fits, say briefly what is missing.
 14. NO-PENDING RULE: never say "give me a second", "I will do it", or "I will try later" as a final answer. Either call the tool in this same turn or say what blocks you.

package/src/mcp/index.js

@@ -95,7 +95,7 @@ server.tool(
   {
     slug: z.string().describe("Agent slug"),
     prompt: z.string().describe("Prompt / task for the agent"),
-    runtime: z.string().optional().describe("Runtime: claude-code | codex (default: claude-code)"),
+    runtime: z.string().optional().describe("Runtime: claude-code | codex | opencode | aider | cursor-agent | gemini-cli | qwen-code (default: claude-code)"),
   },
   async ({ slug, prompt, runtime }) => {
     const proj = await resolveProject();