@agentprojectcontext/apx 1.9.0 → 1.10.0

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.0",
   "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/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

@@ -745,9 +745,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."],
     ],
@@ -1148,7 +1148,7 @@ function buildHelp(version) {
 
     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"),

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"

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.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();