@bastani/atomic 0.5.6 → 0.5.7-0

package/README.md

@@ -9,33 +9,59 @@
 [![Bun](https://img.shields.io/badge/Bun-Runtime-f9f1e1?logo=bun&logoColor=black)](./package.json)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-Atomic is an open-source **agent harness framework** that lets you build, compose, and run **multi-session coding workflows** on top of **Claude Code**, **OpenCode**, and **GitHub Copilot CLI** — with **58 built-in skills**, **12 specialized sub-agents**, and **containerized execution**.
+Atomic is an open-source **TypeScript SDK** for building **any harness you want** around your coding agent — **Claude Code**, **OpenCode**, or **GitHub Copilot CLI**. Chain sessions into pipelines, add human-in-the-loop approval gates, plug in CI and notifications, dispatch **12 specialized sub-agents**, and tap **58 built-in skills** — then ship it as TypeScript your whole team runs.
 
-> Build any agent harness you want. Define workflows as TypeScript. Run them on any coding agent.
+> Define how your agent works. Start for yourself, scale to your team.
 
 ---
 
 ## Why Atomic
 
-Building harnesses and workflows around coding agents is harder than it should be. Teams hit the same walls:
+Coding agents keep getting more capable — better reasoning, larger context windows, more reliable tool use. But a more capable model doesn't reduce the need for structure around it. It **increases** it.
 
-- **No way to chain agent sessions.** You can prompt an agent, but there's no standard way to feed one session's output into the next — research into planning, planning into implementation, implementation into review. Teams resort to copy-pasting between terminals.
-- **Context degrades in long sessions.** A single agent asked to research, plan, implement, and review in one session produces increasingly unreliable output as its context window fills up. There's no built-in mechanism to isolate concerns across sessions.
-- **Agent-specific configuration is fragmented.** Claude Code, OpenCode, and Copilot CLI each have their own config directories, skill formats, and agent definitions. Building a workflow that works across agents means maintaining three separate configurations.
-- **Team processes live in wikis, not in code.** Every team has a process — triage bugs this way, ship features that way, review PRs with these checks. But those processes are prose in a wiki, not executable code that an agent can follow.
-- **Autonomous execution is unsafe without isolation.** Agents run shell commands, delete files, and execute arbitrary code. Running them autonomously on your host system is a risk most teams won't take.
-- **Specialized work requires specialized agents.** A single general-purpose agent juggling file search, code analysis, web research, and implementation will lose track of details. There's no framework for dispatching purpose-built sub-agents with scoped tools and isolated context windows.
-- **Agent workflows aren't deterministic.** Even when you do chain sessions together, there's no guarantee they'll execute in the same order, pass data the same way, or produce an inspectable record. Without strict ordering and controlled data flow, workflows become unpredictable — hard to debug, impossible to reproduce.
+The bottleneck is shifting from "can my agent write this code?" to "can my agent follow my process?" Every team has a process — how code gets reviewed, what checks run before merging, who approves deployments, how production gets monitored. That process lives in wikis nobody reads, in one senior engineer's head, or nowhere at all. A powerful agent without a defined process is just a faster way to ship unreviewed code.
 
-Atomic solves these by giving you a **Workflow SDK** to define multi-session pipelines as TypeScript with **deterministic execution** — strict step ordering, frozen definitions, and controlled transcript passing — plus **12 specialized sub-agents** that keep context windows small and focused, and **containerized execution** via devcontainer features that isolate agents from your host system. Write a workflow once, run it on Claude Code, OpenCode, or Copilot CLI with a flag change.
+**Harnesses are what turn a capable agent into a reliable part of your engineering workflow.** A harness encodes your process — research, then implement, then review, then run CI, then create a PR, then notify the right person, then wait for approval, then merge. Without one, you're prompting manually and copy-pasting between terminal sessions. With one, you run a single command and the process executes itself.
+
+Better models make harnesses **more** important, not less. The more you can trust an agent to execute complex tasks, the more value you get from defining exactly **what** it should execute, in **what order**, with **what checks** along the way. The harness is the durable layer — models will keep improving underneath it, but your process stays the same.
+
+Atomic gives you the SDK to build that harness:
+
+- **Start for yourself.** Automate the repetitive parts of your own workflow — research a codebase, add monitoring, generate specs. One developer, one afternoon, one TypeScript file.
+- **Scale to your team.** Encode your team's review process, deployment gates, and quality checks as TypeScript that every team member runs identically. Your process becomes versioned, testable, and reproducible — not tribal knowledge.
+- **Work across agents.** Write a harness once, run it on Claude Code, OpenCode, or Copilot CLI with a flag change. The harness is the constant; the agent is swappable.
+
+### What You Can Build
+
+**Add production monitoring to your codebase.** Build a harness that researches your current observability setup, identifies gaps in metrics, health checks, and alerting, implements the missing pieces, and reviews the changes — all in one run.
+
+```bash
+atomic workflow -n add-monitoring -a claude "add Prometheus metrics and health checks to all API endpoints"
+```
+
+**Automate your team's review-to-merge pipeline.** Encode your exact process: review code changes → run security scans and linting in parallel → create a PR → notify the team lead on Slack → wait for human approval → merge. The [human-in-the-loop gate](#workflow-sdk--build-your-own-deterministic-harness) pauses execution until the right person approves. New team members inherit the same pipeline on day one.
+
+```bash
+atomic workflow -n review-to-merge -a claude
+```
+
+**Run parallel UX testing with 50 personas.** Spin up 50 agents — each with a distinct user persona (first-time user, power user, accessibility-dependent user, non-technical stakeholder) — each using [Playwright](#built-in-skills) to navigate your app and report usability issues from their perspective. Batch in groups, aggregate findings, and get feedback at a scale no manual process can match.
+
+```bash
+atomic workflow -n ux-personas -a claude
+```
+
+Each of these is a `.ts` file using Atomic's [Workflow SDK](#workflow-sdk--build-your-own-deterministic-harness). See [Build a Workflow](#5-build-a-workflow) for a working example, or read the full SDK reference below.
 
 ---
 
 ## Table of Contents
 
+- [Why Atomic](#why-atomic)
+  - [What You Can Build](#what-you-can-build)
 - [Quick Start](#quick-start)
 - [Core Features](#core-features)
-  - [Multi-Agent SDK Support](#multi-agent-sdk-support)
+  - [Multi-Agent Support](#multi-agent-support)
   - [Workflow SDK — Build Your Own Deterministic Harness](#workflow-sdk--build-your-own-deterministic-harness)
   - [Deep Codebase Research](#deep-codebase-research)
   - [Autonomous Execution (Ralph)](#autonomous-execution-ralph)
@@ -185,54 +211,78 @@ Create a workflow project, install the SDK, and add your workflow file:
 
 ```bash
 bun init && bun add @bastani/atomic
-mkdir -p .atomic/workflows/my-workflow/claude
+mkdir -p .atomic/workflows/review-to-merge/claude
 ```
 
+Here's one of the [canonical use cases](#what-you-can-build) — a team pipeline that reviews code, runs checks in parallel, creates a PR, notifies on Slack, waits for human approval, and merges:
+
 ```ts
-// .atomic/workflows/my-workflow/claude/index.ts
+// .atomic/workflows/review-to-merge/claude/index.ts
 import { defineWorkflow } from "@bastani/atomic/workflows";
 
 export default defineWorkflow<"claude">({
-  name: "my-workflow",
-  description: "Research -> Implement -> Review",
+  name: "review-to-merge",
+  description: "Review → CI → PR → Notify → Approve → Merge",
 })
   .run(async (ctx) => {
-    // Free-form workflows receive their positional prompt under
-    // `ctx.inputs.prompt`. Destructure it once so every stage below
-    // can close over a bare string.
-    const prompt = ctx.inputs.prompt ?? "";
-
-    const research = await ctx.stage(
-      { name: "research", description: "Analyze the codebase" },
-      {}, {},
-      async (s) => {
-        await s.session.query(`/research-codebase ${prompt}`);
-        s.save(s.sessionId);
-      },
-    );
-
-    await ctx.stage(
-      { name: "implement", description: "Implement based on research" },
+    // Step 1: Review the changes
+    const review = await ctx.stage(
+      { name: "review", description: "Review code changes" },
       {}, {},
       async (s) => {
-        const transcript = await s.transcript(research);
         await s.session.query(
-          `Read ${transcript.path} and implement the changes. Run tests to verify.`,
+          "Review all uncommitted changes. Flag issues with correctness, security, and style.",
         );
         s.save(s.sessionId);
       },
     );
 
-    await ctx.stage(
-      { name: "review", description: "Review the implementation" },
-      {}, {},
-      async (s) => {
-        await s.session.query(
-          "Review all uncommitted changes. Flag any issues with correctness, tests, or style.",
-        );
+    // Step 2: Run security and CI checks in parallel
+    await Promise.all([
+      ctx.stage({ name: "security-scan" }, {}, {}, async (s) => {
+        await s.session.query("Run `bun audit` and scan for leaked secrets or credentials.");
         s.save(s.sessionId);
-      },
-    );
+      }),
+      ctx.stage({ name: "ci-checks" }, {}, {}, async (s) => {
+        await s.session.query("Run `bun lint` and `bun test`. Report any failures.");
+        s.save(s.sessionId);
+      }),
+    ]);
+
+    // Step 3: Create a PR with the review summary
+    await ctx.stage({ name: "create-pr" }, {}, {}, async (s) => {
+      const transcript = await s.transcript(review);
+      await s.session.query(
+        `Read the review at ${transcript.path}. Create a pull request summarizing the changes.`,
+      );
+      s.save(s.sessionId);
+    });
+
+    // Step 4: Notify on Slack, then wait for human approval before merging.
+    // Stage callbacks are plain Bun code — fetch(), Bun.spawn(), and any
+    // Node API work here alongside agent session queries.
+    await ctx.stage({ name: "notify-and-merge" }, {}, {}, async (s) => {
+      await fetch("https://slack.com/api/chat.postMessage", {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${process.env.SLACK_TOKEN}`,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          channel: "#code-review",
+          text: "New PR ready for review — please approve in GitHub.",
+        }),
+      });
+
+      // Human-in-the-loop: AskUserQuestion pauses the session until the
+      // user responds. The agent won't merge until approval is given.
+      await s.session.query(
+        "The team has been notified on Slack. Ask the user to confirm the PR " +
+        "is approved, then merge it with `gh pr merge --squash`.",
+        { allowedTools: ["Bash", "Read", "AskUserQuestion"] },
+      );
+      s.save(s.sessionId);
+    });
   })
   .compile();
 ```
@@ -240,10 +290,10 @@ export default defineWorkflow<"claude">({
 Run it:
 
 ```bash
-atomic workflow -n my-workflow -a claude "add user avatars to the profile page"
+atomic workflow -n review-to-merge -a claude
 ```
 
-Add a spec phase, parallelize independent sessions, swap in a different agent — the workflow is yours to define. See [Workflow SDK — Build Your Own Harness](#workflow-sdk--build-your-own-harness) for the full API and more examples.
+This single file demonstrates multi-step pipelines, parallel stages (`Promise.all`), transcript passing between sessions, external API calls (`fetch`), and human-in-the-loop approval — all in plain TypeScript. Swap `-a claude` for `-a opencode` or `-a copilot` to run the same harness on a different agent. See [Workflow SDK — Build Your Own Harness](#workflow-sdk--build-your-own-deterministic-harness) for the full API and more examples.
 
 > **Want something that works out of the box?** Atomic ships with `ralph`, a built-in workflow that plans, implements, reviews, and debugs autonomously — see [Autonomous Execution (Ralph)](#autonomous-execution-ralph).
 
@@ -251,15 +301,15 @@ Add a spec phase, parallelize independent sessions, swap in a different agent
 
 ## Core Features
 
-### Multi-Agent SDK Support
+### Multi-Agent Support
 
-Atomic is the only harness that unifies **three production agent SDKs** behind a single interface. Switch between agents with a flag — your workflows, skills, and sub-agents work across all of them.
+Atomic works across **three production coding agents** — switch between them with a flag and your workflows, skills, and sub-agents carry over.
 
-| Agent              | SDK                              | Command                   |
-| ------------------ | -------------------------------- | ------------------------- |
-| Claude Code        | `@anthropic-ai/claude-agent-sdk` | `atomic chat -a claude`   |
-| OpenCode           | `@opencode-ai/sdk`               | `atomic chat -a opencode` |
-| GitHub Copilot CLI | `@github/copilot-sdk`            | `atomic chat -a copilot`  |
+| Agent              | Command                   |
+| ------------------ | ------------------------- |
+| Claude Code        | `atomic chat -a claude`   |
+| OpenCode           | `atomic chat -a opencode` |
+| GitHub Copilot CLI | `atomic chat -a copilot`  |
 
 Each agent gets its own configuration directory (`.claude/`, `.opencode/`, `.github/`), skills, and context files — all managed by Atomic. Write a workflow once, run it on any agent.
 
@@ -815,6 +865,7 @@ During `atomic chat`, there is no Atomic-owned TUI — `atomic chat -a <agent>`
 | `atomic init`                    | Interactive project setup (agent selection, SCM choice, config sync)  |
 | `atomic chat`                    | Spawn the native agent CLI inside a tmux/psmux session                |
 | `atomic workflow`                | Run a multi-session agent workflow with the Atomic orchestrator panel |
+| `atomic workflow list`           | List available workflows, grouped by source                           |
 | `atomic session list`            | List all running sessions on the atomic tmux socket                   |
 | `atomic session connect [name]`  | Attach to a session (interactive picker when no name given)           |
 | `atomic completions <shell>`     | Output shell completion script (bash, zsh, fish, powershell)         |
@@ -886,7 +937,6 @@ atomic chat -a claude --verbose              # Forward --verbose to claude
 | -------------------------- | ------------------------------------------------------------------- |
 | `-n, --name <name>`        | Workflow name (matches directory under `.atomic/workflows/<name>/`) |
 | `-a, --agent <name>`       | Agent: `claude`, `opencode`, `copilot`                              |
-| `-l, --list`               | List available workflows, grouped by source                         |
 | `--<field>=<value>`        | Structured input for workflows that declare an `inputs` schema (also accepts `--<field> <value>`) |
 | `[prompt...]`               | Positional prompt for free-form workflows (rejected on workflows with a declared schema) |
 
@@ -894,7 +944,8 @@ The workflow command supports four invocation shapes:
 
 ```bash
 # 1. List every workflow available to you, grouped by source
-atomic workflow -l
+atomic workflow list
+atomic workflow list -a claude       # filter by agent
 
 # 2. Launch the interactive picker for an agent (no -n) — fuzzy-search
 #    the list, fill the form rendered from the workflow's declared inputs,

package/dist/sdk/components/orchestrator-panel-store.d.ts

@@ -34,16 +34,6 @@ export declare class PanelStore {
      * Switching to "graph" clears the active agent.
      */
     setViewMode(mode: ViewMode, agentId?: string): void;
-    /**
-     * Return non-orchestrator agents that have started (not pending).
-     * Used for the tmux status bar agent count and active-agent index.
-     */
-    getSubagents(): SessionData[];
-    /**
-     * Return the 0-based index of the active agent within the subagent list,
-     * or -1 if not found.
-     */
-    getActiveAgentIndex(): number;
     /** Safely invoke exitResolve at most once, guarding against rapid repeated calls. */
     resolveExit(): void;
     /** Safely invoke abortResolve at most once to signal mid-execution quit. */

package/dist/sdk/components/orchestrator-panel-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-panel-store.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/orchestrator-panel-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAiB,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAExG,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,qBAAa,UAAU;IACrB,OAAO,SAAK;IACZ,YAAY,SAAM;IAClB,KAAK,SAAM;IACX,MAAM,SAAM;IACZ,QAAQ,EAAE,WAAW,EAAE,CAAM;IAC7B,cAAc,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IAChF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,iBAAiB,UAAS;IAC1B,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IACxC,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEzC,0EAA0E;IAC1E,QAAQ,EAAE,QAAQ,CAAW;IAC7B,4FAA4F;IAC5F,aAAa,SAAM;IAEnB,OAAO,CAAC,SAAS,CAAuB;IAExC,SAAS,GAAI,IAAI,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAGtC;IAEF,OAAO,CAAC,IAAI;IAKZ,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,IAAI;IAuBP,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS9C,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKtC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAUlE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWpC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnD;;;OAGG;IACH,YAAY,IAAI,WAAW,EAAE;IAM7B;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAK7B,qFAAqF;IACrF,WAAW,IAAI,IAAI;IAQnB,4EAA4E;IAC5E,YAAY,IAAI,IAAI;IAQpB,gFAAgF;IAChF,WAAW,IAAI,IAAI;IAQnB,qBAAqB,IAAI,IAAI;CAI9B"}
+{"version":3,"file":"orchestrator-panel-store.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/orchestrator-panel-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAiB,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAExG,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,qBAAa,UAAU;IACrB,OAAO,SAAK;IACZ,YAAY,SAAM;IAClB,KAAK,SAAM;IACX,MAAM,SAAM;IACZ,QAAQ,EAAE,WAAW,EAAE,CAAM;IAC7B,cAAc,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IAChF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,iBAAiB,UAAS;IAC1B,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IACxC,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEzC,0EAA0E;IAC1E,QAAQ,EAAE,QAAQ,CAAW;IAC7B,4FAA4F;IAC5F,aAAa,SAAM;IAEnB,OAAO,CAAC,SAAS,CAAuB;IAExC,SAAS,GAAI,IAAI,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAGtC;IAEF,OAAO,CAAC,IAAI;IAKZ,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,IAAI;IAuBP,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS9C,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKtC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAUlE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWpC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnD,qFAAqF;IACrF,WAAW,IAAI,IAAI;IAQnB,4EAA4E;IAC5E,YAAY,IAAI,IAAI;IAQpB,gFAAgF;IAChF,WAAW,IAAI,IAAI;IAQnB,qBAAqB,IAAI,IAAI;CAI9B"}

package/dist/sdk/components/session-graph-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-graph-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/session-graph-panel.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;GAGG;AAgDH,wBAAgB,iBAAiB,8BA0ahC"}
+{"version":3,"file":"session-graph-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/session-graph-panel.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;GAGG;AAoDH,wBAAgB,iBAAiB,8BAgchC"}

package/dist/sdk/runtime/tmux.d.ts

@@ -20,12 +20,11 @@ export declare const TMUX_DEFAULT_STATUS_LEFT = " ";
 export declare const TMUX_DEFAULT_STATUS_LEFT_LENGTH = "10";
 export declare const TMUX_DEFAULT_STATUS_RIGHT = " #{session_name} | %H:%M ";
 export declare const TMUX_DEFAULT_STATUS_RIGHT_LENGTH = "60";
-/**
- * Escape a string for safe interpolation into tmux format strings.
- * Replaces `#` with `##` to prevent tmux from interpreting `#[...]`
- * as style directives or `#(...)` as shell command expansions.
- */
-export declare function escapeTmuxFormat(value: string): string;
+export declare const TMUX_ATTACHED_STATUS_RIGHT = "#[fg=#cdd6f4]ctrl+g #[fg=#6c7086]graph #[fg=#585b70]\u00B7 #[fg=#cdd6f4]ctrl+\\ #[fg=#6c7086]next ";
+export declare const TMUX_ATTACHED_STATUS_RIGHT_LENGTH = "40";
+export declare const TMUX_ATTACHED_WINDOW_FMT = "#{?#{==:#{window_index},0},, #W }";
+export declare const TMUX_ATTACHED_WINDOW_STYLE = "fg=#6c7086";
+export declare const TMUX_ATTACHED_WINDOW_CURRENT_STYLE = "fg=#cdd6f4,bold";
 /**
  * Resolve the terminal multiplexer binary for the current platform.
  *

package/dist/sdk/runtime/tmux.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/tmux.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/tmux.ts"],"names":[],"mappings":"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"}

package/package.json

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

package/src/cli.ts

@@ -327,7 +327,8 @@ async function main(): Promise<void> {
             argv.includes("--version") ||
             argv.includes("-v") ||
             argv.includes("--help") ||
-            argv.includes("-h");
+            argv.includes("-h") ||
+            argv[0] === "completions";
 
         if (!isInfoCommand) {
             const { autoSyncIfStale } = await import("./services/system/auto-sync.ts");

package/src/completions/zsh.ts

@@ -140,5 +140,5 @@ _atomic_session() {
     esac
 }
 
-_atomic "$@"
+compdef _atomic atomic
 `;

package/src/lib/spawn.ts

@@ -99,228 +99,19 @@ export interface EnsureOptions {
 }
 
 /**
- * Ensure npm is installed, attempting to install Node.js via available system
- * package managers when missing.
- *
- * No-op when npm is already on PATH.
- */
-
-
-async function installNodeViaFnm(quiet: boolean): Promise<boolean> {
-  const inherit = !quiet;
-  // Install fnm if not present.
-  if (!Bun.which("fnm")) {
-    let installed = false;
-    // macOS: prefer Homebrew
-    if (process.platform === "darwin" && Bun.which("brew")) {
-      const brew = await runCommand(
-        [Bun.which("brew")!, "install", "fnm"],
-        { inherit },
-      );
-      installed = brew.success;
-    }
-    // Windows: prefer winget
-    if (!installed && process.platform === "win32" && Bun.which("winget")) {
-      const winget = await runCommand(
-        [Bun.which("winget")!, "install", "Schniz.fnm"],
-        { inherit },
-      );
-      if (winget.success) {
-        // Refresh PATH — winget installs to a location on the user PATH.
-        const userPath = process.env.LOCALAPPDATA
-          ? join(process.env.LOCALAPPDATA, "Microsoft", "WinGet", "Links")
-          : null;
-        if (userPath) prependPath(userPath);
-      }
-      installed = winget.success;
-    }
-    // Linux / fallback: use the curl installer (requires a shell)
-    if (!installed) {
-      const shell = Bun.which("bash") ?? Bun.which("sh");
-      if (!shell) return false;
-
-      const curl = await runCommand(
-        [shell, "-lc", "curl -fsSL https://fnm.vercel.app/install | bash -s -- --skip-shell"],
-        { inherit },
-      );
-      if (!curl.success) return false;
-
-      // Add fnm to PATH for the current session.
-      const home = getHomeDir() ?? "/tmp";
-      const fnmDir = process.env.FNM_DIR ?? join(home, ".local", "share", "fnm");
-      prependPath(fnmDir);
-      // Some systems install to ~/.fnm instead
-      prependPath(join(home, ".fnm"));
-    }
-  }
-
-  const fnmPath = Bun.which("fnm");
-  if (!fnmPath) return false;
-
-  // Install LTS Node.js via fnm.
-  const fnmInstall = await runCommand(
-    [fnmPath, "install", "--lts"],
-    { inherit },
-  );
-  if (!fnmInstall.success) return false;
-
-  // Activate the installed version by adding its bin dir to PATH.
-  const envShell = process.platform === "win32" ? "cmd" : "bash";
-  const envProc = Bun.spawn({
-    cmd: [fnmPath, "env", "--shell", envShell],
-    stdout: "pipe",
-    stderr: "pipe",
-  });
-  const [envOutput, envExitCode] = await Promise.all([
-    new Response(envProc.stdout).text(),
-    envProc.exited,
-  ]);
-  if (envExitCode === 0) {
-    if (process.platform === "win32") {
-      // cmd output: SET "PATH=C:\...\fnm_multishells\...;..."
-      const pathMatch = envOutput.match(/SET "PATH=([^"]+?)"/i);
-      if (pathMatch?.[1]) {
-        const firstEntry = pathMatch[1].split(";")[0];
-        if (firstEntry) prependPath(firstEntry);
-      }
-    } else {
-      // bash output: export PATH="/.../fnm_multishells/...:..."
-      const pathMatch = envOutput.match(/export PATH="([^"]+?):/);
-      if (pathMatch?.[1]) {
-        prependPath(pathMatch[1]);
-      }
-    }
-  }
-
-  return !!Bun.which("node");
-}
-
-export async function ensureNpmInstalled(options: EnsureOptions = {}): Promise<void> {
-  const quiet = options.quiet ?? false;
-  const inherit = !quiet;
-
-  if (Bun.which("npm")) {
-    return;
-  }
-
-  // Buffer captured failure output so a thrown error can surface the tail
-  // through the spinner summary. Only populated when `quiet` is set.
-  let capturedDetails = "";
-  const record = (result: SpawnResult) => {
-    if (quiet && !result.success && result.details) {
-      capturedDetails = result.details;
-    }
-  };
-
-  // Preferred: install via fnm (no root required, works on all platforms).
-  if (await installNodeViaFnm(quiet)) {
-    return;
-  }
-
-  if (process.platform === "win32") {
-    // Fallback: direct Node.js installation via Windows package managers.
-    if (Bun.which("winget")) {
-      record(
-        await runCommand(
-          [
-            "winget",
-            "install",
-            "--id",
-            "OpenJS.NodeJS.LTS",
-            "-e",
-            "--silent",
-            "--accept-source-agreements",
-            "--accept-package-agreements",
-          ],
-          { inherit },
-        ),
-      );
-    } else if (Bun.which("choco")) {
-      record(
-        await runCommand(
-          ["choco", "install", "nodejs-lts", "-y", "--no-progress"],
-          { inherit },
-        ),
-      );
-    } else if (Bun.which("scoop")) {
-      record(
-        await runCommand(["scoop", "install", "nodejs-lts"], { inherit }),
-      );
-    }
-
-    const programFiles = process.env.ProgramFiles;
-    if (programFiles) {
-      prependPath(join(programFiles, "nodejs"));
-    }
-    if (Bun.which("npm")) return;
-    throw new Error(
-      capturedDetails || "Could not install Node.js on Windows (no supported package manager found).",
-    );
-  }
-
-  const shell = Bun.which("bash") ?? Bun.which("sh");
-  if (!shell) {
-    throw new Error("Neither bash nor sh is available to install Node.js.");
-  }
-
-  // Fallback: Homebrew, NodeSource, then system package managers.
-  const installers = [
-    'if command -v brew >/dev/null 2>&1; then brew install node && brew link --overwrite node 2>/dev/null; fi',
-    'if command -v apt-get >/dev/null 2>&1; then SUDO=""; [ "$(id -u)" -ne 0 ] && command -v sudo >/dev/null 2>&1 && SUDO="sudo"; $SUDO apt-get update && $SUDO apt-get install -y nodejs npm; fi',
-    'if command -v dnf >/dev/null 2>&1; then if command -v sudo >/dev/null 2>&1; then sudo dnf install -y nodejs npm; elif [ "$(id -u)" -eq 0 ]; then dnf install -y nodejs npm; fi; fi',
-    'if command -v yum >/dev/null 2>&1; then if command -v sudo >/dev/null 2>&1; then sudo yum install -y nodejs npm; elif [ "$(id -u)" -eq 0 ]; then yum install -y nodejs npm; fi; fi',
-    'if command -v pacman >/dev/null 2>&1; then if command -v sudo >/dev/null 2>&1; then sudo pacman -Sy --noconfirm nodejs npm; elif [ "$(id -u)" -eq 0 ]; then pacman -Sy --noconfirm nodejs npm; fi; fi',
-    'if command -v zypper >/dev/null 2>&1; then if command -v sudo >/dev/null 2>&1; then sudo zypper --non-interactive install nodejs npm; elif [ "$(id -u)" -eq 0 ]; then zypper --non-interactive install nodejs npm; fi; fi',
-    'if command -v apk >/dev/null 2>&1; then if command -v sudo >/dev/null 2>&1; then sudo apk add --no-cache nodejs npm; elif [ "$(id -u)" -eq 0 ]; then apk add --no-cache nodejs npm; fi; fi',
-  ];
-
-  for (const script of installers) {
-    if (Bun.which("npm")) {
-      return;
-    }
-    record(await runCommand([shell, "-lc", script], { inherit }));
-    if (Bun.which("npm")) {
-      return;
-    }
-  }
-
-  throw new Error(
-    capturedDetails || "Could not install Node.js — no supported package manager succeeded.",
-  );
-}
-
-/**
- * Upgrade npm to the latest version.
- * Falls back to installing Node.js/npm if it is not yet present.
- */
-export async function upgradeNpm(): Promise<void> {
-  const npmPath = Bun.which("npm");
-  if (!npmPath) {
-    await ensureNpmInstalled();
-    return;
-  }
-  const result = await runCommand([npmPath, "install", "-g", "npm@latest"]);
-  if (!result.success) {
-    const hint =
-      result.details?.includes("EACCES") || result.details?.includes("permission")
-        ? "\nIf this is a permissions issue, try: sudo npm install -g npm@latest"
-        : "";
-    throw new Error(`npm self-upgrade failed: ${result.details}${hint}`);
-  }
-}
-
-/**
- * Upgrade a global npm package to the latest version.
+ * Install a global package via bun. Uses `--trust` to allow postinstall
+ * lifecycle scripts (required by packages like @playwright/cli).
  */
 export async function upgradeGlobalPackage(pkg: string): Promise<void> {
   const versionedPkg = pkg.includes("@latest") ? pkg : `${pkg}@latest`;
-  const npmPath = Bun.which("npm");
-  if (npmPath) {
-    const result = await runCommand([npmPath, "install", "-g", versionedPkg]);
-    if (result.success) return;
-    throw new Error(`Failed to upgrade ${pkg}: npm: ${result.details}`);
+  const bunPath = Bun.which("bun");
+  if (!bunPath) {
+    throw new Error(`bun is not available to install ${pkg}.`);
+  }
+  const result = await runCommand([bunPath, "install", "-g", "--trust", versionedPkg]);
+  if (!result.success) {
+    throw new Error(`Failed to install ${pkg}: ${result.details}`);
   }
-  throw new Error(`npm is not available to upgrade ${pkg}.`);
 }
 
 /** Upgrade @playwright/cli to the latest version globally. */
@@ -455,11 +246,6 @@ export async function ensureBunInstalled(): Promise<void> {
       if (result.success && Bun.which("bun")) return;
     }
 
-    const npmPath = Bun.which("npm");
-    if (npmPath) {
-      const result = await runCommand([npmPath, "install", "-g", "bun"], { inherit: true });
-      if (result.success && Bun.which("bun")) return;
-    }
     return;
   }
 

package/src/sdk/components/orchestrator-panel-store.test.ts

@@ -756,86 +756,4 @@ describe("PanelStore", () => {
     });
   });
 
