march-cli 0.1.34 → 0.1.36

package/src/agent/runner.mjs

@@ -26,6 +26,8 @@ import { appendFastVariants, createFastModelEntry, fromFastEntryModel, isFastPro
 import { registerSuperGrokProvider } from "../supergrok/provider.mjs";
 import { registerCustomProviders } from "../provider/custom-provider.mjs";
 import { injectHostedTools } from "../provider/hosted-tools.mjs";
+import { createRunnerLifecycle } from "./lifecycle/runner-lifecycle.mjs";
+import { createRunnerProviderQuotaRuntime } from "./runner/provider-quota-runtime.mjs";
 export { MARCH_BASE_TOOL_NAMES, installModelPayloadDumper };
 export { createDefaultSessionManager, resolveRunnerSessionManager } from "./runner/runner-init.mjs";
 export { getRunnerSessionStats, syncEngineSessionState } from "./runner/runner-session-state.mjs";
@@ -58,6 +60,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
   const resolvedSessionManager = resolveRunnerSessionManager(cwd, sessionManager);
   const sessionBinding = createSessionBinding(null);
   let currentModelCallKind = "model", currentTurnId = null, currentPromptForContext = "";
+  const lifecycle = createRunnerLifecycle();
   let currentTurnContextMode = "rebuild";
   let nextTurnContextMode = "rebuild";
   let lastNotificationResult = null, runtimeHost = null, lifecycleAdapter = null;
@@ -70,7 +73,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
       sessionManager: resolvedSessionManager, sessionBinding, engine, ui: runtimeUi,
       projectMarchDir,
       memoryTools, memoryStore, shellRuntime, lspService, mcpTools, webTools,
-      permissionController, extensionPaths, hostedTools,
+      lifecycle, permissionController, extensionPaths, hostedTools,
       onRebind: (session) => {
         installModelPayloadDumper(session, modelContextDumper, () => currentModelCallKind, onLoggedModelPayload, injectMarchSystemContext);
         syncEngineSessionState(engine, session);
@@ -82,7 +85,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
   } else {
     const sessionOptions = resolveRunnerSessionOptions({
       cwd, stateRoot, provider, modelId, modelRegistry, engine, ui: runtimeUi,
-      memoryTools, shellRuntime, lspService, mcpTools, webTools, permissionController,
+      memoryTools, shellRuntime, lspService, mcpTools, webTools, lifecycle, permissionController,
       authStorage: resolvedAuth, projectMarchDir,
       getCurrentModel: () => sessionBinding.get()?.model ?? selectedModel,
     });
@@ -105,6 +108,8 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
   if (serviceTier === "priority" && selectedModel && isFastProvider(selectedModel.provider)) {
     _currentFastEntry = createFastModelEntry(selectedModel).model;
   }
+  const providerQuotaRuntime = createRunnerProviderQuotaRuntime({ authStorage: resolvedAuth, ui: runtimeUi,
+    getCurrentModel: () => _currentFastEntry ?? sessionBinding.get().model });
   return {
     engine,
     get session() { return sessionBinding.get(); },
@@ -115,6 +120,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
       const contextMode = nextTurnContextMode;
       currentTurnContextMode = contextMode;
       nextTurnContextMode = "rebuild";
+      lifecycle.clearPendingAction();
       const turnStartedAt = Date.now();
       const codexTransportStatsBefore = getCodexTransportDebugSnapshot(sessionBinding.get());
       const turnLog = beginLoggedTurn({ logger, engine, modelId, provider, contextMode, userMessage, userRecallHints, startedAt: turnStartedAt }); currentTurnId = turnLog.turnId;
@@ -135,6 +141,8 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
           draft: result?.draft ?? "",
           durationMs: Date.now() - turnStartedAt,
         }, (notificationResult) => { lastNotificationResult = notificationResult; });
+        const lifecycleAction = lifecycle.takePendingAction();
+        if (lifecycleAction) result.lifecycleAction = lifecycleAction;
         turnLog.endSuccess(result);
         return result;
       } catch (err) {
@@ -171,6 +179,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
       return result;
     },
     getCurrentModel() { return _currentFastEntry ?? sessionBinding.get().model; },
