@enruana/claude-orka 0.4.4 → 0.4.6

package/.tmux.orka.conf

@@ -0,0 +1,127 @@
+# Claude-Orka Custom tmux Theme
+# This configuration is automatically applied to all Claude-Orka sessions
+
+# ============================================
+# GENERAL SETTINGS
+# ============================================
+
+# Enable mouse support for easier pane navigation
+set -g mouse on
+
+# Start windows and panes at 1 (not 0)
+set -g base-index 1
+setw -g pane-base-index 1
+
+# Increase scrollback buffer
+set -g history-limit 10000
+
+# Reduce escape time (better for vim users)
+set -sg escape-time 0
+
+# Enable focus events
+set -g focus-events on
+
+# Enable 256 colors
+set -g default-terminal "screen-256color"
+
+# ============================================
+# STATUS BAR THEME
+# ============================================
+
+# Status bar position
+set -g status-position top
+
+# Status bar update interval
+set -g status-interval 1
+
+# Status bar colors
+set -g status-style bg=colour234,fg=colour137
+
+# Status bar length
+set -g status-left-length 50
+set -g status-right-length 100
+
+# Left side: Session name with Orka branding
+set -g status-left '#[fg=colour232,bg=colour208,bold] 🎭 ORKA #[fg=colour208,bg=colour236,nobold] #[fg=colour208,bg=colour236] #S #[fg=colour236,bg=colour234,nobold] '
+
+# Right side: Project info and time
+set -g status-right '#[fg=colour236,bg=colour234]#[fg=colour137,bg=colour236] #{pane_current_path} #[fg=colour240,bg=colour236]#[fg=colour250,bg=colour240] %Y-%m-%d #[fg=colour245,bg=colour240]#[fg=colour232,bg=colour245,bold] %H:%M:%S '
+
+# Window status format
+setw -g window-status-format '#[fg=colour234,bg=colour236]#[fg=colour137,bg=colour236] #I:#W #[fg=colour236,bg=colour234]'
+
+# Current window status format (highlighted)
+setw -g window-status-current-format '#[fg=colour234,bg=colour208]#[fg=colour232,bg=colour208,bold] #I:#W #[fg=colour208,bg=colour234,nobold]'
+
+# Window with activity status
+setw -g window-status-activity-style fg=colour166,bg=colour236
+
+# ============================================
+# PANE BORDERS
+# ============================================
+
+# Pane border colors
+set -g pane-border-style fg=colour236
+set -g pane-active-border-style fg=colour208
+
+# Pane border format (show pane title)
+set -g pane-border-format '#[fg=colour208,bg=colour234] #{pane_index} #{pane_current_command} '
+set -g pane-border-status top
+
+# ============================================
+# MESSAGES & COMMAND PROMPT
+# ============================================
+
+# Command prompt style
+set -g message-style fg=colour232,bg=colour208,bold
+
+# Command prompt message style
+set -g message-command-style fg=colour232,bg=colour166
+
+# ============================================
+# CLOCK MODE
+# ============================================
+
+# Clock color (prefix + t)
+setw -g clock-mode-colour colour208
+
+# ============================================
+# WINDOW MODES
+# ============================================
+
+# Copy mode highlighting
+setw -g mode-style fg=colour232,bg=colour208
+
+# ============================================
+# KEY BINDINGS (Optional enhancements)
+# ============================================
+
+# Reload config easily (prefix + r)
+bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"
+
+# Better pane splitting (keep current directory)
+bind | split-window -h -c "#{pane_current_path}"
+bind - split-window -v -c "#{pane_current_path}"
+
+# Pane navigation with vim-like keys
+bind h select-pane -L
+bind j select-pane -D
+bind k select-pane -U
+bind l select-pane -R
+
+# Resize panes with vim-like keys
+bind -r H resize-pane -L 5
+bind -r J resize-pane -D 5
+bind -r K resize-pane -U 5
+bind -r L resize-pane -R 5
+
+# ============================================
+# VISUAL INDICATORS
+# ============================================
+
+# Bell/Activity
+set -g visual-activity off
+set -g visual-bell off
+set -g visual-silence off
+setw -g monitor-activity on
+set -g bell-action none

