u-foo 1.7.5 → 1.8.0

package/README.md

@@ -113,13 +113,16 @@ ucode-core list --json
 
 ## Global Chat (`ufoo -g`)
 
-Use `ufoo -g` (or `ufoo --global`) to launch a cross-project chat dashboard. Instead of being scoped to a single project, global mode connects to all running ufoo daemons and lets you switch between projects on the fly.
+Use `ufoo -g` (or `ufoo --global`) to launch a cross-project chat dashboard. Instead of being scoped to the current working directory, global mode runs from a home-scoped controller context and stores its runtime under `~/.ufoo`, then connects to project daemons on demand.
+
+When global chat stays on the home-scoped controller, plain prompts first go through the controller's `ufoo-agent`, which picks the best registered project and forwards the prompt to that project's `ufoo-agent` for agent-level routing.
 
 ```bash
 $ ufoo -g
 
 > /project list          # List all running project daemons
 > /project switch 2      # Switch to project #2
+> /open ~/Code/my-app    # Initialize/start/switch to a project by path
 > /launch claude scope=inplace   # Launch agent in current context
 > @claude-1 Start reviewing the auth module
 ```
@@ -128,9 +131,14 @@ $ ufoo -g
 |---------|-------------|
 | `/project list` | List running projects from global runtime registry |
 | `/project switch <index\|path>` | Switch active project daemon connection |
+| `/open <path>` | Global-mode shortcut to initialize/start/open a project daemon by path |
 | `/launch <agent> scope=inplace` | Launch agent in current workspace |
 | `/launch <agent> scope=window` | Launch agent in separate terminal window |
 
+Notes:
+- If you just type a normal message in the controller view, global `ufoo-agent` will try to route it to the most relevant registered project first.
+- The selected project's `ufoo-agent` then continues the second-hop routing to a concrete coding agent.
+
 ## Agent Configuration
 
 Configure AI providers in `.ufoo/config.json`:

package/README.zh-CN.md

@@ -113,13 +113,16 @@ ucode-core list --json
 
 ## 全局聊天（`ufoo -g`）
 
-使用 `ufoo -g`（或 `ufoo --global`）启动跨项目聊天仪表盘。全局模式会连接所有正在运行的 ufoo 守护进程，支持在不同项目之间快速切换。
+使用 `ufoo -g`（或 `ufoo --global`）启动跨项目聊天仪表盘。全局模式不再绑定当前工作目录，而是使用一个基于家目录的控制器上下文，并将自身运行时写入 `~/.ufoo`，然后按需连接各项目的 ufoo 守护进程。
+
+当全局聊天停留在这个家目录控制器视图时，普通消息会先经过控制器侧的 `ufoo-agent`，由它在当前已注册的 Projects 里选择最合适的项目，再把消息转交给目标项目内的 `ufoo-agent` 继续做 agent 级路由。
 
 ```bash
 $ ufoo -g
 
 > /project list          # 列出所有运行中的项目守护进程
 > /project switch 2      # 切换到第 2 个项目
+> /open ~/Code/my-app    # 按路径初始化/启动/打开一个项目
 > /launch claude scope=inplace   # 在当前上下文启动 Agent
 > @claude-1 开始审查 auth 模块
 ```
@@ -128,9 +131,14 @@ $ ufoo -g
 |------|------|
 | `/project list` | 列出全局运行时注册的项目 |
 | `/project switch <序号\|路径>` | 切换活动项目的 daemon 连接 |
+| `/open <path>` | 仅在全局模式下可用；按路径初始化、启动并打开项目 daemon |
 | `/launch <agent> scope=inplace` | 在当前工作区启动 Agent |
 | `/launch <agent> scope=window` | 在独立终端窗口启动 Agent |
 
+说明：
+- 如果你在控制器视图里直接输入普通消息，全局 `ufoo-agent` 会先尝试把它路由到最相关的已注册项目。
+- 选中的项目里，项目侧 `ufoo-agent` 会继续完成第二跳路由，选择具体 coding agent。
+
 ## Agent 配置
 
 在 `.ufoo/config.json` 中配置 AI 提供商：

package/bin/ufoo.js

@@ -5,6 +5,7 @@ const { runDaemonCli } = require("../src/daemon/run");
 const { runChat } = require("../src/chat");
 const { runInternalRunner } = require("../src/agent/internalRunner");
 const { runPtyRunner } = require("../src/agent/ptyRunner");
