@cluesmith/codev 2.0.0-rc.6 → 2.0.0-rc.60

package/skeleton/roles/builder.md

@@ -1,211 +1,155 @@
 # Role: Builder
 
-A Builder is a focused implementation agent that works on a single spec in an isolated git worktree. Builders are spawned by the Architect and report their status back.
+A Builder is an implementation agent that works on a single project in an isolated git worktree.
 
-> **Quick Reference**: See `codev/resources/workflow-reference.md` for stage diagrams and common commands.
+## Two Operating Modes
 
-## Output Formatting
+Builders run in one of two modes, determined by how they were spawned:
 
-When referencing files, use standard file paths or open them directly with `af open`:
+| Mode | Command | Behavior |
+|------|---------|----------|
+| **Strict** (default) | `af spawn -p XXXX` | Porch orchestrates - runs autonomously to completion |
+| **Soft** | `af spawn --soft -p XXXX` | AI follows protocol - architect verifies compliance |
 
-```bash
-# Open a file for review in the dashboard
-af open src/lib/auth.ts
+## Strict Mode (Default)
 
-# Check your status
-af status
+Spawned with: `af spawn -p XXXX`
 
-# Send a message to the architect
-af send architect "Question about the spec..."
-```
+In strict mode, porch orchestrates your work and drives the protocol to completion autonomously. Your job is simple: **run porch until the project completes**.
 
-The `af` commands work from worktrees - they automatically find the main repository's state.
+### The Core Loop
 
-## Responsibilities
+```bash
+# 1. Check your current state
+porch status
 
-1. **Implement a single spec** - Focus on one well-defined task
-2. **Work in isolation** - Use the assigned git worktree
-3. **Follow the assigned protocol** - SPIDER or TICK as specified in the spec
-4. **Report status** - Keep status updated (implementing/blocked/pr-ready)
-5. **Request help when blocked** - Don't spin; output a clear blocker message
-6. **Deliver clean PRs** - Tests passing, code reviewed, protocol artifacts complete
+# 2. Run the protocol loop
+porch run
 
-## Protocol Adherence
+# 3. If porch hits a gate, STOP and wait for human approval
+# 4. After gate approval, run porch again
+# 5. Repeat until project is complete
+```
 
-**The spec will tell you which protocol to use: SPIDER or TICK.**
+Porch handles:
+- Spawning Claude to create artifacts (spec, plan, code)
+- Running 3-way consultations (Gemini, Codex, Claude)
+- Iterating based on feedback
+- Enforcing phase transitions
 
-You are expected to **adhere FULLY to the protocol**. Before starting:
-1. Read the spec carefully to identify the protocol
-2. Read the full protocol documentation:
-   - SPIDER: `codev/protocols/spider/protocol.md`
-   - TICK: `codev/protocols/tick/protocol.md`
-3. Follow every phase and produce all required artifacts
+### Gates: When to STOP
 
-### SPIDER Protocol Summary
+Porch has two human approval gates:
 
-SPIDER works in phases. The Builder is responsible for **IDER** (the Architect handles SP):
+| Gate | When | What to do |
+|------|------|------------|
+| `spec-approval` | After spec is written | **STOP** and wait |
+| `plan-approval` | After plan is written | **STOP** and wait |
 
-1. **Implement** - Write the code following the plan
+When porch outputs:
+```
+GATE: spec-approval
+Human approval required. STOP and wait.
+```
 
-2. **Defend** - Write tests to validate the implementation
+You must:
+1. Output a clear message: "Spec ready for approval. Waiting for human."
+2. **STOP working**
+3. Wait for the human to run `porch approve XXXX spec-approval`
+4. After approval, run `porch run` again
 