package/README.md

@@ -136,6 +136,41 @@ orka status
 - **Fork management** - Create, export, merge, and close forks visually
 - **Status indicators** - Visual distinction for active, saved, merged, and closed forks
 
+### 🎨 Custom tmux Theme
+
+- **Automatic branding** - Claude-Orka sessions get a custom orange theme
+- **Enhanced status bar** - Shows session name, project path, and current time
+- **Visual hierarchy** - Distinct colors for active/inactive panes and windows
+- **Mouse support** - Click to select panes and windows
+- **Vim-like navigation** - Optional h/j/k/l keys for pane movement
+- **Persistent configuration** - Theme automatically applied to all new sessions
+
+The custom theme makes it easy to distinguish Claude-Orka managed sessions from regular tmux sessions. The orange branding 🎭 appears in the status bar, with the session name and project information clearly visible.
+
+**Customization:**
+
+To modify the theme, edit `.tmux.orka.conf` in your Claude-Orka installation:
+
+```bash
+# Find your global installation
+npm root -g
+# Edit the config
+vim $(npm root -g)/@enruana/claude-orka/.tmux.orka.conf
+```
+
+Or create your own theme file and source it manually:
+```bash
+# After creating a session
+tmux source-file ~/.my-custom-theme.conf -t <session-name>
+```
+
+**Key Features of the Theme:**
+- **Orange highlights** (#208) for active windows and Orka branding
+- **Top status bar** with session info
+- **Pane borders** with titles showing current command
+- **Enhanced readability** with high contrast colors
+- **Powerline-style separators** for a modern look
+
 ---
 
 ## CLI Reference

package/dist/cli.js

@@ -3,12 +3,12 @@
 // src/cli/index.ts
 import { Command } from "commander";
 import { readFileSync } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname2, join } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { dirname as dirname3, join as join2 } from "path";
 
 // src/core/StateManager.ts
-import path3 from "path";
-import fs3 from "fs-extra";
+import path4 from "path";
+import fs4 from "fs-extra";
 
 // src/utils/tmux.ts
 import execa from "execa";