-  // ── getSubagents ───────────────────────────────────────────────────────────
-
-  describe("getSubagents", () => {
-    beforeEach(() => {
-      store.setWorkflowInfo("wf", "claude", [
-        { name: "planner", parents: [] },
-        { name: "writer", parents: ["planner"] },
-        { name: "reviewer", parents: ["writer"] },
-      ], "prompt");
-    });
-
-    test("returns empty when all non-orchestrator sessions are pending", () => {
-      expect(store.getSubagents()).toEqual([]);
-    });
-
-    test("excludes orchestrator from subagent list", () => {
-      store.startSession("planner");
-      const subs = store.getSubagents();
-      expect(subs.every((s) => s.name !== "orchestrator")).toBe(true);
-    });
-
-    test("includes running and completed sessions", () => {
-      store.startSession("planner");
-      store.completeSession("planner");
-      store.startSession("writer");
-      const subs = store.getSubagents();
-      expect(subs.map((s) => s.name)).toEqual(["planner", "writer"]);
-    });
-
-    test("includes errored sessions", () => {
-      store.startSession("planner");
-      store.failSession("planner", "timeout");
-      const subs = store.getSubagents();
-      expect(subs.map((s) => s.name)).toEqual(["planner"]);
-    });
-
-    test("excludes pending sessions", () => {
-      store.startSession("planner");
-      const subs = store.getSubagents();
-      expect(subs.map((s) => s.name)).toEqual(["planner"]);
-      expect(subs.some((s) => s.name === "writer")).toBe(false);
-      expect(subs.some((s) => s.name === "reviewer")).toBe(false);
-    });
-  });
-
-  // ── getActiveAgentIndex ────────────────────────────────────────────────────
-
-  describe("getActiveAgentIndex", () => {
-    beforeEach(() => {
-      store.setWorkflowInfo("wf", "claude", [
-        { name: "planner", parents: [] },
-        { name: "writer", parents: ["planner"] },
-        { name: "reviewer", parents: ["writer"] },
-      ], "prompt");
-      store.startSession("planner");
-      store.startSession("writer");
-    });
-
-    test("returns -1 when no agent is active", () => {
-      expect(store.getActiveAgentIndex()).toBe(-1);
-    });
-
-    test("returns correct index for first subagent", () => {
-      store.setViewMode("attached", "planner");
-      expect(store.getActiveAgentIndex()).toBe(0);
-    });
-
-    test("returns correct index for second subagent", () => {
-      store.setViewMode("attached", "writer");
-      expect(store.getActiveAgentIndex()).toBe(1);
-    });
-
-    test("returns -1 for orchestrator (not a subagent)", () => {
-      store.setViewMode("attached", "orchestrator");
-      expect(store.getActiveAgentIndex()).toBe(-1);
-    });
-
-    test("returns -1 for non-existent agent", () => {
-      store.setViewMode("attached", "nonexistent");
-      expect(store.getActiveAgentIndex()).toBe(-1);
-    });
-  });
 });