+    ...providerQuotaRuntime,
     async setModel(model) {
       const activeSession = sessionBinding.get();
       const { baseId, isFast } = fromFastEntryModel(model);
@@ -186,21 +195,11 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
       return model;
     },
     getScopedModels() { return appendFastVariants(sessionBinding.get().scopedModels); },
-    getConfiguredProviders() {
-      const configured = Object.values(providers ?? {}).map((profile) => profile?.type).filter(Boolean);
-      const available = (modelRegistry.getAvailable?.() ?? []).map((model) => model.provider);
-      return [...new Set([...configured, ...available])];
-    },
+    getConfiguredProviders() { return [...new Set([...Object.values(providers ?? {}).map((profile) => profile?.type).filter(Boolean), ...(modelRegistry.getAvailable?.() ?? []).map((model) => model.provider)])]; },
     getSessionStats() { return getRunnerSessionStats(sessionBinding.get(), runtimeHost); },
     getLastNotificationResult() { return lastNotificationResult; },
     async notifyTest({ title = "March", message = "If you see this, March runtime notifications work." } = {}) {
-      lastNotificationResult = await notifyTurnEndBestEffort(turnNotifier, {
-        status: "success",
-        sessionName: engine.sessionName,
-        title,
-        message,
-        durationMs: 0,
-      });
+      lastNotificationResult = await notifyTurnEndBestEffort(turnNotifier, { status: "success", sessionName: engine.sessionName, title, message, durationMs: 0 });
       return lastNotificationResult;
     },
     estimateContextTokens(userMessage = "") {
@@ -254,6 +253,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
         () => shellRuntime?.dispose?.() ?? shellRuntime?.killAll?.(),
         () => lspService.dispose(),
         () => mcpClientManager?.disconnectAll?.(),
+        () => providerQuotaRuntime.disposeProviderQuotaRuntime(),
         () => detachRuntimeUi(),
       ]);
     },

package/src/agent/runtime/remote-runner-client.mjs

