Function handleSlashCommand

src/cli/slash-commands.ts:45–1357

(input: string, sessionId: string, cwd: string, config?: any)

}

export async function handleSlashCommand(input: string, sessionId: string, cwd: string, config?: any): Promise<SlashResult> {
  const trimmed = input.trim();
  if (!trimmed.startsWith('/')) return { handled: false };

  const [cmd, ...args] = trimmed.slice(1).split(/\s+/);
  const arg = args.join(' ');

  // A real slash command is `/name` where name is a plain identifier (letters, digits,
  // -, _). Anything else that merely starts with '/' — an absolute file path like
  // `/Users/me/pic.png ...`, a URL, etc. — is NOT a command. Let it through as a normal
  // message so the agent (and tools like vision_analyze) can act on it, instead of
  // erroring "Unknown command". Typos like `/helpp` still match the shape → handled below.
  if (!/^[a-zA-Z][\w-]*$/.test(cmd ?? '')) {
    return { handled: false };
  }

  switch (cmd) {
    case 'btw': {
      // When a task is running, `/btw` is intercepted in the UI and injected live.
      // Reaching here means it was typed while IDLE — there's nothing to steer.
      return {
        handled: true,
        message: '/btw steers a task that is already running. Nothing is running right now — just type your request normally, or run a task and use /btw <note> mid-flight to nudge it.',
      };
    }
    case 'flywheel': {
      const { countTrajectories, getTrajectoryDatasetPath } = await import('../agent/trajectory.js');
      const enabled = (config as any)?.flywheel?.enabled === true;
      const sandboxOn = (config as any)?.sandbox?.enabled === true;
      const count = await countTrajectories(cwd);
      const datasetPath = getTrajectoryDatasetPath(cwd);
      const lines = [
        `Data flywheel: ${enabled ? 'ON' : 'OFF'}${enabled && !sandboxOn ? ' (but needs sandbox.enabled too!)' : ''}`,
        `Recorded trajectories for this project: ${count}`,
        `Dataset: ${datasetPath}`,
        '',
        enabled
          ? 'Each successful sandboxed+merged task appends one training example (local only).'
          : 'Enable with flywheel.enabled: true AND sandbox.enabled: true in ~/.qodex/config.yaml.',
      ];
      return { handled: true, message: lines.join('\n') };
    }

    case 'trellis': {
      const sub = arg.trim().toLowerCase();
      const { loadTrellisContext } = await import('../context/trellis.js');
      if (sub === 'init') {
        // Scaffold an empty .trellis/ tree so the user (or the official Trellis
        // CLI) can fill it. We only create dirs + a starter spec; we never
        // overwrite existing files.
        const fs = await import('fs');
        const path = await import('path');
        const base = path.join(cwd, '.trellis');
        const made: string[] = [];
        for (const d of ['spec', 'tasks', 'workspace']) {
          const dir = path.join(base, d);
          if (!fs.existsSync(dir)) { fs.mkdirSync(dir, { recursive: true }); made.push(`.trellis/${d}/`); }
        }