package/src/sdk/components/orchestrator-panel-store.ts

@@ -124,25 +124,6 @@ export class PanelStore {
     this.emit();
   }
 
-  /**
-   * Return non-orchestrator agents that have started (not pending).
-   * Used for the tmux status bar agent count and active-agent index.
-   */
-  getSubagents(): SessionData[] {
-    return this.sessions.filter(
-      (s) => s.name !== "orchestrator" && s.status !== "pending",
-    );
-  }
-
-  /**
-   * Return the 0-based index of the active agent within the subagent list,
-   * or -1 if not found.
-   */
-  getActiveAgentIndex(): number {
-    const subs = this.getSubagents();
-    return subs.findIndex((s) => s.name === this.activeAgentId);
-  }
-
   /** Safely invoke exitResolve at most once, guarding against rapid repeated calls. */
   resolveExit(): void {
     if (this.exitResolve) {

package/src/sdk/components/session-graph-panel.tsx

@@ -20,11 +20,15 @@ import {
 } from "react";
 import {
   tmuxRun,
-  escapeTmuxFormat,
   TMUX_DEFAULT_STATUS_LEFT,
   TMUX_DEFAULT_STATUS_LEFT_LENGTH,
   TMUX_DEFAULT_STATUS_RIGHT,
   TMUX_DEFAULT_STATUS_RIGHT_LENGTH,
+  TMUX_ATTACHED_STATUS_RIGHT,
+  TMUX_ATTACHED_STATUS_RIGHT_LENGTH,
+  TMUX_ATTACHED_WINDOW_FMT,
+  TMUX_ATTACHED_WINDOW_STYLE,
+  TMUX_ATTACHED_WINDOW_CURRENT_STYLE,
 } from "../runtime/tmux.ts";
 import {
   useStore,
@@ -353,52 +357,69 @@ export function SessionGraphPanel() {
     }
   }, [focusedId, focused, termW, termH, padX, padY, viewportH, layout.rowH]);
 
-  // ── Detect return to graph via Ctrl+G ─────────────────
-  // Ctrl+G is bound at the tmux level (select-window -t :0), so tmux
-  // swallows the key and the React app never receives it.  Poll the
-  // active window index while attached; when window 0 becomes active
-  // again we know the user returned and can reset viewMode immediately.
+  // ── Track active tmux window ──────────────────────────
+  // Ctrl+G and Ctrl+\ are bound at the tmux level, so the React app
+  // never receives them.  Poll the active window to sync viewMode
+  // with tmux-level navigation in both directions.
+  const hasStartedAgent = useMemo(
+    () => store.sessions.some((s) => s.name !== "orchestrator" && s.status !== "pending"),
+    [storeVersion],
+  );
+
   useEffect(() => {
-    if (store.viewMode !== "attached") return;
+    if (!hasStartedAgent) return;
 
     const check = () => {
       const result = tmuxRun([
-        "display-message", "-t", tmuxSession, "-p", "#{window_index}",
+        "display-message", "-t", tmuxSession, "-p", "#{window_index} #{window_name}",
       ]);
-      if (result.ok && result.stdout.trim() === "0") {
-        store.setViewMode("graph");
+      if (!result.ok) return;
+
+      const output = result.stdout.trim();
+      const spaceIdx = output.indexOf(" ");
+      const idx = spaceIdx >= 0 ? output.slice(0, spaceIdx) : output;
+      const windowName = spaceIdx >= 0 ? output.slice(spaceIdx + 1) : "";
+
+      if (idx === "0") {
+        if (store.viewMode !== "graph") {
+          store.setViewMode("graph");
+        }
+      } else if (store.viewMode !== "attached" || store.activeAgentId !== windowName) {
+        store.setViewMode("attached", windowName);
       }
     };
 
-    const id = setInterval(check, 300);
+    const id = setInterval(check, 500);
     return () => clearInterval(id);
-  }, [store.viewMode, tmuxSession]);
+  }, [tmuxSession, hasStartedAgent]);
 
   // ── Tmux status bar sync ──────────────────────────────
