@bastani/atomic 0.5.3-1 → 0.5.4-0

package/dist/sdk/workflows/builtin/deep-research-codebase/opencode/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * deep-research-codebase / opencode
+ *
+ * OpenCode replica of the Claude deep-research-codebase workflow. The Claude
+ * version dispatches specialist sub-agents (codebase-locator, codebase-
+ * analyzer, etc.) inside a single explorer session via `@"name (agent)"`
+ * syntax — a Claude-specific feature. OpenCode sessions are bound to a
+ * single agent for their lifetime, so we keep the SAME graph topology
+ * (scout ∥ history → explorer-1..N → aggregator) but drive each explorer
+ * through the locate → analyze → patterns → synthesize sequence inline using
+ * the default agent's built-in file tools.
+ *
+ * Topology (identical to Claude version):
+ *
+ *           ┌─→ codebase-scout
+ *   parent ─┤
+ *           └─→ research-history
+ *                     │
+ *                     ▼
+ *   ┌──────────────────────────────────────────────────┐
+ *   │  explorer-1   explorer-2   ...   explorer-N      │   (Promise.all)
+ *   └──────────────────────────────────────────────────┘
+ *                     │
+ *                     ▼
+ *                aggregator
+ *
+ * OpenCode-specific concerns baked in:
+ *
+ *  • F5 — every `ctx.stage()` call is a FRESH session with no memory of
+ *    prior stages. We forward the scout overview, history overview, and
+ *    partition assignment explicitly into each explorer's first prompt.
+ *
+ *  • F9 — `s.save()` receives the `{ info, parts }` payload from
+ *    `s.client.session.prompt()` via `result.data!`. Passing the full
+ *    `result` (with its wrapping) or raw `result.data.parts` breaks
+ *    downstream `transcript()` reads.
+ *
+ *  • F6 — every prompt explicitly requires trailing prose AFTER any tool
+ *    call so the rendered transcript has content. OpenCode's `parts` array
+ *    mixes text/tool/reasoning/file parts; without trailing text the
+ *    transcript extractor returns an empty string.
+ *
+ *  • F3 — transcript extraction relies on the runtime's text-only rendering
+ *    of `result.data.parts`. The helpers call `ctx.transcript(handle)` which
+ *    returns `{ path, content }` where content is already text-filtered.
+ */
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode">;
+export default _default;

package/dist/sdk/workflows/builtin/ralph/claude/index.js

@@ -12,7 +12,7 @@ import {
 import"../../../../../chunk-1gb5qxz9.js";
 import {
   defineWorkflow
-} from "../../../../../chunk-mn870nrv.js";
+} from "../../../../../chunk-xkxndz5g.js";
 
 // src/sdk/workflows/builtin/ralph/claude/index.ts
 var MAX_LOOPS = 10;