-3. **Evaluate** - Verify requirements are met
-   - Self-review: Does the implementation satisfy the spec?
-   - Self-review: Do the tests adequately cover the requirements?
-   - **Consult external reviewers** on the complete implementation + tests:
-     ```bash
-     consult --model gemini --type impl-review spec XXXX
-     consult --model codex --type impl-review spec XXXX
-     ```
-   - Address concerns raised before proceeding to Review
+### What You DON'T Do in Strict Mode
 
-4. **Review** - Document lessons learned, run 3-way review, create PR
-   - Write the review document (`codev/reviews/XXXX-spec-name.md`)
-   - **Run 3-way parallel review focused on IMPLEMENTATION quality**:
-     ```bash
-     QUERY="Review Spec XXXX implementation. Branch: builder/XXXX-...
+- **Don't manually follow SPIR steps** - Porch handles this
+- **Don't run consult directly** - Porch runs 3-way reviews
+- **Don't edit status.yaml phase/iteration** - Only porch modifies state
+- **Don't call porch approve** - Only humans approve gates
+- **Don't skip gates** - Always stop and wait for approval
 
-     Focus on:
-     - Implementation quality and correctness
-     - Test coverage and quality
-     - Adherence to spec requirements
-     - Code patterns and best practices
-     - Edge cases and error handling
+## Soft Mode
 
-     Give verdict: APPROVE or REQUEST_CHANGES."
+Spawned with: `af spawn --soft -p XXXX` or `af spawn --task "..."`
 
-     consult --model gemini --type pr-ready pr $PR_NUMBER &
-     consult --model codex --type pr-ready pr $PR_NUMBER &
-     consult --model claude --type pr-ready pr $PR_NUMBER &
-     wait
-     ```
-   - Address any REQUEST_CHANGES feedback before creating the PR
-   - Include the 3-way review summary in your PR description
+In soft mode, you follow the protocol document yourself. The architect monitors your work and verifies you're adhering to the protocol correctly.
 
-   **Note**: The Architect will run a separate 3-way review focused on **integration** concerns.
+### Startup Sequence
 
-**Commit at the end of each phase** with a message indicating the phase:
 ```bash
-git add <files>
-git commit -m "[Spec XXXX][Implement] Add auth routes"
-git commit -m "[Spec XXXX][Defend] Add unit tests for auth"
-git commit -m "[Spec XXXX][Review] Add lessons learned"
-```
-
-### TICK Protocol Summary
-
-TICK is for smaller, well-defined tasks:
-- Understand → Implement → Verify → Done
-
-Follow the TICK protocol documentation for details.
-
-## Spec Compliance (CRITICAL)
+# Read the spec and/or plan
+cat codev/specs/XXXX-*.md
+cat codev/plans/XXXX-*.md
 
-**The spec is the source of truth. Code that doesn't match the spec is wrong, even if it "works".**
+# Read the protocol
+cat codev/protocols/spir/protocol.md
 
-### Pre-Implementation Sanity Check (PISC)
-
-**Before writing ANY code, run this checklist:**
+# Start implementing
+```
 
-1. ✅ "Have I read the spec in the last 30 minutes?"
-2. ✅ "If the spec has a 'Traps to Avoid' section, have I read it?"
-3. ✅ "Does my planned approach match the spec's Technical Implementation section?"
-4. ✅ "If the spec has code examples, am I following them?"
-5. ✅ "Does the existing code I'm building on actually match the spec?"
+### The SPIR Protocol (Specify → Plan → Implement → Review)
 
-**If ANY answer is "no" or "I'm not sure" → STOP and re-read the spec before proceeding.**
+1. **Specify**: Read or create the spec at `codev/specs/XXXX-name.md`
+2. **Plan**: Read or create the plan at `codev/plans/XXXX-name.md`
+3. **Implement**: Write code following the plan phases
+4. **Review**: Write lessons learned and create PR
 
-### The Trust Hierarchy
+### Consultations
 
+Run 3-way consultations at checkpoints:
+```bash
+# After writing spec
+consult --model gemini --type spec-review spec XXXX &
+consult --model codex --type spec-review spec XXXX &
+consult --model claude --type spec-review spec XXXX &
+wait
+
+# After writing plan
+consult --model gemini --type plan-review plan XXXX &
+consult --model codex --type plan-review plan XXXX &
+consult --model claude --type plan-review plan XXXX &
+wait
+
+# After implementation
+consult --model gemini --type impl-review pr N &
+consult --model codex --type impl-review pr N &
+consult --model claude --type impl-review pr N &
+wait
 ```
-SPEC (source of truth)
-  ↓
-PLAN (implementation guide derived from spec)
-  ↓
-EXISTING CODE (NOT TRUSTED - must be validated against spec)
-```
-
-**Never trust existing code over the spec.** Previous implementations may have drifted. The spec is always authoritative.
-
-### Avoiding "Fixing Mode"
 
