@locusai/cli 0.7.0 → 0.7.3

package/bin/agent/worker.js

@@ -17065,7 +17065,15 @@ var colors = {
   brightBlue: `${ESC}94m`,
   brightMagenta: `${ESC}95m`,
   brightCyan: `${ESC}96m`,
-  brightWhite: `${ESC}97m`
+  brightWhite: `${ESC}97m`,
+  bgBlack: `${ESC}40m`,
+  bgRed: `${ESC}41m`,
+  bgGreen: `${ESC}42m`,
+  bgYellow: `${ESC}43m`,
+  bgBlue: `${ESC}44m`,
+  bgMagenta: `${ESC}45m`,
+  bgCyan: `${ESC}46m`,
+  bgWhite: `${ESC}47m`
 };
 var c = {
   text: (text, ...colorNames) => {
@@ -17081,11 +17089,17 @@ var c = {
   magenta: (t) => c.text(t, "magenta"),
   cyan: (t) => c.text(t, "cyan"),
   gray: (t) => c.text(t, "gray"),
+  white: (t) => c.text(t, "white"),
+  brightBlue: (t) => c.text(t, "brightBlue"),
+  bgBlue: (t) => c.text(t, "bgBlue", "white", "bold"),
   success: (t) => c.text(t, "green", "bold"),
   error: (t) => c.text(t, "red", "bold"),
   warning: (t) => c.text(t, "yellow", "bold"),
   info: (t) => c.text(t, "cyan", "bold"),
   primary: (t) => c.text(t, "blue", "bold"),
+  secondary: (t) => c.text(t, "magenta", "bold"),
+  header: (t) => c.text(` ${t} `, "bgBlue", "white", "bold"),
+  step: (t) => c.text(` ${t} `, "bgCyan", "black", "bold"),
   underline: (t) => c.text(t, "underline")
 };
 
@@ -17213,7 +17227,6 @@ class ClaudeRunner {
     if (type === "content_block_start" && content_block) {
       if (content_block.type === "tool_use" && content_block.name) {
         this.log?.(`
-
 ${c.primary("[Claude]")} ${c.bold(`Running ${content_block.name}...`)}
 `, "info");
       }
@@ -20814,6 +20827,13 @@ class AIModule extends BaseModule {
   async deleteSession(workspaceId, sessionId) {
     await this.api.delete(`/ai/${workspaceId}/session/${sessionId}`);
   }
+  async shareSession(workspaceId, sessionId, body) {
+    await this.api.post(`/ai/${workspaceId}/session/${sessionId}/share`, body);
+  }
+  async getSharedSession(sessionId) {
+    const { data } = await this.api.get(`/ai/shared/${sessionId}`);
+    return data;
+  }
 }
 
 // ../sdk/src/modules/auth.ts
@@ -34834,6 +34854,9 @@ var ChatResponseSchema = exports_external.object({
   sessionId: exports_external.string(),
   history: exports_external.array(AIMessageSchema).optional()
 });
+var ShareChatRequestSchema = exports_external.object({
+  isShared: exports_external.boolean()
+});
 // ../shared/src/models/user.ts
 var UserSchema = BaseEntitySchema.extend({
   email: exports_external.string().email(),
@@ -36110,13 +36133,10 @@ class CodebaseIndexer {
 `);
     const newTreeHash = this.hashTree(treeString);
     const existingIndex = this.loadIndex();
-    if (!force && existingIndex?.treeHash === newTreeHash) {
-      onProgress?.("No file changes detected, skipping reindex");
-      return null;
-    }
     const currentHashes = this.computeFileHashes(currentFiles);
     const existingHashes = existingIndex?.fileHashes;
-    const canIncremental = !force && existingIndex && existingHashes;
+    const hasExistingContent = existingIndex && (Object.keys(existingIndex.symbols).length > 0 || Object.keys(existingIndex.responsibilities).length > 0);
+    const canIncremental = !force && existingIndex && existingHashes && hasExistingContent;
     if (canIncremental) {
       onProgress?.("Performing incremental update");
       const { added, deleted, modified } = this.diffFiles(currentHashes, existingHashes);
@@ -36149,8 +36169,12 @@ class CodebaseIndexer {
       }
     }
     onProgress?.("AI is analyzing codebase structure...");
-    const index = await treeSummarizer(treeString);
-    return this.applyIndexMetadata(index, currentHashes, newTreeHash);
+    try {
+      const index = await treeSummarizer(treeString);
+      return this.applyIndexMetadata(index, currentHashes, newTreeHash);
+    } catch (error48) {
+      throw new Error(`AI analysis failed: ${error48 instanceof Error ? error48.message : String(error48)}`);
+    }
   }
   async getFileTree() {
     const gitmodulesPath = join4(this.projectPath, ".gitmodules");
@@ -36501,6 +36525,76 @@ ${comment.text}
 2. **Artifact Management**: If you create any high-level documentation (PRDs, technical drafts, architecture docs), you MUST save them in \`.locus/artifacts/\`. Do NOT create them in the root directory.
 3. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
 4. When finished successfully, output: <promise>COMPLETE</promise>
+`;
+    return prompt;
+  }
+  async buildGenericPrompt(query) {
+    let prompt = `# Direct Execution
+
+`;
+    prompt += `## Prompt
+${query}
+
+`;
+    const projectConfig = this.getProjectConfig();
+    if (projectConfig) {
+      prompt += `## Project Metadata
+`;
+      prompt += `- Version: ${projectConfig.version || "Unknown"}
+`;
+      prompt += `- Created At: ${projectConfig.createdAt || "Unknown"}
+
+`;
+    }
+    const contextPath = getLocusPath(this.projectPath, "contextFile");
+    let hasLocalContext = false;
+    if (existsSync4(contextPath)) {
+      try {
+        const context = readFileSync4(contextPath, "utf-8");
+        if (context.trim().length > 20) {
+          prompt += `## Project Context (Local)
+${context}
+
+`;
+          hasLocalContext = true;
+        }
+      } catch (err) {
+        console.warn(`Warning: Could not read context file: ${err}`);
+      }
+    }
+    if (!hasLocalContext) {
+      const fallback = this.getFallbackContext();
+      if (fallback) {
+        prompt += `## Project Context (README Fallback)
+${fallback}
+
+`;
+      }
+    }
+    prompt += this.getProjectStructure();
+    prompt += this.getSkillsInfo();
+    prompt += `## Project Knowledge Base
+`;
+    prompt += `You have access to the following documentation directories for context:
+`;
+    prompt += `- Artifacts: \`.locus/artifacts\`
+`;
+    prompt += `- Documents: \`.locus/documents\`
+`;
+    prompt += `If you need more information about the project strategies, plans, or architecture, please read files in these directories.
+
+`;
+    const indexPath = getLocusPath(this.projectPath, "indexFile");
+    if (existsSync4(indexPath)) {
+      prompt += `## Codebase Overview
+There is an index file in the .locus/codebase-index.json and if you need you can check it.
+
+`;
+    }
+    prompt += `## Instructions
+1. Execute the prompt based on the provided project context.
+2. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
+3. When finished successfully, output: <promise>COMPLETE</promise>
 `;
     return prompt;
   }
@@ -36642,16 +36736,12 @@ class TaskExecutor {
     });
     try {
       let plan = null;
-      if (this.deps.skipPlanning) {
-        this.deps.log("Skipping Phase 1: Planning (CLI)...", "info");
-      } else {
-        this.deps.log("Phase 1: Planning (CLI)...", "info");
-        const planningPrompt = `${basePrompt}
+      this.deps.log("Phase 1: Planning (CLI)...", "info");
+      const planningPrompt = `${basePrompt}
 
 ## Phase 1: Planning
 Analyze and create a detailed plan for THIS SPECIFIC TASK. Do NOT execute changes yet.`;
-        plan = await this.deps.aiRunner.run(planningPrompt, true);
-      }
+      plan = await this.deps.aiRunner.run(planningPrompt, true);
       this.deps.log("Starting Execution...", "info");
       let executionPrompt = basePrompt;
       if (plan != null) {
@@ -36740,7 +36830,6 @@ class AgentWorker {
     this.taskExecutor = new TaskExecutor({
       aiRunner: this.aiRunner,
       projectPath,
-      skipPlanning: config2.skipPlanning,
       log
     });
     const providerLabel = provider === "codex" ? "Codex" : "Claude";
@@ -36871,8 +36960,7 @@ if (process.argv[1]?.includes("agent-worker") || process.argv[1]?.includes("work
       if (value && !value.startsWith("--"))
         i++;
       config2.provider = resolveProvider(value);
-    } else if (arg === "--skip-planning")
-      config2.skipPlanning = true;
+    }
   }
   if (!config2.agentId || !config2.workspaceId || !config2.apiBase || !config2.apiKey || !config2.projectPath) {
     console.error("Missing required arguments");

package/bin/locus.js

@@ -30874,6 +30874,9 @@ var ChatResponseSchema = exports_external.object({
   sessionId: exports_external.string(),
   history: exports_external.array(AIMessageSchema).optional()
 });
+var ShareChatRequestSchema = exports_external.object({
+  isShared: exports_external.boolean()
+});
 // ../shared/src/models/user.ts
 var UserSchema = BaseEntitySchema.extend({
   email: exports_external.string().email(),
@@ -31961,13 +31964,10 @@ class CodebaseIndexer {
 `);
     const newTreeHash = this.hashTree(treeString);
     const existingIndex = this.loadIndex();
-    if (!force && existingIndex?.treeHash === newTreeHash) {
-      onProgress?.("No file changes detected, skipping reindex");
-      return null;
-    }
     const currentHashes = this.computeFileHashes(currentFiles);
     const existingHashes = existingIndex?.fileHashes;
-    const canIncremental = !force && existingIndex && existingHashes;
+    const hasExistingContent = existingIndex && (Object.keys(existingIndex.symbols).length > 0 || Object.keys(existingIndex.responsibilities).length > 0);
+    const canIncremental = !force && existingIndex && existingHashes && hasExistingContent;
     if (canIncremental) {
       onProgress?.("Performing incremental update");
       const { added, deleted, modified } = this.diffFiles(currentHashes, existingHashes);
@@ -32000,8 +32000,12 @@ class CodebaseIndexer {
       }
     }
     onProgress?.("AI is analyzing codebase structure...");
-    const index = await treeSummarizer(treeString);
-    return this.applyIndexMetadata(index, currentHashes, newTreeHash);
+    try {
+      const index = await treeSummarizer(treeString);
+      return this.applyIndexMetadata(index, currentHashes, newTreeHash);
+    } catch (error48) {
+      throw new Error(`AI analysis failed: ${error48 instanceof Error ? error48.message : String(error48)}`);
+    }
   }
   async getFileTree() {
     const gitmodulesPath = join3(this.projectPath, ".gitmodules");
@@ -32351,6 +32355,76 @@ ${comment.text}
 2. **Artifact Management**: If you create any high-level documentation (PRDs, technical drafts, architecture docs), you MUST save them in \`.locus/artifacts/\`. Do NOT create them in the root directory.
 3. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
 4. When finished successfully, output: <promise>COMPLETE</promise>
+`;
+    return prompt;
+  }
+  async buildGenericPrompt(query) {
+    let prompt = `# Direct Execution
+
+`;
+    prompt += `## Prompt
+${query}
+
+`;
+    const projectConfig = this.getProjectConfig();
+    if (projectConfig) {
+      prompt += `## Project Metadata
+`;
+      prompt += `- Version: ${projectConfig.version || "Unknown"}
+`;
+      prompt += `- Created At: ${projectConfig.createdAt || "Unknown"}
+
+`;
+    }
+    const contextPath = getLocusPath(this.projectPath, "contextFile");
+    let hasLocalContext = false;
+    if (existsSync3(contextPath)) {
+      try {
+        const context = readFileSync3(contextPath, "utf-8");
+        if (context.trim().length > 20) {
+          prompt += `## Project Context (Local)
+${context}
+
+`;
+          hasLocalContext = true;
+        }
+      } catch (err) {
+        console.warn(`Warning: Could not read context file: ${err}`);
+      }
+    }
+    if (!hasLocalContext) {
+      const fallback = this.getFallbackContext();
+      if (fallback) {
+        prompt += `## Project Context (README Fallback)
+${fallback}
+
+`;
+      }
+    }
+    prompt += this.getProjectStructure();
+    prompt += this.getSkillsInfo();
+    prompt += `## Project Knowledge Base
+`;
+    prompt += `You have access to the following documentation directories for context:
+`;
+    prompt += `- Artifacts: \`.locus/artifacts\`
+`;
+    prompt += `- Documents: \`.locus/documents\`
+`;
+    prompt += `If you need more information about the project strategies, plans, or architecture, please read files in these directories.
+
+`;
+    const indexPath = getLocusPath(this.projectPath, "indexFile");
+    if (existsSync3(indexPath)) {
+      prompt += `## Codebase Overview
+There is an index file in the .locus/codebase-index.json and if you need you can check it.
+
+`;
+    }
+    prompt += `## Instructions
+1. Execute the prompt based on the provided project context.
+2. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
+3. When finished successfully, output: <promise>COMPLETE</promise>
 `;
     return prompt;
   }
@@ -32492,16 +32566,12 @@ class TaskExecutor {
     });
     try {
       let plan = null;
-      if (this.deps.skipPlanning) {
-        this.deps.log("Skipping Phase 1: Planning (CLI)...", "info");
-      } else {
-        this.deps.log("Phase 1: Planning (CLI)...", "info");
-        const planningPrompt = `${basePrompt}
+      this.deps.log("Phase 1: Planning (CLI)...", "info");
+      const planningPrompt = `${basePrompt}
 
 ## Phase 1: Planning
 Analyze and create a detailed plan for THIS SPECIFIC TASK. Do NOT execute changes yet.`;
-        plan = await this.deps.aiRunner.run(planningPrompt, true);
-      }
+      plan = await this.deps.aiRunner.run(planningPrompt, true);
       this.deps.log("Starting Execution...", "info");
       let executionPrompt = basePrompt;
       if (plan != null) {
@@ -32559,7 +32629,15 @@ var colors = {
   brightBlue: `${ESC}94m`,
   brightMagenta: `${ESC}95m`,
   brightCyan: `${ESC}96m`,
-  brightWhite: `${ESC}97m`
+  brightWhite: `${ESC}97m`,
+  bgBlack: `${ESC}40m`,
+  bgRed: `${ESC}41m`,
+  bgGreen: `${ESC}42m`,
+  bgYellow: `${ESC}43m`,
+  bgBlue: `${ESC}44m`,
+  bgMagenta: `${ESC}45m`,
+  bgCyan: `${ESC}46m`,
+  bgWhite: `${ESC}47m`
 };
 var c = {
   text: (text, ...colorNames) => {
@@ -32575,11 +32653,17 @@ var c = {
   magenta: (t) => c.text(t, "magenta"),
   cyan: (t) => c.text(t, "cyan"),
   gray: (t) => c.text(t, "gray"),
+  white: (t) => c.text(t, "white"),
+  brightBlue: (t) => c.text(t, "brightBlue"),
+  bgBlue: (t) => c.text(t, "bgBlue", "white", "bold"),
   success: (t) => c.text(t, "green", "bold"),
   error: (t) => c.text(t, "red", "bold"),
   warning: (t) => c.text(t, "yellow", "bold"),
   info: (t) => c.text(t, "cyan", "bold"),
   primary: (t) => c.text(t, "blue", "bold"),
+  secondary: (t) => c.text(t, "magenta", "bold"),
+  header: (t) => c.text(` ${t} `, "bgBlue", "white", "bold"),
+  step: (t) => c.text(` ${t} `, "bgCyan", "black", "bold"),
   underline: (t) => c.text(t, "underline")
 };
 
@@ -32707,7 +32791,6 @@ class ClaudeRunner {
     if (type === "content_block_start" && content_block) {
       if (content_block.type === "tool_use" && content_block.name) {
         this.log?.(`
-
 ${c.primary("[Claude]")} ${c.bold(`Running ${content_block.name}...`)}
 `, "info");
       }
@@ -36308,6 +36391,13 @@ class AIModule extends BaseModule {
   async deleteSession(workspaceId, sessionId) {
     await this.api.delete(`/ai/${workspaceId}/session/${sessionId}`);
   }
+  async shareSession(workspaceId, sessionId, body) {
+    await this.api.post(`/ai/${workspaceId}/session/${sessionId}/share`, body);
+  }
+  async getSharedSession(sessionId) {
+    const { data } = await this.api.get(`/ai/shared/${sessionId}`);
+    return data;
+  }
 }
 
 // ../sdk/src/modules/auth.ts
@@ -36746,7 +36836,6 @@ class AgentWorker {
     this.taskExecutor = new TaskExecutor({
       aiRunner: this.aiRunner,
       projectPath,
-      skipPlanning: config2.skipPlanning,
       log
     });
     const providerLabel = provider === "codex" ? "Codex" : "Claude";
@@ -36877,8 +36966,7 @@ if (process.argv[1]?.includes("agent-worker") || process.argv[1]?.includes("work
       if (value && !value.startsWith("--"))
         i++;
       config2.provider = resolveProvider(value);
-    } else if (arg === "--skip-planning")
-      config2.skipPlanning = true;
+    }
   }
   if (!config2.agentId || !config2.workspaceId || !config2.apiBase || !config2.apiKey || !config2.projectPath) {
     console.error("Missing required arguments");
@@ -37012,9 +37100,6 @@ ${c.success("✅ Orchestrator finished")}`);
     if (this.config.provider) {
       workerArgs.push("--provider", this.config.provider);
     }
-    if (this.config.skipPlanning) {
-      workerArgs.push("--skip-planning");
-    }
     if (this.resolvedSprintId) {
       workerArgs.push("--sprint-id", this.resolvedSprintId);
     }
@@ -37613,12 +37698,12 @@ function getVersion() {
 var VERSION2 = getVersion();
 function printBanner() {
   console.log(c.primary(`
-  ##       ######   ######  ##    ##  ###### 
-  ##      ##    ## ##       ##    ## ##       
-  ##      ##    ## ##       ##    ## ######   
-  ##      ##    ## ##       ##    ##      ## 
-  #######  ######   ######   ######  ######   v${VERSION2}
-`));
+ _      ____   ____ _   _  ____ 
+| |    / __ \\ / ___| | | |/ ___|
+| |   | |  | | |   | | | |\\___ \\ 
+| |___| |__| | |___| |_| |___) |
+|_____|\\____/ \\____|\\___/|____/  ${c.dim(`v${VERSION2}`)}
+    `));
 }
 function isProjectInitialized(projectPath) {
   const locusDir = join8(projectPath, LOCUS_CONFIG.dir);
@@ -37628,14 +37713,14 @@ function isProjectInitialized(projectPath) {
 function requireInitialization(projectPath, command) {
   if (!isProjectInitialized(projectPath)) {
     console.error(`
-${c.error("❌ Error: Locus is not initialized in this directory.")}
+  ${c.error("✖ Error")} ${c.red(`Locus is not initialized in this directory.`)}
 
-The '${c.bold(command)}' command requires a Locus project to be initialized.
+  The '${c.bold(command)}' command requires a Locus project to be initialized.
 
-To initialize Locus in this directory, run:
-  ${c.primary("locus init")}
+  To initialize Locus in this directory, run:
+    ${c.primary("locus init")}
 
-This will create a .locus directory with the necessary configuration.
+  This will create a ${c.dim(".locus")} directory with the necessary configuration.
 `);
     process.exit(1);
   }
@@ -37696,12 +37781,11 @@ async function runCommand(args) {
     apiBase,
     maxIterations: 100,
     projectPath,
-    apiKey,
-    skipPlanning: Boolean(values["skip-planning"])
+    apiKey
   });
-  orchestrator.on("task:assigned", (data) => console.log(`ℹ [CLAIMED] ${data.title}`));
-  orchestrator.on("task:completed", (data) => console.log(`✓ [COMPLETED] ${data.taskId}`));
-  orchestrator.on("task:failed", (data) => console.log(`✗ [FAILED] ${data.taskId}: ${data.error}`));
+  orchestrator.on("task:assigned", (data) => console.log(`  ${c.info("●")} ${c.bold("Claimed:")} ${data.title}`));
+  orchestrator.on("task:completed", (data) => console.log(`  ${c.success("✔")} ${c.success("Completed:")} ${c.dim(data.taskId)}`));
+  orchestrator.on("task:failed", (data) => console.log(`  ${c.error("✖")} ${c.error("Failed:")} ${c.bold(data.taskId)}: ${data.error}`));
   const handleSignal = async (signal) => {
     console.log(`
 ${c.info(`Received ${signal}. Stopping agents...`)}`);
@@ -37710,7 +37794,8 @@ ${c.info(`Received ${signal}. Stopping agents...`)}`);
   };
   process.on("SIGINT", () => handleSignal("SIGINT"));
   process.on("SIGTERM", () => handleSignal("SIGTERM"));
-  console.log(`${c.primary("\uD83D\uDE80 Starting agent in")} ${c.bold(projectPath)}...`);
+  console.log(`
+  ${c.primary("\uD83D\uDE80")} ${c.bold("Starting Locus agent in")} ${c.primary(projectPath)}...`);
   await orchestrator.start();
 }
 async function indexCommand(args) {
@@ -37734,12 +37819,63 @@ async function indexCommand(args) {
   });
   const summarizer = new TreeSummarizer(aiRunner);
   const indexer = new CodebaseIndexer(projectPath);
-  console.log(`${c.primary("\uD83D\uDD0D Indexing codebase in")} ${c.bold(projectPath)}...`);
-  const index = await indexer.index((msg) => console.log(`  ${c.dim(msg)}`), (tree) => summarizer.summarize(tree));
-  if (index) {
-    indexer.saveIndex(index);
+  console.log(`
+  ${c.step(" INDEX ")} ${c.primary("Analyzing codebase in")} ${c.bold(projectPath)}...`);
+  try {
+    const index = await indexer.index((msg) => console.log(`  ${c.dim(msg)}`), (tree) => summarizer.summarize(tree));
+    if (index) {
+      indexer.saveIndex(index);
+    }
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.error("Indexing failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}`);
+    console.error(c.dim(`  The agent might have limited context until indexing succeeds.
+`));
+  }
+  console.log(`
+  ${c.success("✔")} ${c.success("Indexing complete!")}
+`);
+}
+async function execCommand(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      model: { type: "string" },
+      provider: { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false
+  });
+  const promptInput = positionals.join(" ");
+  if (!promptInput) {
+    console.error(c.error('Error: Prompt is required. Usage: locus exec "your prompt"'));
+    process.exit(1);
+  }
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "exec");
+  const provider = resolveProvider2(values.provider);
+  const model = values.model || DEFAULT_MODEL[provider];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model
+  });
+  const builder = new PromptBuilder(projectPath);
+  const fullPrompt = await builder.buildGenericPrompt(promptInput);
+  console.log(`
+  ${c.primary("\uD83D\uDE80")} ${c.bold("Executing prompt with repository context...")}
+`);
+  try {
+    const result = await aiRunner.run(fullPrompt);
+    console.log(result);
+    console.log(`
+  ${c.success("✔")} ${c.success("Execution finished!")}
+`);
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.error("Execution failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    process.exit(1);
   }
-  console.log(c.success("✅ Indexing complete!"));
 }
 async function initCommand() {
   const projectPath = process.cwd();
@@ -37755,19 +37891,19 @@ If you want to reinitialize, please remove the .locus directory first.
   }
   await new ConfigManager(projectPath).init(VERSION2);
   console.log(`
-${c.success("✨ Locus initialized successfully!")}
+  ${c.success("✨ Locus initialized successfully!")}
 
-Created:
-  \uD83D\uDCC1 ${c.dim(".locus/")}                  - Locus configuration directory
-  \uD83D\uDCC4 ${c.dim(".locus/config.json")}      - Project configuration
-  \uD83D\uDCDD ${c.dim("CLAUDE.md")}               - AI context file
-  \uD83D\uDCC1 ${c.dim(".agent/skills/")}          - Agent skills (Frontend, Backend, DevOps, etc.)
+  ${c.bold("Created:")}
+    ${c.primary("\uD83D\uDCC1")} ${c.bold(".locus/")}             ${c.dim("Configuration directory")}
+    ${c.primary("\uD83D\uDCC4")} ${c.bold(".locus/config.json")} ${c.dim("Project settings")}
+    ${c.primary("\uD83D\uDCDD")} ${c.bold("CLAUDE.md")}          ${c.dim("AI instructions & context")}
+    ${c.primary("\uD83D\uDCC1")} ${c.bold(".agent/skills/")}     ${c.dim("Domain-specific agent skills")}
 
-Next steps:
-  1. Run '${c.primary("locus index")}' to index your codebase
-  2. Run '${c.primary("locus run")}' to start an agent (requires --api-key)
+  ${c.bold("Next steps:")}
+    1. Run '${c.primary("locus index")}' to index your codebase
+    2. Run '${c.primary("locus run")}' to start an agent (requires --api-key)
 
-For more information, visit: ${c.underline("https://locusai.dev/docs")}
+  For more information, visit: ${c.underline("https://locusai.dev/docs")}
 `);
 }
 async function main() {
@@ -37784,30 +37920,35 @@ async function main() {
     case "init":
       await initCommand();
       break;
+    case "exec":
+      await execCommand(args);
+      break;
     default:
       console.log(`
-Usage: locus <command>
+  ${c.header(" USAGE ")}
+    ${c.primary("locus")} ${c.dim("<command> [options]")}
 
-Commands:
-  init     Initialize Locus in the current directory
-  index    Index the codebase for AI context
-  run      Start an agent to work on tasks
+  ${c.header(" COMMANDS ")}
+    ${c.success("init")}      Initialize Locus in the current directory
+    ${c.success("index")}     Index the codebase for AI context
+    ${c.success("run")}       Start an agent to work on tasks
+    ${c.success("exec")}      Run a prompt with repository context
 
-Options:
-  --help   Show this help message
-  --provider <name>  AI provider: claude or codex (default: claude)
-  --skip-planning    Skip the planning phase (CLI planning)
+  ${c.header(" OPTIONS ")}
+    ${c.secondary("--help")}           Show this help message
+    ${c.secondary("--provider")} <name>  AI provider: ${c.dim("claude")} or ${c.dim("codex")} (default: ${c.dim("claude")})
 
-Examples:
-  locus init
-  locus index
-  locus run --api-key YOUR_KEY
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus init")}
+    ${c.dim("$")} ${c.primary("locus index")}
+    ${c.dim("$")} ${c.primary("locus run --api-key YOUR_KEY")}
 
-For more information, visit: https://locusai.dev/docs
+  For more information, visit: ${c.underline("https://locusai.dev/docs")}
 `);
   }
 }
 main().catch((err) => {
-  console.error(`Fatal error: ${err.message}`);
+  console.error(`
+  ${c.error("✖ Fatal Error")} ${c.red(err.message)}`);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "description": "CLI for Locus - AI-native project management platform",
   "type": "module",
   "bin": {
@@ -32,7 +32,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@locusai/sdk": "^0.7.0"
+    "@locusai/sdk": "^0.7.3"
   },
   "devDependencies": {}
 }