@@ -24,12 +24,13 @@ var claude_default = defineWorkflow({
   name: "ralph",
   description: "Plan \u2192 orchestrate \u2192 review \u2192 debug loop with bounded iteration"
 }).run(async (ctx) => {
+  const prompt = ctx.inputs.prompt ?? "";
   let consecutiveClean = 0;
   let debuggerReport = "";
   for (let iteration = 1;iteration <= MAX_LOOPS; iteration++) {
     const plannerName = `planner-${iteration}`;
     await ctx.stage({ name: plannerName }, {}, {}, async (s) => {
-      await s.session.query(asAgentCall("planner", buildPlannerPrompt(s.userPrompt, {
+      await s.session.query(asAgentCall("planner", buildPlannerPrompt(prompt, {
         iteration,
         debuggerReport: debuggerReport || undefined
       })));
@@ -37,13 +38,13 @@ var claude_default = defineWorkflow({
     });
     const orchName = `orchestrator-${iteration}`;
     await ctx.stage({ name: orchName }, {}, {}, async (s) => {
-      await s.session.query(asAgentCall("orchestrator", buildOrchestratorPrompt(s.userPrompt)));
+      await s.session.query(asAgentCall("orchestrator", buildOrchestratorPrompt(prompt)));
       s.save(s.sessionId);
     });
     let gitStatus = await safeGitStatusS();
     const reviewerName = `reviewer-${iteration}`;
     const review = await ctx.stage({ name: reviewerName }, {}, {}, async (s) => {
-      const result = await s.session.query(asAgentCall("reviewer", buildReviewPrompt(s.userPrompt, { gitStatus, iteration })));
+      const result = await s.session.query(asAgentCall("reviewer", buildReviewPrompt(prompt, { gitStatus, iteration })));
       s.save(s.sessionId);
       return result.output;
     });
@@ -56,7 +57,7 @@ var claude_default = defineWorkflow({
       gitStatus = await safeGitStatusS();
       const confirmName = `reviewer-${iteration}-confirm`;
       const confirm = await ctx.stage({ name: confirmName }, {}, {}, async (s) => {
-        const result = await s.session.query(asAgentCall("reviewer", buildReviewPrompt(s.userPrompt, {
+        const result = await s.session.query(asAgentCall("reviewer", buildReviewPrompt(prompt, {
           gitStatus,
           iteration,
           isConfirmationPass: true

package/dist/sdk/workflows/builtin/ralph/copilot/index.js

@@ -12,7 +12,7 @@ import {
 import"../../../../../chunk-1gb5qxz9.js";
 import {
   defineWorkflow
-} from "../../../../../chunk-mn870nrv.js";
+} from "../../../../../chunk-xkxndz5g.js";
 
 // src/sdk/workflows/builtin/ralph/copilot/index.ts
 var MAX_LOOPS = 10;
@@ -27,13 +27,14 @@ var copilot_default = defineWorkflow({
   name: "ralph",
   description: "Plan \u2192 orchestrate \u2192 review \u2192 debug loop with bounded iteration"
 }).run(async (ctx) => {
+  const userPromptText = ctx.inputs.prompt ?? "";
   let consecutiveClean = 0;
   let debuggerReport = "";
   for (let iteration = 1;iteration <= MAX_LOOPS; iteration++) {
     const plannerName = `planner-${iteration}`;
     const planner = await ctx.stage({ name: plannerName }, {}, { agent: "planner" }, async (s) => {
       await s.session.sendAndWait({
-        prompt: buildPlannerPrompt(s.userPrompt, {
+        prompt: buildPlannerPrompt(userPromptText, {
           iteration,
           debuggerReport: debuggerReport || undefined
         })
@@ -45,7 +46,7 @@ var copilot_default = defineWorkflow({
     const orchName = `orchestrator-${iteration}`;
     await ctx.stage({ name: orchName }, {}, { agent: "orchestrator" }, async (s) => {
       await s.session.sendAndWait({
-        prompt: buildOrchestratorPrompt(s.userPrompt, {
+        prompt: buildOrchestratorPrompt(userPromptText, {
           plannerNotes: planner.result
         })
       }, AGENT_SEND_TIMEOUT_MS);
@@ -55,7 +56,7 @@ var copilot_default = defineWorkflow({
     const reviewerName = `reviewer-${iteration}`;
     const review = await ctx.stage({ name: reviewerName }, {}, { agent: "reviewer" }, async (s) => {
       await s.session.sendAndWait({
-        prompt: buildReviewPrompt(s.userPrompt, {
+        prompt: buildReviewPrompt(userPromptText, {
           gitStatus,
           iteration
         })
@@ -74,7 +75,7 @@ var copilot_default = defineWorkflow({
       const confirmName = `reviewer-${iteration}-confirm`;
       const confirm = await ctx.stage({ name: confirmName }, {}, { agent: "reviewer" }, async (s) => {
         await s.session.sendAndWait({
-          prompt: buildReviewPrompt(s.userPrompt, {
+          prompt: buildReviewPrompt(userPromptText, {
             gitStatus,
             iteration,
             isConfirmationPass: true

package/dist/sdk/workflows/builtin/ralph/opencode/index.js

@@ -12,7 +12,7 @@ import {
 import"../../../../../chunk-1gb5qxz9.js";
 import {
   defineWorkflow
-} from "../../../../../chunk-mn870nrv.js";
+} from "../../../../../chunk-xkxndz5g.js";
 
 // src/sdk/workflows/builtin/ralph/opencode/index.ts
 var MAX_LOOPS = 10;
@@ -25,6 +25,7 @@ var opencode_default = defineWorkflow({
   name: "ralph",
   description: "Plan \u2192 orchestrate \u2192 review \u2192 debug loop with bounded iteration"
 }).run(async (ctx) => {
+  const prompt = ctx.inputs.prompt ?? "";
   let consecutiveClean = 0;
   let debuggerReport = "";
   for (let iteration = 1;iteration <= MAX_LOOPS; iteration++) {
@@ -35,7 +36,7 @@ var opencode_default = defineWorkflow({
         parts: [
           {
             type: "text",
-            text: buildPlannerPrompt(s.userPrompt, {
+            text: buildPlannerPrompt(prompt, {
               iteration,
               debuggerReport: debuggerReport || undefined
             })
@@ -53,7 +54,7 @@ var opencode_default = defineWorkflow({
         parts: [
           {
             type: "text",
-            text: buildOrchestratorPrompt(s.userPrompt, {
+            text: buildOrchestratorPrompt(prompt, {
               plannerNotes: planner.result
             })
           }
@@ -70,7 +71,7 @@ var opencode_default = defineWorkflow({
         parts: [
           {
             type: "text",
-            text: buildReviewPrompt(s.userPrompt, {
+            text: buildReviewPrompt(prompt, {
               gitStatus,
               iteration
             })
@@ -95,7 +96,7 @@ var opencode_default = defineWorkflow({
           parts: [
             {
               type: "text",
-              text: buildReviewPrompt(s.userPrompt, {
+              text: buildReviewPrompt(prompt, {
                 gitStatus,
                 iteration,
                 isConfirmationPass: true

package/dist/sdk/workflows/index.d.ts

@@ -6,7 +6,7 @@
  * for spawning agent sessions using native TypeScript control flow.
  */
 export { defineWorkflow, WorkflowBuilder } from "../define-workflow.js";
-export type { AgentType, Transcript, SavedMessage, SaveTranscript, SessionContext, SessionRef, SessionHandle, SessionRunOptions, WorkflowContext, WorkflowOptions, WorkflowDefinition, StageClientOptions, StageSessionOptions, ProviderClient, ProviderSession, CopilotClient, CopilotClientOptions, CopilotSession, CopilotSessionConfig, OpencodeClient, OpencodeSession, ClaudeClientWrapper, ClaudeSessionWrapper, ClaudeQueryDefaults, } from "../types.js";
+export type { AgentType, Transcript, SavedMessage, SaveTranscript, SessionContext, SessionRef, SessionHandle, SessionRunOptions, WorkflowContext, WorkflowOptions, WorkflowDefinition, WorkflowInput, WorkflowInputType, StageClientOptions, StageSessionOptions, ProviderClient, ProviderSession, CopilotClient, CopilotClientOptions, CopilotSession, CopilotSessionConfig, OpencodeClient, OpencodeSession, ClaudeClientWrapper, ClaudeSessionWrapper, ClaudeQueryDefaults, } from "../types.js";
 export type { SessionEvent as CopilotSessionEvent } from "@github/copilot-sdk";
 export type { SessionPromptResponse as OpenCodePromptResponse } from "@opencode-ai/sdk/v2";
 export type { SessionMessage as ClaudeSessionMessage } from "@anthropic-ai/claude-agent-sdk";
@@ -16,9 +16,9 @@ export { validateCopilotWorkflow } from "../providers/copilot.js";
 export type { CopilotValidationWarning } from "../providers/copilot.js";
 export { validateOpenCodeWorkflow } from "../providers/opencode.js";
 export type { OpenCodeValidationWarning } from "../providers/opencode.js";
-export { isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, sendKeysAndSubmit, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killWindow, sessionExists, attachSession, switchClient, getCurrentSession, attachOrSwitch, selectWindow, waitForOutput, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, paneLooksReady, paneHasActiveTask, paneIsIdle, waitForPaneReady, attemptSubmitRounds, } from "../runtime/tmux.js";
-export { AGENTS, discoverWorkflows, findWorkflow, WORKFLOWS_GITIGNORE, } from "../runtime/discovery.js";
-export type { DiscoveredWorkflow } from "../runtime/discovery.js";
+export { SOCKET_NAME, isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, sendKeysAndSubmit, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killWindow, sessionExists, attachSession, spawnMuxAttach, switchClient, getCurrentSession, attachOrSwitch, selectWindow, waitForOutput, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, paneLooksReady, paneHasActiveTask, paneIsIdle, waitForPaneReady, attemptSubmitRounds, } from "../runtime/tmux.js";
+export { AGENTS, discoverWorkflows, findWorkflow, loadWorkflowsMetadata, WORKFLOWS_GITIGNORE, } from "../runtime/discovery.js";
+export type { DiscoveredWorkflow, WorkflowWithMetadata, } from "../runtime/discovery.js";
 export { WorkflowLoader } from "../runtime/loader.js";
 export { executeWorkflow } from "../runtime/executor.js";
 export type { WorkflowRunOptions } from "../runtime/executor.js";

package/dist/sdk/workflows/index.js

@@ -2,6 +2,7 @@
 import"../../chunk-1gb5qxz9.js";
 import {
   AGENTS,
+  SOCKET_NAME,
   WORKFLOWS_GITIGNORE,
   WorkflowBuilder,
   WorkflowLoader,
@@ -27,6 +28,7 @@ import {
   isTmuxInstalled,
   killSession,
   killWindow,
+  loadWorkflowsMetadata,
   normalizeTmuxCapture,
   normalizeTmuxLines,
   paneHasActiveTask,
@@ -38,6 +40,7 @@ import {
   sendLiteralText,
   sendSpecialKey,
   sessionExists,
+  spawnMuxAttach,
   switchClient,
   tmuxRun,
   validateClaudeWorkflow,
@@ -45,7 +48,7 @@ import {
   validateOpenCodeWorkflow,
   waitForOutput,
   waitForPaneReady
-} from "../../chunk-mn870nrv.js";
+} from "../../chunk-xkxndz5g.js";
 export {
   waitForPaneReady,
   waitForOutput,
@@ -54,6 +57,7 @@ export {
   validateClaudeWorkflow,
   tmuxRun,
   switchClient,
+  spawnMuxAttach,
   sessionExists,
   sendSpecialKey,
   sendLiteralText,
@@ -65,6 +69,7 @@ export {
   paneHasActiveTask,
   normalizeTmuxLines,
   normalizeTmuxCapture,
+  loadWorkflowsMetadata,
   killWindow,
   killSession,
   isTmuxInstalled,
@@ -90,5 +95,6 @@ export {
   WorkflowLoader,
   WorkflowBuilder,
   WORKFLOWS_GITIGNORE,
+  SOCKET_NAME,
   AGENTS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.3-1",
+  "version": "0.5.4-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",

package/src/cli.ts

@@ -127,20 +127,42 @@ Examples:
         });
 
     // Add workflow command
+    //
+    // Two shapes are supported behind a single command:
+    //   1. `atomic workflow -a <agent>`                 — interactive picker
+    //   2. `atomic workflow -n <name> -a <agent> ...`   — named run with
+    //       either a positional prompt (free-form workflows) or
+    //       `--<field>=<value>` flags (structured-input workflows).
+    //
+    // `allowUnknownOption` + `allowExcessArguments` give us both: unknown
+    // flags and positional tokens land in `cmd.args`, which we forward
+    // as `passthroughArgs` so the command layer can parse them against
+    // the workflow's declared schema.
     program
         .command("workflow")
         .description("Run a multi-session agent workflow")
         .option("-n, --name <name>", "Workflow name (matches directory under .atomic/workflows/<name>/)")
         .option("-a, --agent <name>", `Agent to use (${agentChoices})`)
         .option("-l, --list", "List available workflows")
-        .argument("[prompt...]", "Prompt for the workflow")
-        .action(async (promptParts, localOpts) => {
+        .allowUnknownOption()
+        .allowExcessArguments(true)
+        .addHelpText(
+            "after",
+            `
+Examples:
+  $ atomic workflow -l                              List available workflows
+  $ atomic workflow -a claude                       Open the interactive picker
+  $ atomic workflow -n ralph -a claude "fix bug"    Run a free-form workflow
+  $ atomic workflow -n gen-spec -a claude --research_doc=notes.md --focus=standard
+                                                    Run a structured-input workflow`,
+        )
+        .action(async (localOpts, cmd) => {
             const { workflowCommand } = await import("@/commands/cli/workflow.ts");
             const exitCode = await workflowCommand({
                 name: localOpts.name,
                 agent: localOpts.agent,
-                prompt: promptParts.length > 0 ? promptParts.join(" ") : undefined,
                 list: localOpts.list,
+                passthroughArgs: cmd.args,
             });
             process.exit(exitCode);
         });

package/src/commands/cli/chat/index.ts

@@ -31,7 +31,8 @@ import {
 import {
   createSession,
   killSession,
-  getMuxBinary,
+  spawnMuxAttach,
+  SOCKET_NAME,
 } from "@/sdk/workflows/index.ts";
 import { ensureTmuxInstalled } from "@/lib/spawn.ts";
 
@@ -222,10 +223,9 @@ export async function chatCommand(options: ChatCommandOptions = {}): Promise<num
   try {
     createSession(windowName, shellCmd, undefined, projectRoot);
 
-    const muxBinary = getMuxBinary() ?? "tmux";
-    const attachProc = Bun.spawn([muxBinary, "attach-session", "-t", windowName], {
-      stdio: ["inherit", "inherit", "inherit"],
-    });
+    console.log(`[atomic] Session: ${windowName} (FYI all atomic sessions run on tmux -L ${SOCKET_NAME})`);
+
+    const attachProc = spawnMuxAttach(windowName);
     const exitCode = await attachProc.exited;
 
     // Clean up launcher

package/src/commands/cli/init/index.ts

@@ -1,5 +1,8 @@
 /**
  * Init command - Interactive setup flow for atomic CLI
+ *
+ * Uses Catppuccin Mocha palette for visual hierarchy and brand alignment.
+ * All color output respects the NO_COLOR environment variable.
  */
 
 import {
@@ -45,6 +48,7 @@ import {
   hasProjectOnboardingFiles,
 } from "./onboarding.ts";
 import { displayBlockBanner } from "@/theme/logo.ts";
+import { createPainter } from "@/theme/colors.ts";
 
 /**
  * Thrown when the user cancels an interactive prompt during init.
@@ -91,6 +95,7 @@ export {
  */
 export async function initCommand(options: InitOptions = {}): Promise<void> {
   const { showBanner = true, configNotFoundMessage, callerHandlesExit = false } = options;
+  const paint = createPainter();
 
   /** Exit-or-throw helper: when a caller (e.g. chatCommand auto-init) sets
    *  `callerHandlesExit`, we throw so the caller can handle the cancellation.
@@ -107,30 +112,23 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
     displayBlockBanner();
   }
 
-  // Show intro
-  intro("Atomic: Automated Procedures and Memory for AI Coding Agents");
-  log.message(
-    "Enable multi-hour autonomous coding sessions with the Ralph Wiggum\nMethod using research, plan, implement methodology."
-  );
+  intro(paint("accent", "Configure agent skills & source control", { bold: true }));
 
-  // Show config not found message if provided (after intro, before agent selection)
   if (configNotFoundMessage) {
     log.info(configNotFoundMessage);
   }
 
-  // Select agent
+  // ── Agent selection ────────────────────────────────────────────────
   let agentKey: AgentKey;
 
   if (options.preSelectedAgent) {
-    // Pre-selected agent - validate and skip selection prompt
     if (!isValidAgent(options.preSelectedAgent)) {
       cancel(`Unknown agent: ${options.preSelectedAgent}`);
       exitOrThrow(1, `Unknown agent: ${options.preSelectedAgent}`);
     }
     agentKey = options.preSelectedAgent;
-    log.info(`Configuring ${AGENT_CONFIG[agentKey].name}...`);
+    log.info(`${paint("accent", "→")} Agent: ${paint("text", AGENT_CONFIG[agentKey].name, { bold: true })}`);
   } else {
-    // Interactive selection
     const agentKeys = getAgentKeys();
     const agentOptions = agentKeys.map((key) => ({
       value: key,
@@ -139,12 +137,12 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
     }));
 
     const selectedAgent = await select({
-      message: "Select a coding agent to configure:",
+      message: "Which coding agent?",
       options: agentOptions,
     });
 
     if (isCancel(selectedAgent)) {
-      cancel("Operation cancelled.");
+      cancel("Cancelled.");
       exitOrThrow(0);
     }
 
@@ -152,104 +150,87 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
   }
   const agent = AGENT_CONFIG[agentKey];
   const targetDir = process.cwd();
-
-  // Auto-confirm mode for CI/testing
   const autoConfirm = options.yes ?? false;
 
-  // Select source control type (after agent selection)
+  // ── SCM selection ──────────────────────────────────────────────────
   let scmType: SourceControlType;
 
   if (options.preSelectedScm) {
-    // Pre-selected SCM - validate and skip selection prompt
     if (!isValidScm(options.preSelectedScm)) {
       cancel(`Unknown source control: ${options.preSelectedScm}`);
       exitOrThrow(1, `Unknown source control: ${options.preSelectedScm}`);
     }
     scmType = options.preSelectedScm;
-    log.info(`Using ${SCM_CONFIG[scmType].displayName} for source control...`);
+    log.info(`${paint("accent", "→")} SCM: ${paint("text", SCM_CONFIG[scmType].displayName, { bold: true })}`);
   } else if (autoConfirm) {
-    // Auto-confirm mode defaults to GitHub
     scmType = "github";
-    log.info("Defaulting to GitHub/Git for source control...");
+    log.info(`${paint("accent", "→")} SCM: ${paint("text", "GitHub / Git", { bold: true })} ${paint("dim", "(default)")}`);
   } else {
-    // Interactive selection
     const scmOptions = getScmKeys().map((key) => ({
       value: key,
       label: SCM_CONFIG[key].displayName,
-      hint: `Uses ${SCM_CONFIG[key].cliTool} + ${SCM_CONFIG[key].reviewSystem}`,
+      hint: `${SCM_CONFIG[key].cliTool} + ${SCM_CONFIG[key].reviewSystem}`,
     }));
 
     const selectedScm = await select({
-      message: "Select your source control system:",
+      message: "Which source control?",
       options: scmOptions,
     });
 
     if (isCancel(selectedScm)) {
-      cancel("Operation cancelled.");
+      cancel("Cancelled.");
       exitOrThrow(0);
     }
 
     scmType = selectedScm as SourceControlType;
   }
 
-  // Show Phabricator configuration warning if Sapling is selected
+  // Sapling-specific warning
   if (scmType === "sapling") {
     const arcconfigPath = join(targetDir, ".arcconfig");
     const hasArcconfig = await pathExists(arcconfigPath);
 
     if (!hasArcconfig) {
       log.warn(
-        "Note: Sapling + Phabricator requires .arcconfig in your repository root.\n" +
-          "See: https://www.phacility.com/phabricator/ for Phabricator setup."
+        `Sapling + Phabricator requires ${paint("text", ".arcconfig", { bold: true })} in your repo root.\n` +
+        `${paint("dim", "See: https://www.phacility.com/phabricator/")}`
       );
     }
   }
 
-  // Confirm directory
-  let confirmDir: boolean | symbol = true;
-  if (!autoConfirm) {
-    confirmDir = await confirm({
-      message: `Configure ${agent.name} source control skills in ${targetDir}?`,
-      initialValue: true,
-    });
-
-    if (isCancel(confirmDir)) {
-      cancel("Operation cancelled.");
-      exitOrThrow(0);
-    }
-
-    if (!confirmDir) {
-      cancel("Operation cancelled.");
-      exitOrThrow(0);
-    }
-  }
-
-  // Check if folder already exists
+  // ── Preflight summary ──────────────────────────────────────────────
   const targetFolder = join(targetDir, agent.folder);
   const folderExists = await pathExists(targetFolder);
+  const configAction = folderExists ? "update" : "create";
 
-  if (folderExists && !autoConfirm) {
-    const update = await confirm({
-      message: `${agent.folder} already exists. Update source control skills?`,
+  if (!autoConfirm) {
+    const summaryLines = [
+      `${paint("dim", "Agent")}   ${paint("text", agent.name, { bold: true })}`,
+      `${paint("dim", "SCM")}     ${paint("text", SCM_CONFIG[scmType].displayName, { bold: true })}`,
+      `${paint("dim", "Target")}  ${paint("text", targetDir)}`,
+      `${paint("dim", "Action")}  ${paint(folderExists ? "warning" : "success", configAction)}`,
+    ];
+    note(summaryLines.join("\n"), paint("accent", "Setup", { bold: true }));
+
+    const shouldProceed = await confirm({
+      message: folderExists
+        ? `${agent.folder} exists — update source control skills?`
+        : "Proceed with setup?",
       initialValue: true,
-      active: "Yes, update",
-      inactive: "No, cancel",
     });
 
-    if (isCancel(update)) {
-      cancel("Operation cancelled.");
-      exitOrThrow(0);
-    }
-
-    if (!update) {
-      cancel("Operation cancelled. Existing config preserved.");
+    if (isCancel(shouldProceed) || !shouldProceed) {
+      cancel("Cancelled.");
       exitOrThrow(0);
     }
   }
 
-  // Configure source control skills with spinner
+  // ── Configure ──────────────────────────────────────────────────────
   const s = spinner();
-  s.start("Configuring source control skills...");
+  s.start("Configuring skills…");
+
+  let skillsInstalled = false;
+  let skillsSkipReason = "";
 
   try {
     const configRoot = getConfigRoot();
@@ -289,7 +270,7 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
     });
     upsertTrustedWorkspacePath(resolve(targetDir), agentKey);
 
-    s.stop("Source control skills configured successfully!");
+    s.stop(paint("success", "✓", { bold: true }) + " Skills configured");
 
     // Install SCM-specific skill variants locally for the active agent via
     // `npx skills add` (best-effort: a failure is surfaced as a warning).
@@ -303,7 +284,7 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
       const skillsLabel = skillsToInstall.join(", ");
       const skillsSpinner = spinner();
       skillsSpinner.start(
-        `Installing ${skillsLabel} locally for ${agent.name}...`,
+        `Installing ${paint("text", skillsLabel, { bold: true })}…`,
       );
       const skillsResult = await installLocalScmSkills({
         scmType,
@@ -311,39 +292,60 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
         cwd: targetDir,
       });
       if (skillsResult.success) {
+        skillsInstalled = true;
         skillsSpinner.stop(
-          `Installed ${skillsLabel} locally for ${agent.name}`,
+          paint("success", "✓", { bold: true }) + ` ${skillsLabel} installed`,
         );
       } else {
+        skillsSkipReason = skillsResult.details;
         skillsSpinner.stop(
-          `Skipped local ${skillsLabel} install (${skillsResult.details})`,
+          paint("warning", "○") + ` ${skillsLabel} skipped ${paint("dim", `(${skillsResult.details})`)}`,
         );
       }
     }
   } catch (error) {
-    s.stop("Failed to configure source control skills");
+    s.stop(paint("error", "✗", { bold: true }) + " Configuration failed");
     console.error(
       error instanceof Error ? error.message : "Unknown error occurred"
     );
     exitOrThrow(1, error instanceof Error ? error.message : "Unknown error occurred");
   }
 
-  // Check for WSL on Windows
+  // ── WSL warning ────────────────────────────────────────────────────
   if (isWindows() && !isWslInstalled()) {
-    note(
-      `WSL is not installed. Some scripts may require WSL.\n` +
-        `Install WSL: ${WSL_INSTALL_URL}`,
-      "Warning"
+    log.warn(
+      `WSL not detected. Some scripts may require it.\n` +
+      `${paint("dim", WSL_INSTALL_URL)}`
     );
   }
 
-  // Success message
-  note(
-    `${agent.name} source control skills configured in ${agent.folder}/skills\n\n` +
-      `Selected workflow: ${SCM_CONFIG[scmType].displayName}\n\n` +
-      `Run '${agent.cmd}' to start the agent.`,
-    "Success"
+  // ── Summary ────────────────────────────────────────────────────────
+  const resultLines: string[] = [];
+  resultLines.push(
+    `${paint("success", "✓")} ${agent.name} skills ${paint("dim", "→")} ${paint("text", agent.folder + "/skills")}`,
+  );
+  resultLines.push(
+    `${paint("success", "✓")} SCM workflow ${paint("dim", "→")} ${paint("text", SCM_CONFIG[scmType].displayName)}`,
+  );
+
+  if (import.meta.dir.includes("node_modules")) {
+    if (skillsInstalled) {
+      resultLines.push(
+        `${paint("success", "✓")} Local skills installed`,
+      );
+    } else {
+      resultLines.push(
+        `${paint("warning", "○")} Local skills skipped ${paint("dim", skillsSkipReason ? `(${skillsSkipReason})` : "")}`,
+      );
+    }
+  }
+
+  resultLines.push("");
+  resultLines.push(
+    `${paint("accent", "→")} Run ${paint("text", agent.cmd, { bold: true })} to start the agent`,
   );
 
-  outro("You're all set!");
+  note(resultLines.join("\n"), paint("success", "Ready", { bold: true }));
+
+  outro(paint("dim", "Happy coding ⚛"));
 }