-  // When attached, the orchestrator panel is hidden (user views the agent's
-  // tmux window). Mirror the status line hints into tmux's own status bar
-  // so navigation keys remain discoverable.
-  const subagentCount = store.getSubagents().length;
-  const activeAgentIdx = store.getActiveAgentIndex();
-
+  // Attached mode: use tmux's native window list to show agent names
+  // (the current window is highlighted automatically by tmux).
+  // Graph mode: restore the minimal defaults.
   useEffect(() => {
-    if (store.viewMode === "attached" && store.activeAgentId) {
-      const safeName = escapeTmuxFormat(store.activeAgentId);
-      const left = `#[bg=#6c7086,fg=#1e1e2e,bold] ATTACHED #[default] #[fg=#7f849c]\u203a #[fg=#cdd6f4]${safeName} #[fg=#7f849c]${activeAgentIdx + 1}/${subagentCount}`;
-      const right = `#[fg=#7f849c]Graph: #[fg=#cdd6f4]ctrl+g #[fg=#7f849c]| Next: #[fg=#cdd6f4]ctrl+\\ `;
-
-      tmuxRun(["set", "-g", "status-left", left]);
-      tmuxRun(["set", "-g", "status-left-length", "50"]);
-      tmuxRun(["set", "-g", "status-right", right]);
-      tmuxRun(["set", "-g", "status-right-length", "40"]);
+    if (store.viewMode === "attached") {
+      tmuxRun(["set", "-g", "status-left", " "]);
+      tmuxRun(["set", "-g", "status-left-length", "1"]);
+      tmuxRun(["set", "-g", "status-right", TMUX_ATTACHED_STATUS_RIGHT]);
+      tmuxRun(["set", "-g", "status-right-length", TMUX_ATTACHED_STATUS_RIGHT_LENGTH]);
+      tmuxRun(["set", "-g", "window-status-format", TMUX_ATTACHED_WINDOW_FMT]);
+      tmuxRun(["set", "-g", "window-status-current-format", TMUX_ATTACHED_WINDOW_FMT]);
+      tmuxRun(["set", "-g", "window-status-style", TMUX_ATTACHED_WINDOW_STYLE]);
+      tmuxRun(["set", "-g", "window-status-current-style", TMUX_ATTACHED_WINDOW_CURRENT_STYLE]);
+      tmuxRun(["set", "-g", "window-status-separator", ""]);
     } else {
-      // Graph mode: restore defaults (constants from tmux.ts match tmux.conf)
       tmuxRun(["set", "-g", "status-left", TMUX_DEFAULT_STATUS_LEFT]);
       tmuxRun(["set", "-g", "status-left-length", TMUX_DEFAULT_STATUS_LEFT_LENGTH]);
       tmuxRun(["set", "-g", "status-right", TMUX_DEFAULT_STATUS_RIGHT]);
       tmuxRun(["set", "-g", "status-right-length", TMUX_DEFAULT_STATUS_RIGHT_LENGTH]);
+      tmuxRun(["set", "-gu", "window-status-format"]);
+      tmuxRun(["set", "-gu", "window-status-current-format"]);
+      tmuxRun(["set", "-gu", "window-status-style"]);
+      tmuxRun(["set", "-gu", "window-status-current-style"]);
+      tmuxRun(["set", "-gu", "window-status-separator"]);
     }
-  }, [store.viewMode, store.activeAgentId, activeAgentIdx, subagentCount]);
+  }, [store.viewMode]);
 
   // Restore default tmux status bar on unmount
   useEffect(() => {
@@ -407,6 +428,11 @@ export function SessionGraphPanel() {
       tmuxRun(["set", "-g", "status-left-length", TMUX_DEFAULT_STATUS_LEFT_LENGTH]);
       tmuxRun(["set", "-g", "status-right", TMUX_DEFAULT_STATUS_RIGHT]);
       tmuxRun(["set", "-g", "status-right-length", TMUX_DEFAULT_STATUS_RIGHT_LENGTH]);
+      tmuxRun(["set", "-gu", "window-status-format"]);
+      tmuxRun(["set", "-gu", "window-status-current-format"]);
+      tmuxRun(["set", "-gu", "window-status-style"]);
+      tmuxRun(["set", "-gu", "window-status-current-style"]);
+      tmuxRun(["set", "-gu", "window-status-separator"]);
     };
   }, []);
 

