@agentprojectcontext/apx 1.8.2 → 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.8.2",
+  "version": "1.10.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"
@@ -29,6 +29,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "chalk": "^5.6.2",
+    "cli-cursor": "^5.0.0",
+    "cron-parser": "^5.5.0",
     "express": "^4.21.0",
     "node-fetch": "^3.3.2"
   },

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/artifact.js

@@ -0,0 +1,45 @@
+import { http } from "../http.js";
+import { resolveProjectId } from "./project.js";
+
+export async function cmdArtifactCreate(args) {
+  const name = args._[0];
+  if (!name) throw new Error("apx artifact create: missing <name>");
+  const pid = await resolveProjectId(args?.flags?.project);
+  const content = args.flags.content && args.flags.content !== true ? String(args.flags.content) : "";
+  const r = await http.post(`/projects/${pid}/artifacts`, { name, content });
+  console.log(r.path);
+}
+
+export async function cmdArtifactList(args = {}) {
+  const pid = await resolveProjectId(args?.flags?.project);
+  const rows = await http.get(`/projects/${pid}/artifacts`);
+  if (rows.length === 0) {
+    console.log(`(no artifacts in project #${pid})`);
+    return;
+  }
+  console.log(`project #${pid} artifacts:`);
+  console.log("NAME".padEnd(30) + " SIZE   MODIFIED");
+  for (const a of rows) {
+    console.log(
+      a.name.padEnd(30) + " " +
+      String(a.size).padEnd(6) + " " +
+      (a.modified || "—")
+    );
+  }
+}
+
+export async function cmdArtifactShow(args) {
+  const name = args._[0];
+  if (!name) throw new Error("apx artifact show: missing <name>");
+  const pid = await resolveProjectId(args?.flags?.project);
+  const r = await http.get(`/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
+  process.stdout.write(r.content);
+}
+
+export async function cmdArtifactRemove(args) {
+  const name = args._[0];
+  if (!name) throw new Error("apx artifact remove: missing <name>");
+  const pid = await resolveProjectId(args?.flags?.project);
+  await http.delete(`/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
+  console.log(`removed artifact "${name}"`);
+}

package/src/cli/commands/routine.js

@@ -67,9 +67,23 @@ export async function cmdRoutineAdd(args) {
   const allowed_tools = args.flags["allowed-tools"] && args.flags["allowed-tools"] !== true
     ? String(args.flags["allowed-tools"]).split(",").map((s) => s.trim()).filter(Boolean)
     : undefined;
+  // Pipeline: pre/post commands as comma-separated list or repeated --pre-commands flags.
+  const parseCmdList = (val) => {
+    if (!val || val === true) return undefined;
+    if (Array.isArray(val)) return val.flatMap((v) => String(v).split(",")).map((s) => s.trim()).filter(Boolean);
+    return String(val).split(",").map((s) => s.trim()).filter(Boolean);
+  };
+  const pre_commands = parseCmdList(args.flags["pre-commands"]);
+  const post_commands = parseCmdList(args.flags["post-commands"]);
+  const skip_prompt_on = args.flags["skip-prompt-on"] && args.flags["skip-prompt-on"] !== true
+    ? args.flags["skip-prompt-on"]
+    : undefined;
   const pid = await resolveProjectId(args?.flags?.project);
-  const r = await http.post(`/projects/${pid}/routines`, { name, kind, schedule, spec, permission_mode, allowed_tools });
+  const r = await http.post(`/projects/${pid}/routines`, { name, kind, schedule, spec, permission_mode, allowed_tools, pre_commands, post_commands, skip_prompt_on });
   console.log(`added routine "${r.name}" (${r.kind}, ${r.schedule}) → next ${r.next_run_at}`);
+  if (r.pre_commands?.length)  console.log(`  pre:  ${r.pre_commands.join(", ")}`);
+  if (r.post_commands?.length) console.log(`  post: ${r.post_commands.join(", ")}`);
+  if (r.skip_prompt_on && r.skip_prompt_on !== "signal") console.log(`  skip_prompt_on: ${r.skip_prompt_on}`);
 }
 
 export async function cmdRoutineRemove(args) {

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

@@ -0,0 +1,330 @@
+import readline from "node:readline";
+import { http } from "../http.js";
+import { resolveProjectId } from "./project.js";
+import { readConfig } from "../../core/config.js";
+import { readIdentity } from "../../core/identity.js";
+import {
+  C,
+  MODES,
+  readPackageVersion,
+  renderTerminalChat,
+  titlecase,
+} from "../terminal-chat/renderer.js";
+
+const MAIN_PALETTE_OPTIONS = ["Switch model", "Connect provider", "Open editor", "Exit"];
+
+export async function cmdSys(args) {
+  const pid = await resolveProjectId(args?.flags?.project);
+  const cfg = readConfig();
+  const id = readIdentity();
+
+  const state = {
+    currentModeIdx: 0,
+    inputText: "",
+    cursorIndex: 0,
+    inCommandPalette: false,
+    paletteSelection: 0,
+    paletteState: "main",
+    paletteOptions: [...MAIN_PALETTE_OPTIONS],
+    activeAgent: titlecase(id?.agent_name || cfg.super_agent?.name || "SuperAgent"),
+    activeModel: cfg.super_agent?.model || "Claude 3.5 Sonnet",
+    version: readPackageVersion(),
+    hasStarted: false,
+    sessionTitle: "",
+    usage: { input: 0, output: 0, percent: 0 },
+    transcript: [],
+  };
+
+  const previousMessages = [];
+  let restored = false;
+  let isRequesting = false;
+
+  function restoreTerminal() {
+    if (restored) return;
+    restored = true;
+    if (process.stdin.isTTY) process.stdin.setRawMode(false);
+    process.stdout.write(C.reset + C.showCursor + C.resetBg + C.altOff);
+  }
+
+  function renderScreen() {
+    state.sessionTitle = state.transcript.find((item) => item.type === "user")?.text || "";
+    renderTerminalChat(state);
+  }
+
+  function resetPalette() {
+    state.paletteState = "main";
+    state.paletteOptions = [...MAIN_PALETTE_OPTIONS];
+    state.paletteSelection = 0;
+  }
+
+  function close() {
+    restoreTerminal();
+    process.exit(0);
+  }
+
+  readline.emitKeypressEvents(process.stdin);
+  if (process.stdin.isTTY) process.stdin.setRawMode(true);
+  process.stdout.write(C.altOn + C.setBgBlack + C.showCursor + C.bg);
+  process.once("exit", restoreTerminal);
+  process.once("SIGINT", close);
+  process.once("SIGTERM", close);
+  process.stdout.on?.("resize", renderScreen);
+  process.on("SIGWINCH", renderScreen);
+
+  renderScreen();
+
+  process.stdin.on("keypress", async (str, key) => {
+    if (isRequesting) return;
+
+    if (key.ctrl && key.name === "c") {
+      close();
+    }
+
+    if (key.ctrl && key.name === "p") {
+      state.inCommandPalette = !state.inCommandPalette;
+      resetPalette();
+      renderScreen();
+      return;
+    }
+
+    if (key.name === "escape" && state.inCommandPalette) {
+      if (state.paletteState !== "main") {
+        resetPalette();
+      } else {
+        state.inCommandPalette = false;
+      }
+      renderScreen();
+      return;
+    }
+
+    if (state.inCommandPalette) {
+      await handlePaletteKey(key, cfg, state, renderScreen, close);
+      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);
+    renderScreen();
+    return;
+  }
+
+  if (key.name === "down") {
+    state.paletteSelection = Math.min(state.paletteOptions.length - 1, state.paletteSelection + 1);
+    renderScreen();
+    return;
+  }
+
+  if (key.name !== "return") {
+    renderScreen();
+    return;
+  }
+
+  const selected = state.paletteOptions[state.paletteSelection];
+
+  if (state.paletteState === "main") {
+    if (selected === "Exit") close();
+
+    if (selected === "Switch model") {
+      state.paletteState = "switch_model";
+      state.paletteOptions = ["Loading models..."];
+      state.paletteSelection = 0;
+      renderScreen();
+      loadModelOptions(cfg, state, renderScreen);
+      return;
+    }
+
+    state.inCommandPalette = false;
+    state.transcript.push({ type: "status", text: `Executing command: ${selected} (not implemented yet)` });
+    renderScreen();
+    return;
+  }
+
+  if (
+    state.paletteState === "switch_model" &&
+    !selected.startsWith("Loading") &&
+    !selected.startsWith("Failed") &&
+    !selected.startsWith("No ")
+  ) {
+    state.activeModel = selected;
+    const configModule = await import("../../core/config.js");
+    const currentCfg = configModule.readConfig();
+    if (!currentCfg.super_agent) currentCfg.super_agent = {};
+    currentCfg.super_agent.model = selected;
+    configModule.writeConfig(currentCfg);
+
+    state.inCommandPalette = false;
+    state.transcript.push({ type: "status", text: `Model updated globally to ${selected}` });
+    renderScreen();
+    return;
+  }
+
+  renderScreen();
+}
+
+function loadModelOptions(cfg, state, renderScreen) {
+  const baseUrl = cfg.engines?.ollama?.base_url || "http://127.0.0.1:11434";
+  fetch(`${baseUrl}/api/tags`)
+    .then((r) => r.json())
+    .then((data) => {
+      state.paletteOptions = data.models?.length
+        ? data.models.map((m) => "ollama:" + m.name)
+        : ["No Ollama models found"];
+      state.paletteOptions.push("openai:gpt-4o", "anthropic:claude-3-5-sonnet-20240620");
+      if (state.paletteState === "switch_model") renderScreen();
+    })
+    .catch(() => {
+      state.paletteOptions = ["Failed to load from Ollama", "openai:gpt-4o", "anthropic:claude-3-5-sonnet-20240620"];
+      if (state.paletteState === "switch_model") renderScreen();
+    });
+}
+
+export function handleEditingKey(str, key, state, renderScreen) {
+  if (key.name === "tab") {
+    state.currentModeIdx = (state.currentModeIdx + 1) % MODES.length;
+    renderScreen();
+    return true;
+  }
+
+  if (key.ctrl && key.name === "a") {
+    state.cursorIndex = 0;
+    renderScreen();
+    return true;
+  }
+
+  if (key.ctrl && key.name === "e") {
+    state.cursorIndex = state.inputText.length;
+    renderScreen();
+    return true;
+  }
+
+  if (key.ctrl && key.name === "u") {
+    state.inputText = state.inputText.slice(state.cursorIndex);
+    state.cursorIndex = 0;
+    renderScreen();
+    return true;
+  }
+
+  if (key.ctrl && key.name === "w") {
+    const before = state.inputText.slice(0, state.cursorIndex).replace(/\s*\S+\s*$/, "");
+    state.inputText = before + state.inputText.slice(state.cursorIndex);
+    state.cursorIndex = before.length;
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "left") {
+    state.cursorIndex = Math.max(0, state.cursorIndex - 1);
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "right") {
+    state.cursorIndex = Math.min(state.inputText.length, state.cursorIndex + 1);
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "home") {
+    state.cursorIndex = 0;
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "end") {
+    state.cursorIndex = state.inputText.length;
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "delete") {
+    state.inputText = state.inputText.slice(0, state.cursorIndex) + state.inputText.slice(state.cursorIndex + 1);
+    renderScreen();
+    return true;
+  }
+
+  if (key.name === "backspace") {
+    if (state.cursorIndex === 0) return true;
+    state.inputText = state.inputText.slice(0, state.cursorIndex - 1) + state.inputText.slice(state.cursorIndex);
+    state.cursorIndex -= 1;
+    renderScreen();
+    return true;
+  }
+
+  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();
+    return true;
+  }
+
+  return false;
+}
+
+async function submitPrompt(pid, state, previousMessages, renderScreen, close) {
+  const text = state.inputText.trim();
+  if (!text) return;
+  if (text.toLowerCase() === "exit" || text.toLowerCase() === "quit") {
+    close();
+  }
+
+  state.hasStarted = true;
+  state.inputText = "";
+  state.cursorIndex = 0;
+  state.transcript.push({ type: "user", text });
+  state.transcript.push({ type: "status", text: "Thinking..." });
+  renderScreen();
+
+  const startTime = Date.now();
+
+  try {
+    const body = {
+      prompt: `[Mode: ${MODES[state.currentModeIdx]}]\n${text}`,
+      contextNote: "Channel: terminal. Format freely using markdown, but keep it readable. Use code diffs when editing.",
+      previousMessages,
+      model: state.activeModel,
+    };
+
+    const result = await http.post(`/projects/${pid}/super-agent/chat`, body);
+    state.transcript.pop();
+    for (const trace of result.trace || []) {
+      state.transcript.push({ type: "tool", trace });
+    }
+
+    previousMessages.push({ role: "user", content: text });
+    previousMessages.push({ role: "assistant", content: result.text });
+    if (previousMessages.length > 20) previousMessages.splice(0, previousMessages.length - 20);
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+    state.usage.input += result.usage?.input_tokens || 0;
+    state.usage.output += result.usage?.output_tokens || 0;
+    state.usage.percent = Math.min(99, Math.round((state.usage.input / 200000) * 100));
+
+    state.transcript.push({
+      type: "assistant",
+      name: state.activeAgent,
+      text: result.text,
+      meta: `${elapsed}s   ·   In: ${result.usage?.input_tokens || 0} Out: ${result.usage?.output_tokens || 0}`,
+    });
+  } catch (e) {
+    state.transcript.pop();
+    state.transcript.push({ type: "error", text: e.message });
+  }
+
+  renderScreen();
+}

package/src/cli/index.js

@@ -60,6 +60,7 @@ import {
   cmdConversationsList,
   cmdConversationsGet,
 } from "./commands/chat.js";
+import { cmdSys } from "./commands/sys.js";
 import { cmdRun, cmdEnvDetect } from "./commands/runtime.js";
 import { cmdSend, cmdConnections } from "./commands/a2a.js";
 import {
@@ -87,6 +88,12 @@ import {
   cmdRoutineRun,
   cmdRoutineHistory,
 } from "./commands/routine.js";
+import {
+  cmdArtifactCreate,
+  cmdArtifactList,
+  cmdArtifactShow,
+  cmdArtifactRemove,
+} from "./commands/artifact.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -695,6 +702,15 @@ 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>]"],
+    options: [
+      ["--project <name|id|path>", "Pin command to a specific project."],
+    ],
+    examples: ["apx sys", "apx sys --project default"],
+  }),
   conversations: topic({
     title: "apx conversations",
     summary: "List or read stored agent conversations.",
@@ -729,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."],
     ],
@@ -806,16 +822,22 @@ const HELP_TOPICS = new Map(Object.entries({
   "routine add": topic({
     title: "apx routine add",
     summary: "Create a scheduled routine.",
-    usage: ["apx routine add <name> --kind <kind> --schedule <schedule> [--spec '<json>'] [--permission-mode <mode>] [--allowed-tools a,b] [--project <name|id|path>]"],
+    usage: ["apx routine add <name> --kind <kind> --schedule <schedule> [--spec '<json>'] [--pre-commands 'cmd1,cmd2'] [--post-commands 'cmd'] [--skip-prompt-on signal|pre_failure|pre_success|always|never] [--project <name|id|path>]"],
     options: [
       ["--kind <kind>", "heartbeat, exec_agent, super_agent, telegram, or shell."],
       ["--schedule <schedule>", "every:60s, every:5m, every:1h, or once:<iso>."],
       ["--spec '<json>'", "Routine-specific JSON config."],
+      ["--pre-commands 'cmd'", "Comma-separated shell commands to run BEFORE the LLM. Use 'artifact:<name>' shorthand."],
+      ["--post-commands 'cmd'", "Comma-separated shell commands to run AFTER the LLM. Env: APX_LLM_OUTPUT, APX_PRE_OUTPUT, APX_STATUS."],
+      ["--skip-prompt-on <mode>", "signal (default), pre_failure, pre_success, always, never."],
       ["--permission-mode <mode>", "total, automatico, or permiso."],
       ["--allowed-tools a,b", "Comma-separated allowed tool names."],
       ["--project <name|id|path>", "Pin command to a specific project."],
     ],
-    examples: ["apx routine add check --kind shell --schedule every:1h --spec '{\"cmd\":\"npm test\"}'"],
+    examples: [
+      "apx routine add check --kind shell --schedule every:1h --spec '{\"cmd\":\"npm test\"}'",
+      "apx routine add asana-check --kind super_agent --schedule '*/5 * * * *' --pre-commands 'artifact:check_asana.sh' --skip-prompt-on pre_success --project 0",
+    ],
   }),
   "routine get": topic({
     title: "apx routine get",
@@ -859,6 +881,53 @@ const HELP_TOPICS = new Map(Object.entries({
     options: [["--project <name|id|path>", "Pin command to a specific project."]],
     examples: ["apx routine remove check"],
   }),
+  artifact: topic({
+    title: "apx artifact",
+    summary: "Managed files stored in project storage. Used as pre/post-commands scripts or data files for routines.",
+    usage: ["apx artifact <subcommand> [args] [--flags]"],
+    commands: [
+      ["create <name>", "Create a new empty artifact. Prints its absolute path."],
+      ["list | ls", "List artifacts in the project."],
+      ["show <name>", "Print artifact content."],
+      ["remove | rm <name>", "Delete an artifact."],
+    ],
+    examples: [
+      "apx artifact create check_asana.sh --project 0",
+      "apx artifact list",
+      "apx artifact show check_asana.sh",
+    ],
+  }),
+  "artifact create": topic({
+    title: "apx artifact create",
+    summary: "Create a new managed artifact file.",
+    usage: ["apx artifact create <name> [--content 'text'] [--project <name|id|path>]"],
+    options: [
+      ["--content 'text'", "Initial file content (default: empty)."],
+      ["--project <name|id|path>", "Pin command to a specific project."],
+    ],
+    examples: ["apx artifact create check_asana.sh --project 0"],
+  }),
+  "artifact list": topic({
+    title: "apx artifact list",
+    summary: "List artifacts in the project storage.",
+    usage: ["apx artifact list [--project <name|id|path>]"],
+    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    examples: ["apx artifact list"],
+  }),
+  "artifact show": topic({
+    title: "apx artifact show",
+    summary: "Print artifact content.",
+    usage: ["apx artifact show <name> [--project <name|id|path>]"],
+    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    examples: ["apx artifact show check_asana.sh"],
+  }),
+  "artifact remove": topic({
+    title: "apx artifact remove",
+    summary: "Delete an artifact.",
+    usage: ["apx artifact remove <name> [--project <name|id|path>]", "apx artifact rm <name>"],
+    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    examples: ["apx artifact remove check_asana.sh"],
+  }),
   command: topic({
     title: "apx command",
     summary: "List or show workflow commands from .apc/commands/.",
@@ -1073,12 +1142,13 @@ function buildHelp(version) {
     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>"),
     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"),
@@ -1086,11 +1156,13 @@ function buildHelp(version) {
     hCmd("apx connections <agent>",    36, "mental map: who/how/when this agent talked"),
     hCmd("apx graph <agent>",          36, "alias for connections"),
 
-    hSec("Routines"),
+    hSec("Routines & Pipeline"),
     hCmd("apx routine list",           36, "list routines + next/last run"),
     hCmd("apx routine add <name>",     36, "--kind K  --schedule S  [--spec '{...}']"),
     `    ${H.DI}kinds: heartbeat | exec_agent | super_agent | telegram | shell${H.R}`,
     `    ${H.DI}flags: --permission-mode total|automatico|permiso  --allowed-tools a,b${H.R}`,
+    `    ${H.DI}pipeline: --pre-commands 'cmd1,cmd2'  --post-commands 'cmd'${H.R}`,
+    `    ${H.DI}         --skip-prompt-on signal|pre_failure|pre_success|always|never${H.R}`,
     `    ${H.DI}schedule: every:60s | every:5m | every:1h | once:<iso>${H.R}`,
     hCmd("apx routine get <name>",     36, ""),
     hCmd("apx routine history <name>", 36, "show routine execution history"),
@@ -1099,6 +1171,12 @@ function buildHelp(version) {
     hCmd("apx routine disable <name>", 36, ""),
     hCmd("apx routine remove <name>",  36, ""),
 
+    hSec("Artifacts"),
+    hCmd("apx artifact create <name>", 36, "create managed file in project storage  [--content '...'] [--project 0]"),
+    hCmd("apx artifact list",          36, "list artifacts"),
+    hCmd("apx artifact show <name>",   36, "print artifact content"),
+    hCmd("apx artifact remove <name>", 36, ""),
+
     hSec("Commands & Skills"),
     hCmd("apx command list",           36, "list workflow commands (.apc/commands/)"),
     hCmd("apx command show <name>",    36, "print command content"),
@@ -1374,6 +1452,10 @@ async function dispatch(cmd, rest) {
         await cmdChat(parseArgs(rest));
         break;
 
+      case "sys":
+        await cmdSys(parseArgs(rest));
+        break;
+
       case "conversations":
       case "conv": {
         const sub = rest[0];
@@ -1445,6 +1527,18 @@ async function dispatch(cmd, rest) {
         break;
       }
 
+      case "artifact":
+      case "artifacts": {
+        const sub = rest[0];
+        const a = parseArgs(rest.slice(1));
+        if (!sub || sub === "list" || sub === "ls") await cmdArtifactList(a);
+        else if (sub === "create" || sub === "new") await cmdArtifactCreate(a);
+        else if (sub === "show" || sub === "get") await cmdArtifactShow(a);
+        else if (sub === "remove" || sub === "rm") await cmdArtifactRemove(a);
+        else die(`unknown artifact subcommand: ${sub}`);
+        break;
+      }
+
       case "command":
       case "commands": {
         const sub = rest[0];