@@ -1,8 +1,14 @@
+import { createRunnerEngineStateFacade } from "./state/runner-state.mjs";
+
 export function createRemoteRunnerClient(peer, { initialState = null } = {}) {
   let state = initialState;
+  const engineFacade = createRunnerEngineStateFacade({
+    getState: () => state,
+    setState: (nextState) => { state = nextState; },
+  });
 
   const client = {
-    get engine() { return createEngineFacade(); },
+    get engine() { return engineFacade; },
     get runtimeState() { return state; },
     async init(options = {}) {
       state = await peer.call("init", options);
@@ -20,6 +26,8 @@ export function createRemoteRunnerClient(peer, { initialState = null } = {}) {
     getScopedModels: () => state?.scopedModels ?? [],
     getConfiguredProviders: () => state?.configuredProviders ?? [],
     getSessionStats: () => state?.sessionStats ?? null,
+    getCachedProviderQuotaSnapshot: () => state?.providerQuota ?? null,
+    async getProviderQuotaSnapshot(options = {}) { return applyResultWithState(await peer.call("getProviderQuotaSnapshot", options)); },
     async refreshState() { return refreshState(); },
     getLastNotificationResult: () => peer.call("getLastNotificationResult"),
     notifyTest: (options) => peer.call("notifyTest", options),
@@ -56,18 +64,4 @@ export function createRemoteRunnerClient(peer, { initialState = null } = {}) {
     return response;
   }
 
-  function createEngineFacade() {
-    const engine = state?.engine ?? {};
-    return {
-      ...engine,
-      hasRenderedPendingAssistantRecallHints: () => true,
-      takePendingAssistantRecallHints: () => [],
-      peekPendingAssistantRecallHints: () => [],
-      markPendingAssistantRecallHintsRendered: () => {},
-      getRecentRecallMemoryIds: () => [],
-      restoreSession: () => {
-        throw new Error("remote runner session restore is not available");
-      },
-    };
-  }
 }

package/src/agent/runtime/runner-ipc-target.mjs

@@ -1,3 +1,5 @@
+import { createRunnerStateSnapshot } from "./state/runner-state.mjs";
+
 export function createRunnerIpcTarget({ createRunnerImpl, runnerOptions = {} } = {}) {
   if (typeof createRunnerImpl !== "function") throw new Error("createRunnerImpl is required");
 
@@ -35,6 +37,13 @@ export function createRunnerIpcTarget({ createRunnerImpl, runnerOptions = {} } =
     getSessionStats() {
       return getRunner().getSessionStats();
     },
+    async getProviderQuotaSnapshot(options = {}) {
+      const result = await getRunner().getProviderQuotaSnapshot(options);
+      return { result, state: getRunnerState(runner) };
+    },
+    getCachedProviderQuotaSnapshot() {
+      return getRunner().getCachedProviderQuotaSnapshot?.() ?? null;
+    },
     getState() {
       return getRunnerState(getRunner());
     },
@@ -100,26 +109,5 @@ export function createRunnerIpcTarget({ createRunnerImpl, runnerOptions = {} } =
 }
 
 export function getRunnerState(runner) {
-  const currentModel = runner.getCurrentModel?.() ?? null;
-  const scopedModels = runner.getScopedModels?.() ?? [];
-  const thinkingLevel = runner.getThinkingLevel?.() ?? runner.engine?.thinkingLevel ?? null;
-  return {
-    engine: {
-      cwd: runner.engine?.cwd ?? null,
-      modelId: runner.engine?.modelId ?? currentModel?.id ?? null,
-      provider: runner.engine?.provider ?? currentModel?.provider ?? null,
-      thinkingLevel,
-      sessionName: runner.engine?.sessionName ?? "",
-      turns: runner.engine?.turns ?? [],
-    },
-    currentModel,
-    scopedModels,
-    configuredProviders: runner.getConfiguredProviders?.() ?? [],
-    availableThinkingLevels: runner.getAvailableThinkingLevels?.() ?? [],
-    canSwitchPiSession: runner.canSwitchPiSession?.() ?? false,
-    sessionStats: runner.getSessionStats?.() ?? null,
-    lspStatus: runner.getLspStatus?.() ?? null,
-    extensionDiagnostics: runner.getExtensionDiagnostics?.() ?? [],
-    extensionLifecycleState: runner.getExtensionLifecycleState?.() ?? null,
-  };
+  return createRunnerStateSnapshot(runner);
 }

package/src/agent/runtime/runner-process-client.mjs

@@ -14,34 +14,111 @@ export async function createRunnerProcessClient({
   forkImpl = fork,
   timeoutMs = 0,
 } = {}) {
-  const child = forkImpl(entry, [], {
-    stdio: ["ignore", "inherit", "inherit", "ipc"],
-  });
-  const peer = createProcessRuntimeIpcPeer({
-    processLike: child,
-    target: {
-      ...createRuntimeUiEventTarget(ui),
-      modelPayload: (event) => onModelPayload?.(event),
+  let active = await startRuntime();
+  let disposed = false;
+  const localProps = new Map();
+
+  const runner = new Proxy({}, {
+    get(_target, prop) {
+      if (prop === "restartRuntime") return restartRuntime;
+      if (prop === "dispose") return dispose;
+      if (localProps.has(prop)) return localProps.get(prop);
+      const value = active.runner[prop];
+      return typeof value === "function" ? value.bind(active.runner) : value;
+    },
+    set(_target, prop, value) {
+      localProps.set(prop, value);
+      return true;
+    },
+    has(_target, prop) {
+      return prop === "restartRuntime" || prop === "dispose" || localProps.has(prop) || prop in active.runner;
     },
-    timeoutMs,
   });
-  const runner = createRemoteRunnerClient(peer);
-  try {
-    await runner.init(runnerOptions);
-  } catch (error) {
-    peer.dispose();
-    child.kill?.();
-    throw error;
-  }
 
-  const remoteDispose = runner.dispose;
-  const dispose = async () => {
+  return { runner, get child() { return active.child; }, dispose };
+
+  async function startRuntime() {
+    const child = forkImpl(entry, [], {
+      stdio: ["ignore", "inherit", "inherit", "ipc"],
+    });
+    const peer = createProcessRuntimeIpcPeer({
+      processLike: child,
+      target: {
+        ...createRuntimeUiEventTarget(ui),
+        modelPayload: (event) => onModelPayload?.(event),
+      },
+      timeoutMs,
+    });
+    const remoteRunner = createRemoteRunnerClient(peer);
     try {
-      await remoteDispose.call(runner);
-    } finally {
+      await waitForRuntimeInit({ child, initPromise: remoteRunner.init(runnerOptions) });
+    } catch (error) {
+      peer.dispose();
       child.kill?.();
+      throw error;
+    }
+    return {
+      runner: remoteRunner,
+      child,
+      async dispose() {
+        try {
+          await remoteRunner.dispose();
+        } finally {
+          child.kill?.();
+        }
+      },
+    };
+  }
+
+  async function restartRuntime({ restoreSession = true } = {}) {
+    if (disposed) throw new Error("runtime runner is already disposed");
+    const previousState = await refreshRunnerState(active.runner);
+    const previousSessionFile = previousState?.sessionStats?.sessionFile ?? previousState?.sessionStats?.sessionPath ?? null;
+    const previousActive = active;
+    await previousActive.dispose();
+    active = await startRuntime();
+
+    // Rebind the same persisted pi session after the fresh child imports updated source.
+    if (restoreSession && previousSessionFile && active.runner.canSwitchPiSession?.()) {
+      await active.runner.switchPiSession(previousSessionFile, previousState?.engine ?? null);
     }
-  };
-  runner.dispose = dispose;
-  return { runner, child, dispose };
+    return await refreshRunnerState(active.runner);
+  }
+
+  async function dispose() {
+    if (disposed) return;
+    disposed = true;
+    await active.dispose();
+  }
 }
+
+async function refreshRunnerState(runner) {
+  if (typeof runner.refreshState === "function") return await runner.refreshState();
+  return runner.runtimeState ?? null;
+}
+
+function waitForRuntimeInit({ child, initPromise }) {
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const cleanup = () => {
+      child.off?.("exit", onExit);
+      child.off?.("error", onError);
+    };
+    const finish = (fn, value) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      fn(value);
+    };
+    const onExit = (code, signal) => {
+      const codeText = code == null ? "" : ` with code ${code}`;
+      const signalText = signal ? ` (${signal})` : "";
+      finish(reject, new Error(`Runtime process exited during startup${codeText}${signalText}`));
+    };
+    const onError = (error) => finish(reject, error);
+
+    child.once?.("exit", onExit);
+    child.once?.("error", onError);
+    initPromise.then((value) => finish(resolve, value), (error) => finish(reject, error));
+  });
+}

package/src/agent/runtime/runner-runtime-host.mjs

@@ -24,6 +24,7 @@ export async function createRunnerRuntimeHost({
   lspService = null,
   mcpTools = [],
   webTools = [],
+  lifecycle = null,
   permissionController = null,
   extensionPaths = [],
   hostedTools = {},
@@ -59,6 +60,7 @@ export async function createRunnerRuntimeHost({
         lspService,
         mcpTools,
         webTools,
+        lifecycle,
         permissionController,
         authStorage,
         projectMarchDir,

package/src/agent/runtime/state/runner-state.mjs

@@ -0,0 +1,81 @@
+export function createRunnerStateSnapshot(runner) {
+  const currentModel = runner.getCurrentModel?.() ?? null;
+  const scopedModels = runner.getScopedModels?.() ?? [];
+  const thinkingLevel = runner.getThinkingLevel?.() ?? runner.engine?.thinkingLevel ?? null;
+  const engine = runner.engine ?? {};
+  return {
+    engine: {
+      cwd: engine.cwd ?? null,
+      modelId: engine.modelId ?? currentModel?.id ?? null,
+      provider: engine.provider ?? currentModel?.provider ?? null,
+      thinkingLevel,
+      sessionName: engine.sessionName ?? "",
+      remoteMemorySources: engine.remoteMemorySources ?? [],
+      turns: engine.turns ?? [],
+      pendingAssistantRecallHints: engine.peekPendingAssistantRecallHints?.() ?? engine.pendingAssistantRecallHints ?? [],
+      pendingAssistantRecallHintsRendered: engine.hasRenderedPendingAssistantRecallHints?.() ?? engine.pendingAssistantRecallHintsRendered ?? false,
+      recentRecallMemoryIds: [...(engine.getRecentRecallMemoryIds?.() ?? [])],
+    },
+    currentModel,
+    scopedModels,
+    configuredProviders: runner.getConfiguredProviders?.() ?? [],
+    availableThinkingLevels: runner.getAvailableThinkingLevels?.() ?? [],
+    canSwitchPiSession: runner.canSwitchPiSession?.() ?? false,
+    sessionStats: runner.getSessionStats?.() ?? null,
+    providerQuota: runner.getCachedProviderQuotaSnapshot?.() ?? null,
+    lspStatus: runner.getLspStatus?.() ?? null,
+    extensionDiagnostics: runner.getExtensionDiagnostics?.() ?? [],
+    extensionLifecycleState: runner.getExtensionLifecycleState?.() ?? null,
+  };
+}
+
+export function createRunnerEngineStateFacade({ getState, setState }) {
+  return {
+    get cwd() { return engineState(getState()).cwd ?? null; },
+    get modelId() { return engineState(getState()).modelId ?? null; },
+    get provider() { return engineState(getState()).provider ?? null; },
+    get thinkingLevel() { return engineState(getState()).thinkingLevel ?? null; },
+    get sessionName() { return engineState(getState()).sessionName ?? ""; },
+    get remoteMemorySources() { return engineState(getState()).remoteMemorySources ?? []; },
+    get turns() { return engineState(getState()).turns ?? []; },
+    peekPendingAssistantRecallHints() {
+      return engineState(getState()).pendingAssistantRecallHints ?? [];
+    },
+    hasRenderedPendingAssistantRecallHints() {
+      return Boolean(engineState(getState()).pendingAssistantRecallHintsRendered);
+    },
+    markPendingAssistantRecallHintsRendered() {
+      updateEngineState(getState, setState, (engine) => {
+        if ((engine.pendingAssistantRecallHints ?? []).length > 0) {
+          engine.pendingAssistantRecallHintsRendered = true;
+        }
+      });
+    },
+    takePendingAssistantRecallHints() {
+      const hints = engineState(getState()).pendingAssistantRecallHints ?? [];
+      updateEngineState(getState, setState, (engine) => {
+        engine.pendingAssistantRecallHints = [];
+        engine.pendingAssistantRecallHintsRendered = false;
+      });
+      return hints;
+    },
+    getRecentRecallMemoryIds() {
+      return engineState(getState()).recentRecallMemoryIds ?? [];
+    },
+    restoreSession() {
+      throw new Error("remote runner session restore is not available");
+    },
+  };
+}
+
+function engineState(state) {
+  return state?.engine ?? {};
+}
+
+function updateEngineState(getState, setState, update) {
+  const state = getState();
+  if (!state) return;
+  const engine = { ...(state.engine ?? {}) };
+  update(engine);
+  setState({ ...state, engine });
+}

package/src/agent/runtime/ui-event-bridge.mjs

@@ -51,6 +51,7 @@ export function createRuntimeUiClient(eventBus) {
     status: (text) => eventBus.emit({ type: "status", text }),
     debugLines: (lines) => eventBus.emit({ type: "debug_lines", lines }),
     recall: ({ source, hints }) => eventBus.emit({ type: "recall", source, hints }),
+    providerQuotaSnapshot: (snapshot) => eventBus.emit({ type: "provider_quota_snapshot", snapshot }),
     editDiff: (path, diffLines) => eventBus.emit({ type: "edit_diff", path, diffLines }),
     requestPermission: (request) => eventBus.request({ type: "permission_request", ...request }),
   };
@@ -72,6 +73,7 @@ export function dispatchRuntimeUiEvent(ui, event) {
     case "status": return ui.status?.(event.text);
     case "debug_lines": return writeDebugLines(ui, event.lines);
     case "recall": return ui.recall?.({ source: event.source, hints: event.hints });
+    case "provider_quota_snapshot": return ui.providerQuotaSnapshot?.(event.snapshot);
     case "edit_diff": return ui.editDiff?.(event.path, event.diffLines);
     case "permission_request": return ui.requestPermission?.({ toolName: event.toolName, params: event.params, category: event.category });
     default: return undefined;

package/src/agent/session/session-options.mjs

@@ -14,6 +14,7 @@ export function resolveRunnerSessionOptions({
   lspService = null,
   mcpTools = [],
   webTools = [],
+  lifecycle = null,
   permissionController = null,
   authStorage = null,
   projectMarchDir = null,
@@ -30,7 +31,7 @@ export function resolveRunnerSessionOptions({
     ?? (provider && modelId ? getModel(provider, modelId) : null);
   if (!model) throw new Error(`Model not found: ${provider}/${modelId}`);
 
-  const customTools = createMarchCustomTools({ cwd, engine, ui, memoryTools, shellRuntime, lspService, mcpTools, webTools, permissionController, authStorage, projectMarchDir, stateRoot, getCurrentModel: () => getCurrentModel?.() ?? model });
+  const customTools = createMarchCustomTools({ cwd, engine, ui, memoryTools, shellRuntime, lspService, mcpTools, webTools, lifecycle, permissionController, authStorage, projectMarchDir, stateRoot, getCurrentModel: () => getCurrentModel?.() ?? model });
   const customToolNames = customTools.map((tool) => tool.name);
   const tools = [
     ...customToolNames.filter((name) => name === "read"),

package/src/agent/tools.mjs

@@ -1,4 +1,5 @@
 import { createCommandExecTool } from "./command-exec-tool.mjs";
+import { createCodeSearchTool } from "./code-search/tool.mjs";
 import { createContextStatsTool } from "./context-stats-tool.mjs";
 import { createEditFileTool } from "./file-edit-tool.mjs";
 import { createReadFileTool } from "./file-tools/read-file-tool.mjs";
@@ -11,9 +12,11 @@ import { createShellTools } from "../shell/tools.mjs";
 import { initImageGen } from "../image-gen/index.mjs";
 import { createSuperGrokTool } from "../supergrok/tool.mjs";
 import { createBrowserTools } from "../browser/tools/index.mjs";
+import { createRuntimeRestartTool } from "./lifecycle/runtime-restart-tool.mjs";
 
-export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shellRuntime = null, lspService = null, mcpTools = [], webTools = [], permissionController = null, authStorage = null, projectMarchDir = null, stateRoot = null, getCurrentModel = null }) {
+export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shellRuntime = null, lspService = null, mcpTools = [], webTools = [], lifecycle = null, permissionController = null, authStorage = null, projectMarchDir = null, stateRoot = null, getCurrentModel = null }) {
   const commandExecTool = createCommandExecTool({ cwd });
+  const codeSearchTool = createCodeSearchTool({ engine, stateRoot });
   const contextStatsTool = createContextStatsTool({ engine });
   const editFileTool = createEditFileTool({ engine, ui, lspService });
   const readFileTool = createReadFileTool({ engine });
@@ -29,12 +32,14 @@ export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shel
     screenTool,
     listWindowsTool,
     contextStatsTool,
+    codeSearchTool,
     commandExecTool,
     editFileTool,
     ...createShellTools(shellRuntime),
     ...memoryTools,
     ...mcpTools,
     ...webTools,
+    ...(lifecycle ? [createRuntimeRestartTool({ lifecycle })] : []),
     ...createBrowserTools({ stateRoot }),
     ...(authStorage ? [createSuperGrokTool({ authStorage, projectMarchDir })] : []),
     ...(authStorage ? initImageGen({ authStorage, projectMarchDir }) : []),

package/src/cli/args.mjs

@@ -20,15 +20,18 @@ export function parseCliArgs(argv) {
       "permission-mode": { type: "string" },
       host: { type: "string" },
       port: { type: "string" },
+      "api-port": { type: "string" },
       name: { type: "string" },
       token: { type: "string" },
       foreground: { type: "boolean" },
+      workspace: { type: "string" },
+      dev: { type: "boolean" },
       help: { type: "boolean", short: "h" },
     },
     allowPositionals: true,
   });
 
-  const commandName = ["login", "provider", "websearch", "memory", "browser", "gateway"].includes(positionals[0]) ? positionals[0] : null;
+  const commandName = ["login", "provider", "web", "websearch", "memory", "browser", "gateway"].includes(positionals[0]) ? positionals[0] : null;
 
   return {
     command: commandName ? { name: commandName, args: positionals.slice(1) } : null,
@@ -47,9 +50,12 @@ export function parseCliArgs(argv) {
     permissionMode: values["permission-mode"] ?? "bypassPermissions",
     host: values.host ?? null,
     port: values.port ?? null,
+    apiPort: values["api-port"] ?? null,
     name: values.name ?? null,
     token: values.token ?? null,
     foreground: values.foreground ?? false,
+    workspace: values.workspace ?? null,
+    dev: values.dev ?? false,
     help: values.help ?? false,
     prompt: commandName ? "" : positionals.join(" "),
   };
@@ -65,6 +71,8 @@ Usage:
   march provider --config    Configure provider credentials
   march provider share [id]  Share a provider profile
   march provider accept <token>
+  march web [path]       Start the local Web UI session manager
+  march web --dev        Start Web UI with Vite hot reload
   march websearch --config   Configure web search credentials
   march memory serve [folder]
   march memory add <url>
@@ -92,8 +100,11 @@ Options:
   --permission-mode <mode>  Permission mode: default, bypassPermissions, dontAsk (default: bypassPermissions)
   -e, --extension <path>
                        Load a pi extension path in the default runtime host (repeatable)
-  --host <host>        With memory serve, bind host (default: 127.0.0.1)
-  --port <port>        With memory serve, bind port (default: 4317)
+  --host <host>        With memory serve/web, bind host (default: 127.0.0.1)
+  --port <port>        With memory serve/web, bind port
+  --api-port <port>    With web --dev, bind API backend port
+  --workspace <path>   With web, open an initial workspace session
+  --dev                With web, use Vite dev server and proxy /api
   --name <name>        With memory serve/add, remote memory source name
   --foreground         With memory serve, run server in current process
   -h, --help           Show this help

package/src/cli/commands/catalog/visible-commands.mjs

@@ -0,0 +1,5 @@
+export {
+  getAutocompleteCommands,
+  getHelpCommandSyntaxes,
+  getVisibleCommandEntries,
+} from "../registry/slash-command-registry.mjs";

package/src/cli/commands/help-command.mjs

@@ -1,7 +1 @@
-export function formatHelpLines() {
-  return [
-    "Commands: /new, /exit, /help, /hotkeys, /templates, /do, /discuss, /mode, /export jsonl, /export html, /export gist <jsonl|html>, /settings, /extensions, /providers, /providers <name>, /model, /models, /session, /status, /shell, /shell spawn [name], /save, /name, /copy",
-    "Sessions: /session opens previous sessions and restores the selected one.",
-    "Shortcuts: Tab = toggle Do/Discuss, Esc = abort turn, Ctrl+C = abort turn / press twice to exit when idle, Ctrl+O = toggle tool output, Alt+S = shell pane, Alt+N = next shell, Alt+K/J = shell scroll, PageUp/PageDown = output scroll, Ctrl+G = external editor, Shift+Tab = thinking selector, Ctrl+T = thinking selector, Ctrl+L = model selector",
-  ];
-}
+export { formatHelpLines } from "./registry/slash-command-registry.mjs";