package/src/sdk/runtime/tmux.ts

@@ -40,14 +40,17 @@ export const TMUX_DEFAULT_STATUS_LEFT_LENGTH = "10";
 export const TMUX_DEFAULT_STATUS_RIGHT = " #{session_name} | %H:%M ";
 export const TMUX_DEFAULT_STATUS_RIGHT_LENGTH = "60";
 
-/**
- * Escape a string for safe interpolation into tmux format strings.
- * Replaces `#` with `##` to prevent tmux from interpreting `#[...]`
- * as style directives or `#(...)` as shell command expansions.
- */
-export function escapeTmuxFormat(value: string): string {
-  return value.replace(/#/g, "##");
-}
+// Attached-mode status bar — agent list via tmux window list + shortcut hints.
+// The window-status formats hide window 0 (orchestrator) and style agent names.
+// tmux natively highlights the current window, so no React state sync is needed
+// for agent cycling via Ctrl+\.
+export const TMUX_ATTACHED_STATUS_RIGHT =
+  "#[fg=#cdd6f4]ctrl+g #[fg=#6c7086]graph #[fg=#585b70]\u00b7 #[fg=#cdd6f4]ctrl+\\ #[fg=#6c7086]next ";
+export const TMUX_ATTACHED_STATUS_RIGHT_LENGTH = "40";
+export const TMUX_ATTACHED_WINDOW_FMT =
+  "#{?#{==:#{window_index},0},, #W }";
+export const TMUX_ATTACHED_WINDOW_STYLE = "fg=#6c7086";
+export const TMUX_ATTACHED_WINDOW_CURRENT_STYLE = "fg=#cdd6f4,bold";
 
 // ---------------------------------------------------------------------------
 // Core tmux primitives

package/src/services/system/auto-sync.ts

@@ -11,19 +11,18 @@
  * comparing the bundled `VERSION` constant against a marker file at
  * `~/.atomic/.synced-version`. On a mismatch we run the same setup the
  * production bootstrap installers (`install.sh` / `install.ps1`) provide,
- * grouped into two parallel phases:
+ * as a single parallel phase:
  *
- *   Phase 1 (parallel — no inter-dependencies):
- *     1. Node.js / npm           (installed via fnm, no system pkg-mgr)
- *     2. tmux / psmux            (terminal multiplexer for `chat` / `workflow`)
- *     3. global agent configs    (file copies — no network)
+ *     1. tmux / psmux            (terminal multiplexer for `chat` / `workflow`)
+ *     2. global agent configs    (file copies — no network)
+ *     3. @playwright/cli         (bun install -g)
+ *     4. @llamaindex/liteparse   (bun install -g)
+ *     5. global skills           (bunx skills add ...)
  *
- *   Phase 2 (parallel — all need npm from Phase 1):
- *     4. @playwright/cli         (npm install -g)
- *     5. @llamaindex/liteparse   (npm install -g)
- *     6. global skills           (npx skills add ...)
+ * All steps run concurrently using bun (already our runtime) for package
+ * installs and `bunx` for CLI tools, avoiding a ~48 s Node.js/npm
+ * download via fnm that previously gated Phase 2.
  *
- * Steps within each phase run concurrently; phases run sequentially.
  * Failures are collected and reported as a summary at the end, but never
  * abort the run — partial setup matches the production installer's
  * "best-effort" semantics. The marker is written after every run (success
@@ -36,7 +35,6 @@ import { homedir } from "node:os";
 import { VERSION } from "../../version.ts";
 import { COLORS } from "../../theme/colors.ts";
 import {
-  ensureNpmInstalled,
   ensureTmuxInstalled,
   upgradePlaywrightCli,
   upgradeLiteparse,
@@ -93,33 +91,21 @@ export async function autoSyncIfStale(): Promise<void> {
     `\n  ${COLORS.dim}Setting up atomic ${COLORS.reset}${COLORS.bold}v${VERSION}${COLORS.reset}${COLORS.dim}…${COLORS.reset}`,
   );
 
-  // Steps are split into two parallel phases:
-  //
-  //  Phase 1 — core tools + file copies (no inter-dependencies):
-  //    npm is installed via fnm (not a system package manager), so it
-  //    won't contend with tmux's apt-get/dnf install. Agent config
-  //    copies are pure file I/O with no network or npm dependency.
-  //
-  //  Phase 2 — npm-dependent tasks (run after Phase 1):
-  //    @playwright/cli, @llamaindex/liteparse, and `npx skills` all
-  //    need npm/npx. They install independent packages, so they can
-  //    run concurrently.
+  // All steps run in a single parallel phase. bun (already our runtime)
+  // handles global package installs and `bunx` execution, so there is no
+  // need to install Node.js/npm first — eliminating a ~48 s fnm download
+  // that previously dominated the loading screen.
   //
   // Each step's failure is caught inside `runSteps` (not thrown), so
   // subsequent steps still run even if one fails — matches install.sh's
   // best-effort contract.
   const results = await runSteps([
-    // Phase 1 — parallel
     [
-      { label: "Node.js / npm",        fn: () => ensureNpmInstalled({ quiet: true }) },
       { label: "tmux / psmux",         fn: () => ensureTmuxInstalled({ quiet: true }) },
       { label: "global agent configs", fn: installGlobalAgents },
-    ],
-    // Phase 2 — parallel, after Phase 1
-    [
-      { label: "@playwright/cli",       fn: upgradePlaywrightCli },
+      { label: "@playwright/cli",      fn: upgradePlaywrightCli },
       { label: "@llamaindex/liteparse", fn: upgradeLiteparse },
-      { label: "global skills",         fn: installGlobalSkills },
+      { label: "global skills",        fn: installGlobalSkills },
     ],
   ]);
 

package/src/services/system/install-ui.ts

@@ -11,10 +11,9 @@
  * that falls back gracefully through 256-color → basic ANSI.
  *
  * Steps are grouped into **phases**. Steps within a phase run in parallel
- * (via `Promise.all`); phases themselves run sequentially so later phases
- * can depend on earlier ones (e.g. npm must be available before
- * `npm install -g` tasks). The progress bar advances and the label
- * updates in real-time as individual steps complete within a phase.
+ * (via `Promise.all`); phases themselves run sequentially. The progress
+ * bar advances and the label updates in real-time as individual steps
+ * complete within a phase.
  *
  * A final summary (✓/✗ per step) is printed after all steps finish, and
  * any captured stderr/stdout from a failed step is shown beneath it.

package/src/services/system/skills.ts

@@ -18,15 +18,20 @@ interface NpxSkillsResult {
 }
 
 async function runNpxSkills(args: string[]): Promise<NpxSkillsResult> {
-  const npxPath = Bun.which("npx");
-  if (!npxPath) {
-    return { ok: false, details: "npx not found on PATH" };
+  // Prefer bunx (already available as our runtime) over npx to avoid
+  // depending on a full Node.js/npm installation.
+  const runner = Bun.which("bunx") ?? Bun.which("npx");
+  if (!runner) {
+    return { ok: false, details: "neither bunx nor npx found on PATH" };
   }
 
   // Capture stdout/stderr so the outer spinner UI owns terminal output and
-  // can surface the tail of any failure. `npx skills add` is otherwise
-  // very chatty.
-  const proc = Bun.spawn([npxPath, "--yes", "skills", ...args], {
+  // can surface the tail of any failure.
+  const isBunx = runner.endsWith("bunx");
+  const cmd = isBunx
+    ? [runner, "skills", ...args]
+    : [runner, "--yes", "skills", ...args];
+  const proc = Bun.spawn(cmd, {
     stdout: "pipe",
     stderr: "pipe",
   });