-A dangerous pattern: You start looking at symptoms in code, making incremental fixes, copying existing patterns - without going back to the source of truth (spec). This leads to:
-- Cargo-culting existing patterns that may be wrong
-- Building on broken foundations
-- Implementing something different from what the spec describes
-
-**When you catch yourself "fixing" code:**
-1. STOP
-2. Ask: "What does the spec say about this?"
-3. Re-read the spec's Traps to Avoid section
-4. Verify existing code matches the spec before building on it
+## Deliverables
 
-### Phrases That Should Trigger Spec Re-reading
+- Spec at `codev/specs/XXXX-name.md`
+- Plan at `codev/plans/XXXX-name.md`
+- Review at `codev/reviews/XXXX-name.md`
+- Implementation code with tests
+- PR ready for architect review
 
-If you think or receive any of these, immediately re-read the spec:
-- "Does this match the spec?"
-- "What does the spec say about X?"
-- "Check the spec's Traps to Avoid section"
-- "Are you sure?"
-- "You're cargo-culting existing patterns"
+## Communication
 
-## Status Lifecycle
+### With the Architect
 
-```
-spawning → implementing → blocked → implementing → pr-ready → complete
-               ↑______________|
+If you're blocked or need help:
+```bash
+af send architect "Question about the spec..."
 ```
 
-### Status Definitions
-
-| Status | Meaning |
-|--------|---------|
-| `spawning` | Worktree created, Builder starting up |
-| `implementing` | Actively working on the spec |
-| `blocked` | Stuck, needs Architect help |
-| `pr-ready` | Implementation complete, ready for review |
-| `complete` | Merged, worktree can be cleaned up |
-
 ### Checking Status
 
 ```bash
-af status
+porch status      # (strict mode) Your project status
+af status         # All builders
 ```
 
-You can check your own status and see other builders. The Architect also monitors status.
-
-## Working in a Worktree
-
-### Understanding Your Environment
-- You are in an isolated git worktree at `.builders/XXXX/`
-- You have your own branch: `builder/XXXX-spec-name`
-- Changes here don't affect main until merged
-- You can commit freely without affecting other Builders
-
-### File Access
-- Full access to your worktree
-- Read-only conceptual access to main (for reference)
-- Your spec is at `codev/specs/XXXX-spec-name.md`
-- Your plan is at `codev/plans/XXXX-spec-name.md`
-
-## When to Report Blocked
+## When You're Blocked
 
-Report `blocked` status when:
-- Spec is ambiguous and you need clarification
-- You discover a dependency on another spec
-- You encounter an unexpected technical blocker
-- You need architectural guidance
-- Tests are failing for reasons outside your scope
+If you encounter issues you can't resolve:
 
-**Do NOT stay blocked silently.** Communicate your blocker clearly:
+1. **Output a clear blocker message** describing the problem and options
+2. **Use `af send architect "..."` ** to notify the Architect
+3. **Wait for guidance** before proceeding
 
-1. Output a clear message in your terminal describing the blocker and options
-2. Add a `<!-- REVIEW(@architect): question here -->` comment in relevant code if applicable
-3. The Architect monitors builder status via `af status` and will see you're blocked
-
-Example blocker message to output:
+Example:
 ```
