march-cli 0.1.33 → 0.1.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "march-cli",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "March CLI — terminal-native coding agent with context reconstruction",
   "type": "module",
   "main": "./src/main.mjs",
@@ -22,6 +22,9 @@
     "docs:dev": "vitepress dev docs --host 127.0.0.1",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs --host 127.0.0.1",
+    "web:dev": "node bin/march.mjs web --dev",
+    "web:build": "tsc -p src/web-ui/tsconfig.json && vite build --config src/web-ui/vite.config.mjs",
+    "web:preview": "npm run web:build && node src/web-ui/server.mjs",
     "context": "cd .. && node march-cli/bin/march.mjs --dump-context",
     "notify:experiment": "node scripts/notify-experiment.mjs",
     "publish:env": "node scripts/npm-publish-from-env.mjs"
@@ -31,10 +34,13 @@
     "@earendil-works/pi-coding-agent": "^0.74.0",
     "@earendil-works/pi-tui": "^0.74.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@pierre/trees": "^1.0.0-beta.4",
     "@xterm/headless": "^5.5.0",
     "marked": "^18.0.3",
     "node-notifier": "^10.0.1",
     "node-pty": "^1.1.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typebox": "^1.0.58",
     "undici": "^7.25.0",
     "web-tree-sitter": "^0.26.8",
@@ -44,6 +50,11 @@
     "@vscode/ripgrep": "^1.18.0"
   },
   "devDependencies": {
+    "@types/react": "^18.3.29",
+    "@types/react-dom": "^18.3.7",
+    "@vitejs/plugin-react": "^6.0.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.14",
     "vitepress": "^1.6.4"
   }
 }

package/src/agent/lifecycle/runner-lifecycle.mjs

@@ -0,0 +1,16 @@
+export function createRunnerLifecycle() {
+  let pendingAction = null;
+  return {
+    requestRuntimeRestart({ reason = "" } = {}) {
+      pendingAction = { type: "restart_runtime", reason };
+    },
+    takePendingAction() {
+      const action = pendingAction;
+      pendingAction = null;
+      return action;
+    },
+    clearPendingAction() {
+      pendingAction = null;
+    },
+  };
+}

package/src/agent/lifecycle/runtime-restart-tool.mjs

@@ -0,0 +1,22 @@
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { toolText } from "../tool-result.mjs";
+
+export function createRuntimeRestartTool({ lifecycle }) {
+  return defineTool({
+    name: "request_runtime_restart",
+    label: "Request Runtime Restart",
+    description: "Request March to restart the runtime after the current turn so the next turn loads updated runner/tool code from disk.",
+    parameters: Type.Object({
+      reason: Type.Optional(Type.String({ description: "Why the runtime needs to restart" })),
+    }),
+    execute: async (_toolCallId, params = {}) => {
+      const reason = String(params.reason ?? "").trim();
+      lifecycle?.requestRuntimeRestart?.({ reason });
+      return toolText(
+        "March runtime restart requested. The current turn will finish first; the next turn will use the latest code from disk.",
+        { lifecycleAction: { type: "restart_runtime", reason } },
+      );
+    },
+  });
+}

package/src/agent/runner.mjs

@@ -26,6 +26,7 @@ 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";
 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 +59,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 +72,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 +84,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,
     });
@@ -115,6 +117,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 +138,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) {
@@ -186,21 +191,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 = "") {

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);
@@ -56,18 +62,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");
 
@@ -100,26 +102,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,80 @@
+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,
+    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/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

@@ -11,8 +11,9 @@ 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 contextStatsTool = createContextStatsTool({ engine });
   const editFileTool = createEditFileTool({ engine, ui, lspService });
@@ -35,6 +36,7 @@ export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shel
     ...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";