@@ -68,6 +68,11 @@ var Logger = class {
 var logger = new Logger();
 
 // src/utils/tmux.ts
+import * as path2 from "path";
+import * as fs2 from "fs";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path2.dirname(__filename);
 var TmuxError = class extends Error {
   constructor(message, command, originalError) {
     super(message);
@@ -96,6 +101,7 @@ var TmuxCommands = class {
       logger.debug(`Creating tmux session: ${name} at ${projectPath}`);
       await execa("tmux", ["new-session", "-d", "-s", name, "-c", projectPath]);
       logger.info(`Tmux session created: ${name}`);
+      await this.applyOrkaTheme(name);
     } catch (error) {
       throw new TmuxError(
         `Failed to create tmux session: ${name}`,
@@ -104,6 +110,37 @@ var TmuxCommands = class {
       );
     }
   }
+  /**
+   * Apply Claude-Orka custom tmux theme to a session
+   */
+  static async applyOrkaTheme(sessionName) {
+    try {
+      const possiblePaths = [
+        // When installed globally via npm
+        path2.join(__dirname, "../../.tmux.orka.conf"),
+        // When running from source
+        path2.join(process.cwd(), ".tmux.orka.conf"),
+        // Fallback: check in the module directory
+        path2.join(__dirname, "../../../.tmux.orka.conf")
+      ];
+      let configPath = null;
+      for (const p of possiblePaths) {
+        if (fs2.existsSync(p)) {
+          configPath = p;
+          break;
+        }
+      }
+      if (!configPath) {
+        logger.warn("Claude-Orka tmux config not found, skipping theme application");
+        return;
+      }
+      logger.debug(`Applying Orka theme from: ${configPath}`);
+      await execa("tmux", ["source-file", "-t", sessionName, configPath]);
+      logger.info("Claude-Orka theme applied successfully");
+    } catch (error) {
+      logger.warn("Failed to apply Orka theme, continuing with default tmux theme", error);
+    }
+  }
   /**
    * Abrir una terminal que se adjunte a una sesión tmux existente
    * (Solo macOS por ahora)
@@ -386,18 +423,18 @@ var TmuxCommands = class {
 };
 
 // src/utils/claude-history.ts
-import fs2 from "fs-extra";
+import fs3 from "fs-extra";
 import os from "os";
-import path2 from "path";
-var CLAUDE_HISTORY_PATH = path2.join(os.homedir(), ".claude", "history.jsonl");
+import path3 from "path";
+var CLAUDE_HISTORY_PATH = path3.join(os.homedir(), ".claude", "history.jsonl");
 async function readClaudeHistory() {
   try {
-    const exists = await fs2.pathExists(CLAUDE_HISTORY_PATH);
+    const exists = await fs3.pathExists(CLAUDE_HISTORY_PATH);
     if (!exists) {
       logger.warn(`Claude history file not found: ${CLAUDE_HISTORY_PATH}`);
       return [];
     }
-    const content = await fs2.readFile(CLAUDE_HISTORY_PATH, "utf-8");
+    const content = await fs3.readFile(CLAUDE_HISTORY_PATH, "utf-8");
     const lines = content.trim().split("\n").filter(Boolean);
     const entries = [];
     for (const line of lines) {
@@ -440,9 +477,9 @@ var StateManager = class {
   orkaDir;
   statePath;
   constructor(projectPath) {
-    this.projectPath = path3.resolve(projectPath);
-    this.orkaDir = path3.join(this.projectPath, ".claude-orka");
-    this.statePath = path3.join(this.orkaDir, "state.json");
+    this.projectPath = path4.resolve(projectPath);
+    this.orkaDir = path4.join(this.projectPath, ".claude-orka");
+    this.statePath = path4.join(this.orkaDir, "state.json");
   }
   /**
    * Initialize StateManager
@@ -451,7 +488,7 @@ var StateManager = class {
   async initialize() {
     logger.debug("Initializing StateManager");
     await this.ensureDirectories();
-    if (!await fs3.pathExists(this.statePath)) {
+    if (!await fs4.pathExists(this.statePath)) {
       logger.info("Creating initial state.json");
       const initialState = {
         version: "1.0.0",
@@ -467,7 +504,7 @@ var StateManager = class {
    * Create directory structure
    */
   async ensureDirectories() {
-    await fs3.ensureDir(this.orkaDir);
+    await fs4.ensureDir(this.orkaDir);
     logger.debug("Directories ensured");
   }
   /**
@@ -475,7 +512,7 @@ var StateManager = class {
    */
   async read() {
     try {
-      const content = await fs3.readFile(this.statePath, "utf-8");
+      const content = await fs4.readFile(this.statePath, "utf-8");
       return JSON.parse(content);
     } catch (error) {
       logger.error("Failed to read state:", error);
@@ -488,7 +525,7 @@ var StateManager = class {
   async save(state) {
     try {
       state.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
-      await fs3.writeFile(this.statePath, JSON.stringify(state, null, 2), "utf-8");
+      await fs4.writeFile(this.statePath, JSON.stringify(state, null, 2), "utf-8");
       logger.debug("State saved");
     } catch (error) {
       logger.error("Failed to save state:", error);
@@ -704,8 +741,8 @@ var StateManager = class {
    */
   async saveContext(type, id, content) {
     const contextPath = type === "session" ? this.getSessionContextPath(id) : this.getForkContextPath(id);
-    const fullPath = path3.join(this.projectPath, contextPath);
-    await fs3.writeFile(fullPath, content, "utf-8");
+    const fullPath = path4.join(this.projectPath, contextPath);
+    await fs4.writeFile(fullPath, content, "utf-8");
     logger.info(`Context saved: ${contextPath}`);
     return contextPath;
   }
@@ -713,11 +750,11 @@ var StateManager = class {
    * Leer un contexto desde archivo
    */
   async readContext(contextPath) {
-    const fullPath = path3.join(this.projectPath, contextPath);
-    if (!await fs3.pathExists(fullPath)) {
+    const fullPath = path4.join(this.projectPath, contextPath);
+    if (!await fs4.pathExists(fullPath)) {
       throw new Error(`Context file not found: ${contextPath}`);
     }
-    return await fs3.readFile(fullPath, "utf-8");
+    return await fs4.readFile(fullPath, "utf-8");
   }
   // --- HELPERS ---
   /**
@@ -742,15 +779,15 @@ var StateManager = class {
 
 // src/core/SessionManager.ts
 import { v4 as uuidv4 } from "uuid";
-import path4 from "path";
-import { fileURLToPath } from "url";
-import { dirname } from "path";
-import fs4 from "fs-extra";
+import path5 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname2 } from "path";
+import fs5 from "fs-extra";
 import { spawn } from "child_process";
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname2 = dirname2(__filename2);
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var SessionManager = class {
   stateManager;
@@ -1127,12 +1164,12 @@ var SessionManager = class {
       throw new Error(`Fork ${forkId} not found`);
     }
     logger.info(`Generating export for fork: ${fork.name}`);
-    const exportsDir = path4.join(this.projectPath, ".claude-orka", "exports");
-    await fs4.ensureDir(exportsDir);
+    const exportsDir = path5.join(this.projectPath, ".claude-orka", "exports");
+    await fs5.ensureDir(exportsDir);
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     const exportName = `fork-${fork.name}-${timestamp}.md`;
     const relativeExportPath = `.claude-orka/exports/${exportName}`;
-    const absoluteExportPath = path4.join(this.projectPath, relativeExportPath);
+    const absoluteExportPath = path5.join(this.projectPath, relativeExportPath);
     const prompt = `
 Please generate a complete summary of this fork conversation "${fork.name}" and save it to the file:
 \`${absoluteExportPath}\`
@@ -1208,17 +1245,17 @@ Write the summary in Markdown format and save it to the specified file.
       throw new Error(`Parent ${parentName} is not active. Cannot send merge command.`);
     }
     let contextPath = fork.contextPath;
-    let fullPath = path4.join(this.projectPath, contextPath);
-    let exists = await fs4.pathExists(fullPath);
+    let fullPath = path5.join(this.projectPath, contextPath);
+    let exists = await fs5.pathExists(fullPath);
     if (!exists) {
       logger.warn(`Export file not found: ${contextPath}. Looking for most recent export...`);
-      const exportsDir = path4.join(this.projectPath, ".claude-orka", "exports");
-      const files = await fs4.readdir(exportsDir);
+      const exportsDir = path5.join(this.projectPath, ".claude-orka", "exports");
+      const files = await fs5.readdir(exportsDir);
       const forkExports = files.filter((f) => f.startsWith(`fork-${fork.name}-`) && f.endsWith(".md")).sort().reverse();
       if (forkExports.length > 0) {
         contextPath = `.claude-orka/exports/${forkExports[0]}`;
-        fullPath = path4.join(this.projectPath, contextPath);
-        exists = await fs4.pathExists(fullPath);
+        fullPath = path5.join(this.projectPath, contextPath);
+        exists = await fs5.pathExists(fullPath);
         logger.info(`Using most recent export: ${contextPath}`);
       }
     }
@@ -1298,12 +1335,27 @@ Analyze the content and help me integrate the changes and learnings from the for
         logger.warn("Electron not available, skipping UI launch");
         return;
       }
-      let mainPath = path4.join(__dirname, "../../electron/main/main.js");
-      if (!fs4.existsSync(mainPath)) {
-        mainPath = path4.join(__dirname, "../../dist/electron/main/main.js");
+      const possiblePaths = [
+        // Production (installed globally): dist/core -> ../../dist/electron/main/main.js
+        path5.join(__dirname2, "../../dist/electron/main/main.js"),
+        // Development (running from dist): dist/core -> ../electron/main/main.js
+        path5.join(__dirname2, "../electron/main/main.js"),
+        // Development (running from src): src/core -> ../../dist/electron/main/main.js
+        path5.join(__dirname2, "../../dist/electron/main/main.js"),
+        // Fallback: check relative to package root
+        path5.join(__dirname2, "../../electron/main/main.js")
+      ];
+      let mainPath = null;
+      for (const p of possiblePaths) {
+        if (fs5.existsSync(p)) {
+          mainPath = p;
+          logger.debug(`Found Electron main.js at: ${p}`);
+          break;
+        }
       }
-      if (!fs4.existsSync(mainPath)) {
-        logger.warn(`Electron main.js not found at ${mainPath}, skipping UI launch`);
+      if (!mainPath) {
+        logger.warn(`Electron main.js not found. Tried paths: ${possiblePaths.join(", ")}`);
+        logger.warn("Skipping UI launch");
         return;
       }
       const electronProcess = spawn(
@@ -1810,8 +1862,8 @@ ${statusEmoji} ${chalk.bold(session.name)}`);
 
 // src/cli/utils/errors.ts
 import chalk2 from "chalk";
-import fs5 from "fs";
-import path5 from "path";
+import fs6 from "fs";
+import path6 from "path";
 var CLIError = class extends Error {
   constructor(message, exitCode = 1) {
     super(message);
@@ -1843,8 +1895,8 @@ function validateForkId(forkId) {
   }
 }
 function validateInitialized(projectPath) {
-  const orkaDir = path5.join(projectPath, ".claude-orka");
-  if (!fs5.existsSync(orkaDir)) {
+  const orkaDir = path6.join(projectPath, ".claude-orka");
+  if (!fs6.existsSync(orkaDir)) {
     throw new CLIError(
       'Project not initialized. Run "orka init" first.',
       2
@@ -2237,8 +2289,8 @@ function mergeCommand(program2) {
 
 // src/cli/commands/doctor.ts
 import execa2 from "execa";
-import fs6 from "fs-extra";
-import path6 from "path";
+import fs7 from "fs-extra";
+import path7 from "path";
 import chalk4 from "chalk";
 function doctorCommand(program2) {
   program2.command("doctor").description("Check system dependencies and configuration").action(async () => {
@@ -2249,6 +2301,7 @@ function doctorCommand(program2) {
       results.push(await checkNodeVersion());
       results.push(await checkTmux());
       results.push(await checkClaude());
+      results.push(await checkElectron());
       results.push(await checkProjectInit());
       results.push(await checkWritePermissions());
       results.push(await checkClaudeDir());
@@ -2327,13 +2380,33 @@ async function checkClaude() {
     };
   }
 }
+async function checkElectron() {
+  try {
+    const { stdout } = await execa2("electron", ["--version"]);
+    const version2 = stdout.trim();
+    return {
+      name: "Electron",
+      status: "pass",
+      message: version2.startsWith("v") ? version2 : `v${version2}`,
+      details: "Required for visual UI"
+    };
+  } catch (error) {
+    return {
+      name: "Electron",
+      status: "warn",
+      message: "Not found",
+      details: "Electron is required for the visual UI (optional)",
+      fix: "Install Electron: npm install -g electron"
+    };
+  }
+}
 async function checkProjectInit() {
   const projectPath = process.cwd();
-  const orkaDir = path6.join(projectPath, ".claude-orka");
-  const stateFile = path6.join(orkaDir, "state.json");
+  const orkaDir = path7.join(projectPath, ".claude-orka");
+  const stateFile = path7.join(orkaDir, "state.json");
   try {
-    const dirExists = await fs6.pathExists(orkaDir);
-    const stateExists = await fs6.pathExists(stateFile);
+    const dirExists = await fs7.pathExists(orkaDir);
+    const stateExists = await fs7.pathExists(stateFile);
     if (dirExists && stateExists) {
       return {
         name: "Project initialization",
@@ -2370,9 +2443,9 @@ async function checkProjectInit() {
 async function checkWritePermissions() {
   const projectPath = process.cwd();
   try {
-    const testFile = path6.join(projectPath, ".claude-orka-write-test");
-    await fs6.writeFile(testFile, "test");
-    await fs6.remove(testFile);
+    const testFile = path7.join(projectPath, ".claude-orka-write-test");
+    await fs7.writeFile(testFile, "test");
+    await fs7.remove(testFile);
     return {
       name: "Write permissions",
       status: "pass",
@@ -2391,11 +2464,11 @@ async function checkWritePermissions() {
 }
 async function checkClaudeDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-  const claudeDir = path6.join(homeDir, ".claude");
-  const historyFile = path6.join(claudeDir, "history.jsonl");
+  const claudeDir = path7.join(homeDir, ".claude");
+  const historyFile = path7.join(claudeDir, "history.jsonl");
   try {
-    const dirExists = await fs6.pathExists(claudeDir);
-    const historyExists = await fs6.pathExists(historyFile);
+    const dirExists = await fs7.pathExists(claudeDir);
+    const historyExists = await fs7.pathExists(historyFile);
     if (dirExists && historyExists) {
       return {
         name: "Claude directory",
@@ -2487,6 +2560,7 @@ function prepareCommand(program2) {
       console.log(chalk5.bold.cyan("\n\u{1F527} Claude-Orka Preparation\n"));
       console.log("This will help you install required dependencies:\n");
       console.log("  \u2022 tmux (terminal multiplexer)");
+      console.log("  \u2022 Electron (for visual UI)");
       console.log("  \u2022 Claude CLI (if needed)\n");
       if (!options.yes) {
         const rl = readline2.createInterface({
@@ -2506,6 +2580,7 @@ function prepareCommand(program2) {
       console.log(chalk5.gray(`
 Detected: ${system.platform}`));
       await installTmux(system);
+      await installElectron();
       await checkClaudeCLI();
       console.log(chalk5.bold.green("\n\u2713 Preparation complete!\n"));
       console.log("Run " + chalk5.cyan("orka doctor") + " to verify everything is working.");
@@ -2594,6 +2669,31 @@ Error: ${error.message}`));
     console.log(chalk5.cyan("  CentOS: sudo yum install tmux"));
   }
 }
+async function installElectron() {
+  console.log(chalk5.bold("\n\u26A1 Installing Electron...\n"));
+  try {
+    await execa3("electron", ["--version"]);
+    Output.success("Electron is already installed");
+    return;
+  } catch {
+  }
+  const spinner = ora4("Installing Electron globally...").start();
+  try {
+    await execa3("npm", ["install", "-g", "electron"], {
+      stdio: "ignore"
+    });
+    spinner.succeed("Electron installed globally");
+  } catch (error) {
+    spinner.fail("Failed to install Electron");
+    console.log(chalk5.red(`
+Error: ${error.message}`));
+    console.log(chalk5.yellow("\nPlease install Electron manually:"));
+    console.log(chalk5.cyan("  npm install -g electron"));
+    console.log(
+      chalk5.gray("\nNote: Electron is required for the visual UI interface.")
+    );
+  }
+}
 async function checkClaudeCLI() {
   console.log(chalk5.bold("\n\u{1F916} Checking Claude CLI...\n"));
   try {
@@ -2612,13 +2712,13 @@ async function checkClaudeCLI() {
 }
 
 // src/cli/index.ts
-var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = dirname2(__filename2);
-var packageJsonPath = join(__dirname2, "../package.json");
+var __filename3 = fileURLToPath3(import.meta.url);
+var __dirname3 = dirname3(__filename3);
+var packageJsonPath = join2(__dirname3, "../package.json");
 try {
   readFileSync(packageJsonPath, "utf-8");
 } catch {
-  packageJsonPath = join(__dirname2, "../../package.json");
+  packageJsonPath = join2(__dirname3, "../../package.json");
 }
 var packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 var version = packageJson.version;