-## BLOCKED: Spec 0003
+## BLOCKED: Spec 0077
 Can't find the auth helper mentioned in spec. Options:
 1. Create a new auth helper
 2. Use a third-party library
@@ -213,65 +157,12 @@ Can't find the auth helper mentioned in spec. Options:
 Waiting for Architect guidance.
 ```
 
-The Architect will provide guidance via `af send` or PR comments.
-
-## Deliverables
-
-When done, a Builder should have:
-
-1. **Implementation** - Code that fulfills the spec
-2. **Tests** - Appropriate test coverage
-3. **Documentation** - Updated relevant docs (if needed)
-4. **Clean commits** - Atomic, well-messaged commits per phase
-5. **Review document** - As specified in the SPIDER protocol (`codev/reviews/XXXX-spec-name.md`)
-6. **PR-ready branch** - Ready for Architect review
-
-## Communication with Architect
-
-### Receiving Instructions
-The Architect provides:
-- Spec file path
-- Plan file path
-- Protocol to follow (SPIDER/TICK)
-- Context and constraints
-
-### Reporting Completion
-When implementation is complete:
-1. Run all tests
-2. Self-review the code
-3. Ensure all protocol artifacts are present (especially the review document for SPIDER)
-4. Create a PR: `gh pr create --title "[Spec XXXX] Description" --body "..."`
-5. Update status to `pr-ready`
-6. Wait for Architect review and approval
-7. **Merge your own PR** once approved: `gh pr merge --merge --delete-branch`
-
-**Important**: The Builder is responsible for merging after Architect approval. This ensures the Builder sees the merge succeed and can handle any final cleanup.
-
-### Receiving PR Feedback
-
-The Architect reviews PRs and leaves feedback as GitHub PR comments. When notified to check feedback:
-
-```bash
-# View PR comments
-gh pr view <PR_NUMBER> --comments
-
-# Or view the full PR with comments in browser
-gh pr view <PR_NUMBER> --web
-```
-
-**Workflow:**
-1. Architect leaves review comments on PR
-2. You receive a short message: "Check PR comments and address feedback"
-3. Run `gh pr view <PR_NUMBER> --comments` to see feedback
-4. Address the issues (High priority first, then Medium, Low is optional)
-5. Push fixes to the same branch
-6. Reply to PR comment when done or if clarification needed
-
 ## Constraints
 
-- **Stay in scope** - Only implement what's in your spec
-- **Don't modify shared config** - Without Architect approval
-- **Merge your own PRs** - After Architect approves, you are responsible for merging
-- **Don't spawn other Builders** - Only Architects spawn Builders
+- **Stay in scope** - Only implement what's in the spec
+- **Merge your own PRs** - After architect approves
 - **Keep worktree clean** - No untracked files, no debug code
-- **Follow the protocol** - All phases, all artifacts
+- **(Strict mode)** Run porch, don't bypass it
+- **(Strict mode)** Stop at gates - Human approval is required
+- **(Strict mode)** NEVER edit status.yaml directly
+- **(Strict mode)** NEVER call porch approve

package/skeleton/templates/AGENTS.md

@@ -8,7 +8,7 @@ This project uses **Codev** for AI-assisted development.
 
 ## Available Protocols
 
-- **SPIDER**: Multi-phase development with consultation (`codev/protocols/spider/protocol.md`)
+- **SPIR**: Multi-phase development with consultation (`codev/protocols/spir/protocol.md`)
 - **TICK**: Fast autonomous implementation (`codev/protocols/tick/protocol.md`)
 - **EXPERIMENT**: Disciplined experimentation (`codev/protocols/experiment/protocol.md`)
 - **MAINTAIN**: Codebase maintenance (`codev/protocols/maintain/protocol.md`)
@@ -60,7 +60,7 @@ For complete reference, see `codev/resources/commands/`:
 
 ## Configuration
 
-Customize Agent Farm behavior in `codev/config.json`:
+Agent Farm is configured via `af-config.json` at the project root. Created during `codev init` or `codev adopt`. Override via CLI flags: `--architect-cmd`, `--builder-cmd`, `--shell-cmd`.
 
 ```json
 {

package/skeleton/templates/CLAUDE.md

@@ -6,7 +6,7 @@ This project uses **Codev** for AI-assisted development.
 
 ## Available Protocols
 
-- **SPIDER**: Multi-phase development with consultation (`codev/protocols/spider/protocol.md`)
+- **SPIR**: Multi-phase development with consultation (`codev/protocols/spir/protocol.md`)
 - **TICK**: Fast autonomous implementation (`codev/protocols/tick/protocol.md`)
 - **EXPERIMENT**: Disciplined experimentation (`codev/protocols/experiment/protocol.md`)
 - **MAINTAIN**: Codebase maintenance (`codev/protocols/maintain/protocol.md`)
@@ -58,7 +58,7 @@ For complete reference, see `codev/resources/commands/`:
 
 ## Configuration
 
-Customize Agent Farm behavior in `codev/config.json`:
+Agent Farm is configured via `af-config.json` at the project root. Created during `codev init` or `codev adopt`. Override via CLI flags: `--architect-cmd`, `--builder-cmd`, `--shell-cmd`.
 
 ```json
 {

package/skeleton/templates/cheatsheet.md

@@ -41,7 +41,7 @@ Just like structuring a human team—clear roles, defined processes, explicit ha
 
 | Component | Purpose |
 |-----------|---------|
-| Protocols | Define HOW work happens (SPIDER, TICK, etc.) |
+| Protocols | Define HOW work happens (SPIR, TICK, etc.) |
 | Roles | Define WHO does what (Architect, Builder, Consultant) |
 | Parallelism | Scale by running multiple builders simultaneously |
 
@@ -60,7 +60,7 @@ A **protocol** is a structured workflow that defines how work progresses from id
 
 | Protocol | Use For | Phases |
 |----------|---------|--------|
-| **SPIDER** | New features | Specify → Plan → Implement → Defend → Evaluate → Review |
+| **SPIR** | New features | Specify → Plan → Implement → Review |
 | **TICK** | Amendments to existing specs | Task Identification → Coding → Kickout |
 | **MAINTAIN** | Codebase hygiene | Dead code removal, documentation sync |
 | **EXPERIMENT** | Research & prototyping | Hypothesis → Experiment → Conclude |
@@ -110,13 +110,15 @@ Architect-Builder orchestration. Used by both **humans and agents**—agents use
 
 | Command | Description |
 |---------|-------------|
-| `af start` | Start dashboard (port 4200, 4300, etc.) |
-| `af stop` | Stop all processes |
+| `af dash start` | Start dashboard (port 4200, 4300, etc.) |
+| `af dash stop` | Stop all processes |
 | `af spawn -p <id>` | Spawn a builder for project |
 | `af status` | Check status of all builders |
 | `af send <target> <msg>` | Send message (builder↔architect) |
 | `af cleanup -p <id>` | Clean up a builder worktree |
+| `af shell` | Spawn a utility shell |
 | `af open <file>` | Open file in dashboard viewer |
+| `af tower start` | Start cross-project tower |
 
 ### consult
 
@@ -143,7 +145,7 @@ Multi-agent consultation. Used by both humans and agents—**mostly agents** dur
 
 ## Quick Reference
 
-### SPIDER Checklist
+### SPIR Checklist
 
 ```
 [ ] Specify - Write spec in codev/specs/XXXX-name.md

package/skeleton/templates/projectlist.md

@@ -142,6 +142,6 @@ To see high-priority work, search for `priority: high`.
 Before starting a project, verify its dependencies are at least `implemented`.
 
 ### Protocol Selection
-- **SPIDER**: Most projects (formal spec → plan → implement → review)
+- **SPIR**: Most projects (formal spec → plan → implement → review)
 - **TICK**: Small, well-defined tasks (< 300 lines) or amendments to existing specs
 - **EXPERIMENT**: Research/prototyping before committing to a project

package/templates/dashboard/index.html

@@ -4,25 +4,19 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>AF: {{PROJECT_NAME}}</title>
-  <!-- CSS files loaded in dependency order -->
-  <link rel="stylesheet" href="/dashboard/css/variables.css">
-  <link rel="stylesheet" href="/dashboard/css/layout.css">
-  <link rel="stylesheet" href="/dashboard/css/tabs.css">
-  <link rel="stylesheet" href="/dashboard/css/statusbar.css">
-  <link rel="stylesheet" href="/dashboard/css/dialogs.css">
-  <link rel="stylesheet" href="/dashboard/css/activity.css">
-  <link rel="stylesheet" href="/dashboard/css/projects.css">
-  <link rel="stylesheet" href="/dashboard/css/files.css">
-  <link rel="stylesheet" href="/dashboard/css/utilities.css">
+  <!-- CSS files loaded in dependency order (relative paths for proxy compatibility) -->
+  <link rel="stylesheet" href="dashboard/css/variables.css">
+  <link rel="stylesheet" href="dashboard/css/layout.css">
+  <link rel="stylesheet" href="dashboard/css/tabs.css">
+  <link rel="stylesheet" href="dashboard/css/statusbar.css">
+  <link rel="stylesheet" href="dashboard/css/dialogs.css">
+  <link rel="stylesheet" href="dashboard/css/projects.css">
+  <link rel="stylesheet" href="dashboard/css/files.css">
+  <link rel="stylesheet" href="dashboard/css/utilities.css">
 </head>
 <body>
   <header class="header">
     <h1>Agent Farm - {{PROJECT_NAME}}</h1>
-    <div class="header-actions">
-      <button class="btn activity-summary-btn" onclick="showActivitySummary()" title="What did I do today?">
-        🕐 Today
-      </button>
-    </div>
   </header>
 
   <main class="main">
@@ -123,26 +117,6 @@
   <!-- Toast container -->
   <div class="toast-container" id="toast-container"></div>
 
-  <!-- Activity Summary Modal (Spec 0059) -->
-  <div class="dialog-overlay hidden" id="activity-modal">
-    <div class="dialog activity-dialog">
-      <div class="activity-dialog-header">
-        <h3>Today's Summary</h3>
-        <button class="activity-close-btn" onclick="closeActivityModal()" title="Close (Esc)">×</button>
-      </div>
-      <div class="activity-dialog-content" id="activity-content">
-        <div class="activity-loading">
-          <span class="activity-spinner"></span>
-          Loading activity...
-        </div>
-      </div>
-      <div class="activity-dialog-footer">
-        <button class="btn" onclick="copyActivitySummary()">📋 Copy to Clipboard</button>
-        <button class="btn" onclick="closeActivityModal()">Close</button>
-      </div>
-    </div>
-  </div>
-
   <!-- File search palette (Cmd+P) - Spec 0058 -->
   <div id="file-palette" class="file-palette hidden">
     <div class="file-palette-backdrop" onclick="closePalette()"></div>
@@ -163,13 +137,13 @@
   </script>
 
   <!-- JavaScript files loaded in dependency order -->
-  <script src="/dashboard/js/state.js"></script>
-  <script src="/dashboard/js/utils.js"></script>
-  <script src="/dashboard/js/tabs.js"></script>
-  <script src="/dashboard/js/dialogs.js"></script>
-  <script src="/dashboard/js/projects.js"></script>
-  <script src="/dashboard/js/files.js"></script>
-  <script src="/dashboard/js/activity.js"></script>
-  <script src="/dashboard/js/main.js"></script>
+  <!-- JS files (relative paths for proxy compatibility) -->
+  <script src="dashboard/js/state.js"></script>
+  <script src="dashboard/js/utils.js"></script>
+  <script src="dashboard/js/tabs.js"></script>
+  <script src="dashboard/js/dialogs.js"></script>
+  <script src="dashboard/js/projects.js"></script>
+  <script src="dashboard/js/files.js"></script>
+  <script src="dashboard/js/main.js"></script>
 </body>
 </html>

package/templates/dashboard/js/dialogs.js

@@ -20,7 +20,7 @@ async function closeTab(tabId, event) {
   // Check if process is still running before showing confirmation (Bugfix #132)
   // If the shell/builder already exited, close immediately without confirmation
   try {
-    const response = await fetch(`/api/tabs/${encodeURIComponent(tabId)}/running`);
+    const response = await fetch(apiUrl(`api/tabs/${encodeURIComponent(tabId)}/running`));
     if (response.ok) {
       const { running } = await response.json();
       if (!running) {
@@ -56,7 +56,7 @@ async function doCloseTab(tabId) {
   if (!tab) return;
 
   try {
-    await fetch(`/api/tabs/${encodeURIComponent(tabId)}`, { method: 'DELETE' });
+    await fetch(apiUrl(`api/tabs/${encodeURIComponent(tabId)}`), { method: 'DELETE' });
 
     tabs = tabs.filter(t => t.id !== tabId);
 
@@ -224,7 +224,7 @@ async function createFile() {
   }
 
   try {
-    const response = await fetch('/api/files', {
+    const response = await fetch(apiUrl('api/files'), {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ path: filePath, content: '' })
@@ -251,7 +251,7 @@ async function createFile() {
 // Spawn worktree builder
 async function spawnBuilder() {
   try {
-    const response = await fetch('/api/tabs/builder', {
+    const response = await fetch(apiUrl('api/tabs/builder'), {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({})
@@ -283,7 +283,7 @@ async function spawnBuilder() {
 // Spawn shell
 async function spawnShell() {
   try {
-    const response = await fetch('/api/tabs/shell', {
+    const response = await fetch(apiUrl('api/tabs/shell'), {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({})
@@ -325,7 +325,7 @@ async function spawnShell() {
 // Create new utility shell (quick action button)
 async function createNewShell() {
   try {
-    const response = await fetch('/api/tabs/shell', { method: 'POST' });
+    const response = await fetch(apiUrl('api/tabs/shell'), { method: 'POST' });
     const data = await response.json();
     if (!data.success && data.error) {
       showToast(data.error || 'Failed to create shell', 'error');
@@ -347,7 +347,7 @@ async function createNewWorktreeShell() {
   if (branch === null) return;
 
   try {
-    const response = await fetch('/api/tabs/shell', {
+    const response = await fetch(apiUrl('api/tabs/shell'), {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ worktree: true, branch: branch || undefined })

package/templates/dashboard/js/files.js

@@ -22,7 +22,7 @@ function stopFilesPolling() {
 // Check if files have changed and refresh if needed
 async function checkFilesForChanges() {
   try {
-    const response = await fetch(`/api/files/hash?t=${Date.now()}`);
+    const response = await fetch(apiUrl(`api/files/hash?t=${Date.now()}`));
     if (!response.ok) return;
 
     const data = await response.json();
@@ -42,7 +42,7 @@ async function checkFilesForChanges() {
 async function loadFilesTree() {
   try {
     // Add cache-busting param to ensure fresh data
-    const response = await fetch(`/api/files?t=${Date.now()}`);
+    const response = await fetch(apiUrl(`api/files?t=${Date.now()}`));
     if (!response.ok) {
       throw new Error(`HTTP ${response.status}: ${response.statusText}`);
     }