plumb: add executeBash IPC call

Author: ammario

docs/README.md

@@ -40,28 +40,31 @@ docs/
 
 ### Example Mermaid Diagram
 
-~~~markdown
+````markdown
 ```mermaid
 graph LR
     A[Start] --> B[Process]
     B --> C[End]
 ```
-~~~
+````
 
 ## CI/CD
 
 Docs are automatically built and deployed via `.github/workflows/docs.yml` when:
+
 - Changes are pushed to `main` branch in the `docs/` directory
 - Workflow is manually triggered
 
 ## Requirements
 
 The following tools are needed to build locally:
+
 - `mdbook` (v0.4.52+)
 - `mdbook-mermaid` (v0.16.0+)
 - `mdbook-linkcheck` (v0.7.7+)
 
 Install via cargo:
+
 ```bash
 cargo install mdbook mdbook-mermaid mdbook-linkcheck
 mdbook-mermaid install docs

docs/src/keybinds.md

@@ -10,35 +10,36 @@ cmux is designed to be keyboard-driven for maximum efficiency. All major actions
 - **Linux/Windows**: Shortcuts use `Ctrl` as the primary modifier
 
 When documentation shows `Ctrl`, it means:
+
 - `⌘` (Command) on macOS
 - `Ctrl` on Linux/Windows
 
 ## General
 
-| Action | Shortcut |
-|--------|----------|
-| Cancel / Close / Interrupt | `Esc` |
+| Action                     | Shortcut |
+| -------------------------- | -------- |
+| Cancel / Close / Interrupt | `Esc`    |
 
 ## Chat & Messages
 
-| Action | Shortcut |
-|--------|----------|
-| Send message | `Enter` |
-| New line in message | `Shift+Enter` |
-| Jump to bottom of chat | `Shift+G` |
+| Action                 | Shortcut      |
+| ---------------------- | ------------- |
+| Send message           | `Enter`       |
+| New line in message    | `Shift+Enter` |
+| Jump to bottom of chat | `Shift+G`     |
 
 ## Workspaces
 
-| Action | Shortcut |
-|--------|----------|
+| Action               | Shortcut |
+| -------------------- | -------- |
 | Create new workspace | `Ctrl+N` |
-| Next workspace | `Ctrl+J` |
-| Previous workspace | `Ctrl+K` |
+| Next workspace       | `Ctrl+J` |
+| Previous workspace   | `Ctrl+K` |
 
 ## Modes
 
-| Action | Shortcut |
-|--------|----------|
+| Action                             | Shortcut       |
+| ---------------------------------- | -------------- |
 | Toggle between Plan and Exec modes | `Ctrl+Shift+M` |
 
 ## Tips

docs/theme/custom.css

@@ -5,20 +5,20 @@
   --bg-primary: #1e1e1e;
   --bg-secondary: #262626;
   --bg-tertiary: #333333;
-  
+
   --text-primary: #d4d4d4;
   --text-secondary: #6b6b6b;
   --text-muted: #404040;
-  
+
   --accent-blue: #3b7fb5;
   --accent-green: #4a8a5f;
   --accent-yellow: #f59e0b;
   --accent-red: #b54040;
-  
+
   --border-color: #404040;
   --link-color: #4a9eff;
   --link-hover: #6bb0ff;
-  
+
   /* Override mdbook's default variables */
   --bg: var(--bg-primary) !important;
   --table-alternate-bg: var(--bg-secondary) !important; /* Fix blue alternate row background */
@@ -121,7 +121,7 @@ table tbody tr:hover {
 table code {
   background-color: var(--bg-primary) !important;
   color: var(--accent-yellow) !important;
-  font-family: 'Monaco', 'Menlo', 'Courier New', monospace;
+  font-family: "Monaco", "Menlo", "Courier New", monospace;
   font-size: 0.9em;
 }
 
@@ -139,7 +139,12 @@ blockquote strong {
 }
 
 /* Headers */
-h1, h2, h3, h4, h5, h6 {
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
   color: var(--text-primary) !important;
   border-bottom-color: var(--border-color) !important;
 }

src/constants/ipc-constants.ts

@@ -25,6 +25,7 @@ export const IPC_CHANNELS = {
   WORKSPACE_TRUNCATE_HISTORY: "workspace:truncateHistory",
   WORKSPACE_STREAM_HISTORY: "workspace:streamHistory",
   WORKSPACE_GET_INFO: "workspace:getInfo",
+  WORKSPACE_EXECUTE_BASH: "workspace:executeBash",
 
   // Dynamic channel prefixes
   WORKSPACE_CHAT_PREFIX: "workspace:chat:",

src/preload.ts

@@ -49,6 +49,8 @@ const api: IPCApi = {
     truncateHistory: (workspaceId, percentage) =>
       ipcRenderer.invoke(IPC_CHANNELS.WORKSPACE_TRUNCATE_HISTORY, workspaceId, percentage),
     getInfo: (workspaceId) => ipcRenderer.invoke(IPC_CHANNELS.WORKSPACE_GET_INFO, workspaceId),
+    executeBash: (workspaceId, script, options) =>
+      ipcRenderer.invoke(IPC_CHANNELS.WORKSPACE_EXECUTE_BASH, workspaceId, script, options),
 
     onChat: (workspaceId, callback) => {
       const channel = getChatChannel(workspaceId);

src/services/ipcMain.ts

@@ -22,6 +22,8 @@ import type { SendMessageError } from "@/types/errors";
 import type { StreamErrorMessage, SendMessageOptions, DeleteMessage } from "@/types/ipc";
 import { Ok, Err } from "@/types/result";
 import { validateWorkspaceName } from "@/utils/validation/workspaceValidation";
+import { createBashTool } from "@/services/tools/bash";
+import type { BashToolResult } from "@/types/tools";
 
 const createUnknownSendMessageError = (raw: string): SendMessageError => ({
   type: "unknown",
@@ -536,6 +538,48 @@ export class IpcMain {
         return { success: true, data: undefined };
       }
     );
+
+    ipcMain.handle(
+      IPC_CHANNELS.WORKSPACE_EXECUTE_BASH,
+      async (
+        _event,
+        workspaceId: string,
+        script: string,
+        options?: { timeout_secs?: number; max_lines?: number; stdin?: string }
+      ) => {
+        try {
+          // Get workspace metadata to find workspacePath
+          const metadataResult = await this.aiService.getWorkspaceMetadata(workspaceId);
+          if (!metadataResult.success) {
+            return Err(`Failed to get workspace metadata: ${metadataResult.error}`);
+          }
+
+          const workspacePath = metadataResult.data.workspacePath;
+
+          // Create bash tool with workspace's cwd
+          const bashTool = createBashTool({ cwd: workspacePath });
+
+          // Execute the script with provided options
+          const result = (await bashTool.execute!(
+            {
+              script,
+              timeout_secs: options?.timeout_secs ?? 120,
+              max_lines: options?.max_lines ?? 1000,
+              stdin: options?.stdin,
+            },
+            {
+              toolCallId: `bash-${Date.now()}`,
+              messages: [],
+            }
+          )) as BashToolResult;
+
+          return Ok(result);
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          return Err(`Failed to execute bash command: ${message}`);
+        }
+      }
+    );
   }
 
   private registerProviderHandlers(ipcMain: ElectronIpcMain): void {

src/types/ipc.ts

@@ -5,6 +5,7 @@ import type { ProjectConfig } from "@/config";
 import type { SendMessageError, StreamErrorType } from "./errors";
 import type { ThinkingLevel } from "./thinking";
 import type { ToolPolicy } from "@/utils/tools/toolPolicy";
+import type { BashToolResult } from "./tools";
 import type {
   StreamStartEvent,
   StreamDeltaEvent,
@@ -167,6 +168,11 @@ export interface IPCApi {
     ): Promise<Result<void, SendMessageError>>;
     truncateHistory(workspaceId: string, percentage?: number): Promise<Result<void, string>>;
     getInfo(workspaceId: string): Promise<WorkspaceMetadata | null>;
+    executeBash(
+      workspaceId: string,
+      script: string,
+      options?: { timeout_secs?: number; max_lines?: number; stdin?: string }
+    ): Promise<Result<BashToolResult, string>>;
 
     // Event subscriptions (renderer-only)
     // These methods are designed to send current state immediately upon subscription,