+const { resolveGlobalControllerProjectRoot } = require("../src/globalMode");
 
 const rawArgv = process.argv.slice(2);
 
@@ -16,9 +17,10 @@ async function main() {
   const globalMode = hasGlobalModeFlag(rawArgv);
   const argv = rawArgv.filter((arg) => arg !== "-g" && arg !== "--global");
   const cmd = argv[0];
+  const chatProjectRoot = globalMode ? resolveGlobalControllerProjectRoot() : process.cwd();
 
   if (!cmd) {
-    await runChat(process.cwd(), { globalMode });
+    await runChat(chatProjectRoot, { globalMode });
     return;
   }
   if (cmd === "daemon") {
@@ -47,7 +49,7 @@ async function main() {
     return;
   }
   if (cmd === "chat") {
-    await runChat(process.cwd(), { globalMode });
+    await runChat(chatProjectRoot, { globalMode });
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "1.7.5",
+  "version": "1.8.0",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",

package/src/agent/cliRunner.js

@@ -1,5 +1,6 @@
 const { spawn } = require("child_process");
 const { randomUUID } = require("crypto");
+const { DEFAULT_ASSISTANT_TIMEOUT_MS } = require("../assistant/constants");
 
 const ROUTER_JSON_SCHEMA = JSON.stringify({
   type: "object",
@@ -616,7 +617,7 @@ async function runCliAgent(params) {
       cwd: params.cwd,
       env,
       input: stdin,
-      timeoutMs: params.timeoutMs || 300000,  // 5 minutes for complex tasks
+      timeoutMs: params.timeoutMs || DEFAULT_ASSISTANT_TIMEOUT_MS,
       onStdout: codexParser ? (chunk) => codexParser.onChunk(chunk) : null,
       signal: params.signal,
     });
@@ -678,7 +679,7 @@ async function runCliAgent(params) {
           cwd: params.cwd,
           env,
           input: retryStdin,
-          timeoutMs: params.timeoutMs || 300000,
+          timeoutMs: params.timeoutMs || DEFAULT_ASSISTANT_TIMEOUT_MS,
           onStdout: retryParser ? (chunk) => retryParser.onChunk(chunk) : null,
           signal: params.signal,
         });

package/src/agent/ucodeBootstrap.js

@@ -77,18 +77,20 @@ function buildBootstrapContent({
 function prepareUcodeBootstrap({
   projectRoot = process.cwd(),
   promptFile = "",
+  promptText = "",
   targetFile = "",
 } = {}) {
   const resolvedProjectRoot = path.resolve(projectRoot);
   const resolvedPrompt = String(promptFile || "").trim();
   const resolvedTarget = String(targetFile || "").trim() || defaultBootstrapPath(resolvedProjectRoot);
 
-  const promptText = readFileSafe(resolvedPrompt);
+  const inlinePromptText = String(promptText || "").trim();
+  const resolvedPromptText = inlinePromptText || readFileSafe(resolvedPrompt);
   const rules = resolveProjectRules(resolvedProjectRoot);
   const content = buildBootstrapContent({
     projectRoot: resolvedProjectRoot,
     promptFile: resolvedPrompt,
-    promptText,
+    promptText: resolvedPromptText,
     rules,
   });
 
@@ -99,7 +101,7 @@ function prepareUcodeBootstrap({
     ok: true,
     file: resolvedTarget,
     promptFile: resolvedPrompt,
-    hasPrompt: Boolean(promptText.trim()),
+    hasPrompt: Boolean(resolvedPromptText.trim()),
     rulesCount: rules.length,
   };
 }

package/src/agent/ufooAgent.js

@@ -11,6 +11,8 @@ const {
 } = require("../code/nativeRunner");
 const { DEFAULT_ASSISTANT_TIMEOUT_MS } = require("../assistant/constants");
 const { normalizeAgentTypeAlias } = require("../bus/utils");
+const { listProjectRuntimes } = require("../projects/registry");
+const { isGlobalControllerProjectRoot } = require("../globalMode");
 
 function loadSessionState(projectRoot) {
   const dir = getUfooPaths(projectRoot).agentDir;
@@ -260,7 +262,180 @@ function loadBusSummary(projectRoot, maxLines = 20) {
   return { agents, nicknames, reports, agent_prompt_history: promptHistory, summary, recent };
 }
 
-function buildSystemPrompt(context) {
+function slicePromptHistoryForProject(value = {}) {
+  const input = value && typeof value === "object" ? value : {};
+  const perAgent = Array.isArray(input.per_agent) ? input.per_agent.slice(0, 3) : [];
+  return {
+    scanned_files: Number(input.scanned_files || 0) || 0,
+    matched_events: Number(input.matched_events || 0) || 0,
+    per_agent: perAgent.map((row) => ({
+      agent_id: String(row && row.agent_id ? row.agent_id : ""),
+      nickname: String(row && row.nickname ? row.nickname : ""),
+      total_count: Number(row && row.total_count ? row.total_count : 0) || 0,
+      sample_count: Number(row && row.sample_count ? row.sample_count : 0) || 0,
+      last_ts: String(row && row.last_ts ? row.last_ts : ""),
+      samples: Array.isArray(row && row.samples)
+        ? row.samples.slice(0, 2).map((sample) => ({
+          ts: String(sample && sample.ts ? sample.ts : ""),
+          publisher: String(sample && sample.publisher ? sample.publisher : ""),
+          prompt: String(sample && sample.prompt ? sample.prompt : ""),
+        }))
+        : [],
+    })),
+  };
+}
+
+function buildGlobalProjectRouterContext(projectRoot, options = {}) {
+  const maxProjects = Number.isFinite(options.maxProjects) && options.maxProjects > 0
+    ? Math.floor(options.maxProjects)
+    : 12;
+
+  let rows = [];
+  try {
+    rows = listProjectRuntimes({ validate: true, cleanupTmp: true });
+  } catch {
+    rows = [];
+  }
+
+  rows = rows
+    .filter((row) => {
+      const status = String((row && row.status) || "").trim().toLowerCase();
+      if (status === "stopped") return false;
+      return !isGlobalControllerProjectRoot(row && row.project_root ? row.project_root : "");
+    })
+    .slice(0, maxProjects);
+
+  let activeAgentTotal = 0;
+  let busyAgentTotal = 0;
+  let unreadTotal = 0;
+  let decisionsOpenTotal = 0;
+
+  const projects = rows.map((row) => {
+    const targetRoot = String(row && row.project_root ? row.project_root : "");
+    const fallbackName = String(row && row.project_name ? row.project_name : targetRoot);
+    let topDirs = [];
+    try {
+      const entries = fs.readdirSync(targetRoot, { withFileTypes: true });
+      topDirs = entries
+        .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules")
+        .map((e) => e.name)
+        .slice(0, 20);
+    } catch {
+      // ignore unreadable directories
+    }
+    try {
+      const status = buildStatus(targetRoot);
+      const activeMeta = Array.isArray(status && status.active_meta) ? status.active_meta : [];
+      const agents = activeMeta.map((item) => ({
+        id: String(item && item.id ? item.id : ""),
+        nickname: String(item && item.nickname ? item.nickname : ""),
+        display: String(item && item.display ? item.display : ""),
+        launch_mode: String(item && item.launch_mode ? item.launch_mode : ""),
+        activity_state: String(item && item.activity_state ? item.activity_state : ""),
+        activity_since: String(item && item.activity_since ? item.activity_since : ""),
+      }));
+      const nicknames = {};
+      agents.forEach((item) => {
+        if (item.nickname) nicknames[item.nickname] = item.id;
+      });
+      const promptHistory = buildAgentPromptHistory(targetRoot, agents, nicknames, {
+        perAgentLimit: 2,
+        maxFiles: 2,
+      });
+      const busyCount = agents.filter((item) => isBusyActivityState(item.activity_state)).length;
+      activeAgentTotal += agents.length;
+      busyAgentTotal += busyCount;
+      const unread = Number(status && status.unread && status.unread.total ? status.unread.total : 0) || 0;
+      const decisionsOpen = Number(status && status.decisions && status.decisions.open ? status.decisions.open : 0) || 0;
+      unreadTotal += unread;
+      decisionsOpenTotal += decisionsOpen;
+      return {
+        project_root: targetRoot,
+        project_name: fallbackName,
+        top_dirs: topDirs,
+        status: String(row && row.status ? row.status : "unknown"),
+        last_seen: String(row && row.last_seen ? row.last_seen : ""),
+        active_count: agents.length,
+        busy_count: busyCount,
+        ready_count: Math.max(agents.length - busyCount, 0),
+        unread_total: unread,
+        decisions_open: decisionsOpen,
+        reports_pending_total: Number(status && status.reports && status.reports.pending_total ? status.reports.pending_total : 0) || 0,
+        groups_active: Number(status && status.groups && status.groups.active ? status.groups.active : 0) || 0,
+        agents: agents.slice(0, 6),
+        agent_prompt_history: slicePromptHistoryForProject(promptHistory),
+      };
+    } catch {
+      return {
+        project_root: targetRoot,
+        project_name: fallbackName,
+        top_dirs: topDirs,
+        status: String(row && row.status ? row.status : "unknown"),
+        last_seen: String(row && row.last_seen ? row.last_seen : ""),
+        active_count: 0,
+        busy_count: 0,
+        ready_count: 0,
+        unread_total: 0,
+        decisions_open: 0,
+        reports_pending_total: 0,
+        groups_active: 0,
+        agents: [],
+        agent_prompt_history: { scanned_files: 0, matched_events: 0, per_agent: [] },
+      };
+    }
+  });
+
+  const runningCount = projects.filter((item) => item.status === "running").length;
+  const staleCount = projects.filter((item) => item.status === "stale").length;
+
+  return {
+    mode: "global-router",
+    controller_project_root: projectRoot,
+    summary: {
+      project_count: projects.length,
+      running_count: runningCount,
+      stale_count: staleCount,
+      active_agent_total: activeAgentTotal,
+      busy_agent_total: busyAgentTotal,
+      unread_total: unreadTotal,
+      decisions_open_total: decisionsOpenTotal,
+    },
+    projects,
+  };
+}
+
+function buildSystemPrompt(context, options = {}) {
+  const mode = String(options.routingMode || (context && context.mode) || "").trim().toLowerCase();
+  if (mode === "global-router") {
+    return [
+      "You are ufoo-agent, the global project router for `ufoo chat -g`.",
+      "You run inside the home-scoped controller runtime and must choose the right project before any project-local routing happens.",
+      "Return ONLY valid JSON. No extra text.",
+      "Schema:",
+      "{",
+      '  "reply": "string",',
+      `  "assistant_call": {"kind":"explore|bash|mixed","task":"string","context":"optional","expect":"optional","provider":"codex|claude|ufoo (optional)","model":"optional","timeout_ms":${DEFAULT_ASSISTANT_TIMEOUT_MS}},`,
+      '  "project_route": {"project_root":"absolute-path","project_name":"string","prompt":"string","reason":"string"},',
+      '  "dispatch": [],',
+      '  "ops": []',
+      "}",
+      "Rules:",
+      "- Use project_route when the request should be handed to one specific registered project.",
+      "- project_route.prompt should usually preserve the user request, optionally rewritten only to clarify project context for the next router.",
+      "- Each project entry has top_dirs: the immediate subdirectories of project_root. Use these to match sub-project or component names mentioned by the user (e.g. if user says 'voyager' and a project has 'voyager' in top_dirs, route there).",
+      "- Keep dispatch empty in global-router mode. Do NOT send directly to coding agents from the global controller.",
+      "- Keep ops empty in global-router mode. Do NOT launch/rename/close/cron project-local agents from the global controller.",
+      "- The target project's ufoo-agent will do the second-hop routing to a concrete agent.",
+      "- If the user asks for a global comparison, registry overview, or other controller-level answer, reply directly and omit project_route.",
+      "- If no registered project is a clear match, reply with a concise clarification request or tell the user to use /open <path> first.",
+      "- assistant_call is allowed for lightweight controller-side inspection when the registry/context is insufficient.",
+      "- Prefer continuity: if a project's recent prompt history clearly matches the current request, route there.",
+      "",
+      "Context: registered projects and project activity summaries:",
+      JSON.stringify(context),
+    ].join("\n");
+  }
+
   const hasAgents = context.agents && context.agents.length > 0;
   const agentGuidance = hasAgents
     ? ""
@@ -275,7 +450,7 @@ function buildSystemPrompt(context) {
     '  "reply": "string",',
     `  "assistant_call": {"kind":"explore|bash|mixed","task":"string","context":"optional","expect":"optional","provider":"codex|claude|ufoo (optional)","model":"optional","timeout_ms":${DEFAULT_ASSISTANT_TIMEOUT_MS}},`,
     '  "dispatch": [{"target":"broadcast|<agent-id>|<nickname>","message":"string","injection_mode":"immediate|queued (optional)","source":"optional"}],',
-    '  "ops": [{"action":"launch|close|rename|cron","agent":"codex|claude|ucode","count":1,"agent_id":"id","nickname":"optional","operation":"start|list|stop","every":"30m","interval_ms":1800000,"at":"YYYY-MM-DD HH:mm","once_at_ms":1700000000000,"target":"agent-id|nickname|csv","targets":["agent-id"],"title":"optional short title","prompt":"message","id":"task-id|all"}],',
+    '  "ops": [{"action":"launch|close|rename|role|cron","agent":"codex|claude|ucode","count":1,"agent_id":"id","nickname":"optional","prompt_profile":"profile-id (for role)","operation":"start|list|stop","every":"30m","interval_ms":1800000,"at":"YYYY-MM-DD HH:mm","once_at_ms":1700000000000,"target":"agent-id|nickname|csv","targets":["agent-id"],"title":"optional short title","prompt":"message","id":"task-id|all"}],',
     '  "disambiguate": {"prompt":"string","candidates":[{"agent_id":"id","reason":"string"}]}',
     "}",
     "Rules:",
@@ -286,6 +461,7 @@ function buildSystemPrompt(context) {
     "- For scheduled follow-up (cron), use ops.cron with operation=start and include target(s)+prompt, plus optional title; use every/interval_ms for recurring or at/once_at_ms for one-time.",
     "- To check scheduled tasks, use ops.cron with operation=list.",
     "- To stop scheduled tasks, use ops.cron with operation=stop and id (or id=all).",
+    "- To assign a preset role to an existing agent, use ops.role with target (agent-id or nickname) and prompt_profile (profile id or alias). Available profiles: discovery-facilitator, scope-challenger, system-architect, implementation-lead, frontend-refiner, design-critic, review-critic, qa-driver, debug-investigator, release-coordinator, task-breakdown, research-scan, rapid-prototype.",
     "- Use top-level assistant_call for project exploration, temporary shell tasks, and quick execution support.",
     "- assistant_call fields: kind (explore|bash|mixed), task (required), context/expect (optional), provider (codex|claude|ufoo, optional), model/timeout_ms (optional).",
     "- Prefer assistant_call over launching coding agents when the task is short-lived.",
@@ -453,10 +629,13 @@ async function runNativeRouterCall({ projectRoot, prompt, systemPrompt, model: r
   }
 }
 
-async function runUfooAgent({ projectRoot, prompt, provider, model }) {
+async function runUfooAgent({ projectRoot, prompt, provider, model, routingMode = "", routingContext = null }) {
   const state = loadSessionState(projectRoot);
-  const bus = loadBusSummary(projectRoot);
-  const systemPrompt = buildSystemPrompt(bus);
+  const mode = String(routingMode || (routingContext && routingContext.mode) || "").trim().toLowerCase();
+  const bus = routingContext || (mode === "global-router"
+    ? buildGlobalProjectRouterContext(projectRoot)
+    : loadBusSummary(projectRoot));
+  const systemPrompt = buildSystemPrompt(bus, { routingMode: mode });
   const history = loadHistory(projectRoot);
   const historyPrompt = buildHistoryPrompt(history);
   const fullPrompt = historyPrompt ? `${historyPrompt}User: ${prompt}` : prompt;

package/src/assistant/constants.js

@@ -1,4 +1,4 @@
-const DEFAULT_ASSISTANT_TIMEOUT_MS = 300000; // 5 minutes
+const DEFAULT_ASSISTANT_TIMEOUT_MS = 600000; // 10 minutes
 const DEFAULT_ASSISTANT_TIMEOUT_GRACE_MS = 5000;
 
 function normalizeAssistantTimeoutMs(value, fallback = DEFAULT_ASSISTANT_TIMEOUT_MS) {

package/src/chat/commandExecutor.js

@@ -6,6 +6,8 @@ const { runGroupCoreCommand } = require("../cli/groupCoreCommands");
 const { loadConfig: loadProjectConfig, saveConfig: saveProjectConfig, loadGlobalUcodeConfig, saveGlobalUcodeConfig } = require("../config");
 const { resolveTransport } = require("../code/nativeRunner");
 const { parseIntervalMs, formatIntervalMs } = require("./cronScheduler");
+const { isGlobalControllerProjectRoot, resolveGlobalControllerUfooDir } = require("../globalMode");
+const { loadPromptProfileRegistry } = require("../group/promptProfiles");
 
 function defaultCreateDoctor(projectRoot) {
   const UfooDoctor = require("../doctor");
@@ -92,6 +94,7 @@ function createCommandExecutor(options = {}) {
     stopCronTask = () => false,
     runGroupCore = runGroupCoreCommand,
     requestCron = null,
+    globalMode = false,
     listProjects = () => [],
     getCurrentProject = () => ({ projectRoot }),
     switchProject = async () => ({ ok: false, error: "project switching unavailable" }),
@@ -404,7 +407,7 @@ function createCommandExecutor(options = {}) {
     if (args.length === 0) {
       logMessage(
         "error",
-        "{white-fg}✗{/white-fg} Usage: /launch <claude|codex|ucode> [nickname=<name>] [count=<n>] [scope=inplace|window]"
+        "{white-fg}✗{/white-fg} Usage: /launch <claude|codex|ucode> [nickname=<name>] [profile=<id>] [count=<n>] [scope=inplace|window]"
       );
       return;
     }
@@ -452,6 +455,7 @@ function createCommandExecutor(options = {}) {
     }
 
     const nickname = parsedOptions.nickname || "";
+    const promptProfile = parsedOptions.profile || parsedOptions.prompt_profile || "";
     const count = parseInt(parsedOptions.count || "1", 10);
     const scopeRaw = parsedOptions.scope || parsedOptions.launch_scope || parsedOptions.window || "";
     let launchScope = normalizeLaunchScopeOption(scopeRaw, "inplace");
@@ -473,6 +477,10 @@ function createCommandExecutor(options = {}) {
       logMessage("error", "{white-fg}✗{/white-fg} nickname requires count=1");
       return;
     }
+    if (promptProfile && count > 1) {
+      logMessage("error", "{white-fg}✗{/white-fg} profile requires count=1");
+      return;
+    }
 
     try {
       const request = {
@@ -480,6 +488,7 @@ function createCommandExecutor(options = {}) {
         agent: normalizedAgent,
         count: Number.isFinite(count) ? count : 1,
         nickname,
+        prompt_profile: promptProfile,
         launch_scope: launchScope,
         ...collectHostLaunchRequestContext(),
       };
@@ -494,6 +503,52 @@ function createCommandExecutor(options = {}) {
     }
   }
 
+  async function handleRoleCommand(args = []) {
+    const action = String(args[0] || "").trim().toLowerCase();
+    if (action === "list" || action === "ls") {
+      try {
+        const registry = loadPromptProfileRegistry(projectRoot);
+        const profiles = registry.profiles || [];
+        if (profiles.length === 0) {
+          logMessage("system", "{white-fg}⚙{/white-fg} No prompt profiles found.");
+          return;
+        }
+        logMessage("system", `{white-fg}⚙{/white-fg} Available prompt profiles (${profiles.length}):`);
+        for (const p of profiles) {
+          const aliases = p.aliases && p.aliases.length > 0 ? ` {gray-fg}(${p.aliases.join(", ")}){/gray-fg}` : "";
+          const source = p.source ? ` {cyan-fg}[${p.source}]{/cyan-fg}` : "";
+          const summary = p.summary ? `  ${p.summary}` : "";
+          logMessage("system", `  {bold}${escapeBlessed(p.id)}{/bold}${aliases}${source}`);
+          if (summary) {
+            logMessage("system", `    ${escapeBlessed(summary)}`);
+          }
+        }
+      } catch (err) {
+        logMessage("error", `{white-fg}✗{/white-fg} Failed to list profiles: ${escapeBlessed(err.message)}`);
+      }
+      return;
+    }
+
+    const target = String(args[0] || "").trim();
+    const profile = String(args[1] || "").trim();
+    if (!target || !profile) {
+      logMessage("error", "{white-fg}✗{/white-fg} Usage: /role <agent-id|nickname> <prompt-profile>");
+      logMessage("error", "       /role list");
+      return;
+    }
+
+    try {
+      send({
+        type: IPC_REQUEST_TYPES.ASSIGN_ROLE,
+        target,
+        prompt_profile: profile,
+      });
+      schedule(requestStatus, 1000);
+    } catch (err) {
+      logMessage("error", `{white-fg}✗{/white-fg} Role assignment failed: ${escapeBlessed(err.message)}`);
+    }
+  }
+
   async function handleResumeCommand(args = []) {
     const action = String(args[0] || "").toLowerCase();
     if (action === "list" || action === "ls") {
@@ -517,7 +572,11 @@ function createCommandExecutor(options = {}) {
 
     if (subcommand === "list") {
       const rowsRaw = await Promise.resolve(listProjects());
-      const rows = Array.isArray(rowsRaw) ? rowsRaw : [];
+      const rows = (Array.isArray(rowsRaw) ? rowsRaw : []).filter((row) => {
+        if (!globalMode) return true;
+        const root = row && row.project_root ? String(row.project_root) : "";
+        return !isGlobalControllerProjectRoot(root);
+      });
       const current = await Promise.resolve(getCurrentProject());
       const currentRoot = current && current.project_root ? String(current.project_root) : "";
       if (rows.length === 0) {
@@ -545,12 +604,19 @@ function createCommandExecutor(options = {}) {
         logMessage("error", "{white-fg}✗{/white-fg} Current project unavailable");
         return;
       }
+      if (globalMode && isGlobalControllerProjectRoot(current.project_root)) {
+        logMessage(
+          "system",
+          `{cyan-fg}Current:{/cyan-fg} global controller (${escapeBlessed(resolveGlobalControllerUfooDir())})`
+        );
+        return;
+      }
       logMessage("system", `{cyan-fg}Current:{/cyan-fg} ${escapeBlessed(current.project_root)}`);
       return;
     }
 
     if (subcommand === "switch") {
-      const target = String(args[1] || "").trim();
+      const target = args.slice(1).join(" ").trim();
       if (!target) {
         logMessage("error", "{white-fg}✗{/white-fg} Usage: /project switch <index|path>");
         return;
@@ -570,6 +636,27 @@ function createCommandExecutor(options = {}) {
     logMessage("error", "{white-fg}✗{/white-fg} Unknown project command. Use: list, current, switch");
   }
 
+  async function handleOpenCommand(args = []) {
+    if (!globalMode) {
+      logMessage("error", "{white-fg}✗{/white-fg} /open is only available in global mode");
+      return;
+    }
+    const target = args.join(" ").trim();
+    if (!target) {
+      logMessage("error", "{white-fg}✗{/white-fg} Usage: /open <path>");
+      return;
+    }
+    logMessage("system", `{white-fg}⚙{/white-fg} Opening project: ${escapeBlessed(target)}`);
+    const result = await Promise.resolve(switchProject({ target }));
+    if (!result || result.ok !== true) {
+      const reason = result && result.error ? String(result.error) : "open failed";
+      logMessage("error", `{white-fg}✗{/white-fg} Open failed: ${escapeBlessed(reason)}`);
+      return;
+    }
+    const nextRoot = result.project_root || result.projectRoot || "";
+    logMessage("system", `{white-fg}✓{/white-fg} Opened project: ${escapeBlessed(nextRoot)}`);
+  }
+
   function parseKeyValueArgs(args = []) {
     const parsed = {};
     for (const raw of args) {
@@ -1120,12 +1207,18 @@ function createCommandExecutor(options = {}) {
       case "launch":
         await handleLaunchCommand(args);
         return true;
+      case "open":
+        await handleOpenCommand(args);
+        return true;
       case "resume":
         await handleResumeCommand(args);
         return true;
       case "project":
         await handleProjectCommand(args);
         return true;
+      case "role":
+        await handleRoleCommand(args);
+        return true;
       case "cron":
         await handleCronCommand(args);
         return true;
@@ -1154,8 +1247,10 @@ function createCommandExecutor(options = {}) {
     handleCtxCommand,
     handleSkillsCommand,
     handleLaunchCommand,
+    handleOpenCommand,
     handleResumeCommand,
     handleProjectCommand,
+    handleRoleCommand,
     handleCronCommand,
     handleGroupCommand,
     handleSettingsCommand,

package/src/chat/commands.js

@@ -47,6 +47,7 @@ const COMMAND_TREE = {
     },
   },
   "/init": { desc: "Initialize modules" },
+  "/open": { desc: "Open project path in global mode" },
   "/launch": {
     desc: "Launch new agent",
     children: {
@@ -63,6 +64,12 @@ const COMMAND_TREE = {
       switch: { desc: "Switch daemon connection to project index/path" },
     },
   },
+  "/role": {
+    desc: "Assign preset role to an existing agent",
+    children: {
+      list: { desc: "List available prompt profiles" },
+    },
+  },
   "/resume": {
     desc: "Resume agents (optional nickname) or list recoverable targets",
     children: {