@axplusb/kepler 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axplusb/kepler",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Kepler — AI coding agent CLI. 30.7% on SWE-bench Lite. Powered by axplusb.tech",
   "type": "module",
   "bin": {

package/src/auth/tarang-auth.mjs

@@ -1,6 +1,6 @@
 /**
- * Orca Authentication — GitHub OAuth + config management.
- * Reads/writes ~/.orca/config.json (shared with Python CLI).
+ * Kepler Authentication — GitHub OAuth + config management.
+ * Reads/writes ~/.kepler/config.json.
  */
 
 import * as fs from 'node:fs';
@@ -10,7 +10,7 @@ import * as http from 'node:http';
 import { getLoginSuccessHTML } from '../ui/banner.mjs';
 import { resolveBackendUrl } from '../core/backend-url.mjs';
 
-const CONFIG_DIR = path.join(os.homedir(), '.orca');
+const CONFIG_DIR = process.env.KEPLER_HOME || process.env.ORCA_HOME || path.join(os.homedir(), '.kepler');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 
 export class TarangAuth {
@@ -18,7 +18,7 @@ export class TarangAuth {
         this._config = null;
     }
 
-    /** Ensure ~/.orca/ directory exists with secure permissions. */
+    /** Ensure ~/.kepler/ directory exists with secure permissions. */
     _ensureConfigDir() {
         if (!fs.existsSync(CONFIG_DIR)) {
             fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
@@ -134,7 +134,7 @@ export class TarangAuth {
     async syncSettings() {
         const { fetchRemoteSettings, mergeRemoteSettings } = await import('../core/settings-sync.mjs');
         const creds = this.loadCredentials();
-        if (!creds.token) throw new Error('Not logged in. Run `orca login` first.');
+        if (!creds.token) throw new Error('Not logged in. Run `kepler login` first.');
 
         const remote = await fetchRemoteSettings(creds.token);
         if (!remote) throw new Error('Failed to fetch settings from server.');
@@ -162,7 +162,7 @@ export class TarangAuth {
 
         const env = process.env.TARANG_ENV || process.env.NODE_ENV || 'production';
 
-        process.stderr.write(`\n${BOLD}Orca Configuration${RESET}\n`);
+        process.stderr.write(`\n${BOLD}Kepler Configuration${RESET}\n`);
         process.stderr.write(`${'─'.repeat(50)}\n`);
         process.stderr.write(`  Auth:           ${creds.token ? `${check} logged in` : `${cross} not logged in ${DIM}(/login)${RESET}`}\n`);
         process.stderr.write(`  Environment:    ${DIM}${env}${RESET}\n`);
@@ -188,8 +188,8 @@ export class TarangAuth {
             process.stderr.write(`  Last synced:    ${DIM}${new Date(raw.last_synced_at).toLocaleString()}${RESET}\n`);
         }
 
-        process.stderr.write(`\n  ${DIM}Run ${RESET}${CYAN}orca sync${RESET}${DIM} to sync settings from web.${RESET}\n`);
-        process.stderr.write(`  ${DIM}Run ${RESET}${CYAN}orca configure${RESET}${DIM} to open settings in browser.${RESET}\n`);
+        process.stderr.write(`\n  ${DIM}Run ${RESET}${CYAN}kepler sync${RESET}${DIM} to sync settings from web.${RESET}\n`);
+        process.stderr.write(`  ${DIM}Run ${RESET}${CYAN}kepler configure${RESET}${DIM} to open settings in browser.${RESET}\n`);
         process.stderr.write('\n');
     }
 
@@ -202,7 +202,7 @@ export class TarangAuth {
      *   3. Web checks Supabase session (if none → GitHub OAuth → Supabase)
      *   4. Web generates CLI token via /api/cli/token
      *   5. Web redirects browser to CLI callback with token
-     *   6. CLI receives token, saves to ~/.orca/config.json
+     *   6. CLI receives token, saves to ~/.kepler/config.json
      */
     async login() {
         const { resolveWebUrl } = await import('../core/backend-url.mjs');

package/src/config/env.mjs

@@ -27,8 +27,8 @@ export const ENV_SCHEMA = {
     CLAUDE_CODE_BRIEF: { type: 'boolean', default: false, description: 'Brief output mode' },
     CLAUDE_CODE_DISABLE_CRON: { type: 'boolean', default: false, description: 'Disable cron tasks' },
     CLAUDE_CODE_ENABLE_TASKS: { type: 'boolean', default: false, description: 'Enable task system' },
-    ORCA_STAGNATION_DETECTION: { type: 'boolean', default: false, description: 'Detect consecutive identical tool-call loops' },
-    ORCA_STAGNATION_THRESHOLD: { type: 'number', default: 3, description: 'Consecutive identical calls before warning' },
+    KEPLER_STAGNATION_DETECTION: { type: 'boolean', default: false, description: 'Detect consecutive identical tool-call loops' },
+    KEPLER_STAGNATION_THRESHOLD: { type: 'number', default: 3, description: 'Consecutive identical calls before warning' },
     CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: { type: 'boolean', default: false, description: 'Enable agent teams' },
     CLAUDE_CODE_DEBUG: { type: 'boolean', default: false, description: 'Debug mode' },
     CLAUDE_CODE_DISABLE_TELEMETRY: { type: 'boolean', default: false, description: 'Disable telemetry' },

package/src/config/settings.mjs

@@ -118,13 +118,13 @@ function applyEnvOverrides(settings) {
     if (process.env.CLAUDE_CODE_THINKING === '1') settings.alwaysThinkingEnabled = true;
     if (process.env.CLAUDE_CODE_DISABLE_CRON === '1') settings.cronEnabled = false;
     if (process.env.CLAUDE_CODE_ENABLE_TASKS === '1') settings.enableTeams = true;
-    const stagnationEnabled = process.env.ORCA_STAGNATION_DETECTION;
+    const stagnationEnabled = process.env.KEPLER_STAGNATION_DETECTION;
     if (stagnationEnabled !== undefined) {
         settings.stagnationDetection = ['1', 'true', 'yes', 'on'].includes(
             stagnationEnabled.toLowerCase(),
         );
     }
-    const stagnationThreshold = process.env.ORCA_STAGNATION_THRESHOLD;
+    const stagnationThreshold = process.env.KEPLER_STAGNATION_THRESHOLD;
     if (stagnationThreshold) {
         const n = parseInt(stagnationThreshold, 10);
         if (Number.isInteger(n) && n >= 2) settings.stagnationThreshold = n;

package/src/core/checkpoints.mjs

@@ -3,7 +3,7 @@
  *
  * Before any file edit, a checkpoint is created containing the
  * original file content. The /undo command restores the last checkpoint.
- * Checkpoints are stored in ~/.orca/projects/{hash}/checkpoints/
+ * Checkpoints are stored in ~/.kepler/projects/{hash}/checkpoints/
  */
 
 import fs from 'fs';

package/src/core/headless.mjs

@@ -6,9 +6,9 @@
  * stderr gets minimal progress (optional with --verbose).
  *
  * Usage:
- *   orca --headless "Fix the bug in auth.py"
- *   orca --headless --timeout 300 --max-cost 2.00 "Refactor the login flow"
- *   orca --headless --model deepseek/deepseek-chat-v3-0324 "Add tests"
+ *   kepler --headless "Fix the bug in auth.py"
+ *   kepler --headless --timeout 300 --max-cost 2.00 "Refactor the login flow"
+ *   kepler --headless --model deepseek/deepseek-chat-v3-0324 "Add tests"
  */
 
 import { TarangStreamClient } from './stream-client.mjs';
@@ -42,7 +42,7 @@ export async function runHeadless({ instruction, model, timeout = 300, maxCost,
     const auth = new TarangAuth();
     const creds = auth.loadCredentials();
     if (!creds.token) {
-        emit({ type: 'error', error: 'Not logged in. Run: orca login' });
+        emit({ type: 'error', error: 'Not logged in. Run: kepler login' });
         process.exit(1);
     }
 

package/src/core/jsonl-writer.mjs

@@ -1,5 +1,5 @@
 /**
- * JSONL Writer — writes cc-lens compatible session transcripts to ~/.orca/.
+ * JSONL Writer — writes cc-lens compatible session transcripts to ~/.kepler/.
  *
  * Format mirrors Claude Code's ~/.claude/ JSONL structure so that
  * cc-lens (CLAUDE_CONFIG_DIR=~/.orca npx cc-lens) can read Orca sessions.
@@ -17,13 +17,13 @@ import * as os from 'node:os';
 import { randomUUID } from 'node:crypto';
 import * as childProcessModule from 'node:child_process';
 
-const ORCA_DIR = process.env.ORCA_HOME || path.join(os.homedir(), '.orca');
+const KEPLER_DIR = process.env.KEPLER_HOME || path.join(os.homedir(), '.kepler');
 const FLUSH_INTERVAL_MS = 500;
 
 /**
  * Sanitize a cwd path into a project slug for the directory name.
  * /Users/sree/Sites/myproject → -Users-sree-Sites-myproject
- * Mirrors the Claude Code / orca-cli convention.
+ * Mirrors the Claude Code / kepler-cli convention.
  */
 function sanitizePath(p) {
   return p.replace(/\//g, '-').replace(/^-/, '-');
@@ -50,7 +50,7 @@ export class JsonlWriter {
     this.version = version;
     this.sessionId = null; // set by setSessionId() when backend assigns it
     this.slug = sanitizePath(cwd);
-    this.projectDir = path.join(ORCA_DIR, 'projects', this.slug);
+    this.projectDir = path.join(KEPLER_DIR, 'projects', this.slug);
 
     // UUID chain for parent linking (cc-lens replay)
     this.lastUuid = null;
@@ -238,7 +238,7 @@ export class JsonlWriter {
   }
 
   /**
-   * Write a prompt entry to ~/.orca/history.jsonl.
+   * Write a prompt entry to ~/.kepler/history.jsonl.
    */
   writeHistory(prompt) {
     const entry = {
@@ -248,7 +248,7 @@ export class JsonlWriter {
       project: this.cwd,
       sessionId: this.sessionId,
     };
-    const historyPath = path.join(ORCA_DIR, 'history.jsonl');
+    const historyPath = path.join(KEPLER_DIR, 'history.jsonl');
     fs.promises.appendFile(historyPath, JSON.stringify(entry) + '\n', { mode: 0o600 })
       .catch(() => {}); // best effort
   }
@@ -327,7 +327,7 @@ export class JsonlWriter {
       fs.mkdirSync(this.projectDir, { recursive: true, mode: 0o700 });
     } catch { /* ignore */ }
     try {
-      fs.mkdirSync(path.join(ORCA_DIR, 'projects'), { recursive: true, mode: 0o700 });
+      fs.mkdirSync(path.join(KEPLER_DIR, 'projects'), { recursive: true, mode: 0o700 });
     } catch { /* ignore */ }
   }
 

package/src/core/local-agent.mjs

@@ -402,7 +402,7 @@ export class LocalAgent {
         }
 
         const parts = [
-            'You are Orca, an AI coding agent running in local mode.',
+            'You are Kepler, an AI coding agent running in local mode.',
             'You have access to tools for reading, writing, and executing code.',
             'Use tools to accomplish the user\'s request. Be concise and direct.',
         ];

package/src/core/local-store.mjs

@@ -1,5 +1,5 @@
 /**
- * Local Store Reader — scans ~/.orca/ JSONL files for historical stats.
+ * Local Store Reader — scans ~/.kepler/ JSONL files for historical stats.
  *
  * Provides read helpers for CLI commands (/stats, /history, /tokens, /tools, /sessions).
  * All data comes from local JSONL files — no cloud dependency.
@@ -10,8 +10,8 @@ import * as path from 'node:path';
 import * as os from 'node:os';
 import * as readline from 'node:readline';
 
-const ORCA_DIR = process.env.ORCA_HOME || path.join(os.homedir(), '.orca');
-const PROJECTS_DIR = path.join(ORCA_DIR, 'projects');
+const KEPLER_DIR = process.env.KEPLER_HOME || path.join(os.homedir(), '.kepler');
+const PROJECTS_DIR = path.join(KEPLER_DIR, 'projects');
 
 function normalizeBlock(block) {
   if (!block || typeof block !== 'object') {
@@ -302,7 +302,7 @@ export async function getModelBreakdown(days = 30) {
  * @param {number} n — max entries to return (most recent first)
  */
 export function getHistory(n = 50) {
-  const historyPath = path.join(ORCA_DIR, 'history.jsonl');
+  const historyPath = path.join(KEPLER_DIR, 'history.jsonl');
   try {
     const content = fs.readFileSync(historyPath, 'utf-8');
     const lines = content.trim().split('\n').filter(Boolean);
@@ -318,8 +318,8 @@ export function getHistory(n = 50) {
 
 export function getStorePaths() {
   return {
-    orcaDir: ORCA_DIR,
+    keplerDir: KEPLER_DIR,
     projectsDir: PROJECTS_DIR,
-    historyPath: path.join(ORCA_DIR, 'history.jsonl'),
+    historyPath: path.join(KEPLER_DIR, 'history.jsonl'),
   };
 }

package/src/core/paths.mjs

@@ -1,8 +1,8 @@
 /**
- * Orca Paths — centralized path resolution for all Orca data.
+ * Kepler Paths — centralized path resolution for all Kepler data.
  *
- * Everything lives under ~/.orca/:
- *   ~/.orca/
+ * Everything lives under ~/.kepler/:
+ *   ~/.kepler/
  *     config.json              — auth credentials + settings
  *     history.jsonl            — prompt history
  *     hooks.json               — global hooks
@@ -22,7 +22,7 @@ import * as path from 'node:path';
 import * as os from 'node:os';
 import * as crypto from 'node:crypto';
 
-const ORCA_HOME = process.env.ORCA_HOME || path.join(os.homedir(), '.orca');
+const KEPLER_HOME = process.env.KEPLER_HOME || process.env.ORCA_HOME || path.join(os.homedir(), '.kepler');
 
 /**
  * Hash a project path to a short directory name.
@@ -42,57 +42,60 @@ export function projectHash(projectDir) {
         .slice(0, 16);
 }
 
-/** Root ~/.orca/ directory. */
-export function orcaHome() {
-    return ORCA_HOME;
+/** Root ~/.kepler/ directory. */
+export function keplerHome() {
+    return KEPLER_HOME;
 }
 
-/** ~/.orca/projects/{hash}/ for a given project path. */
+/** @deprecated Use keplerHome() */
+export const orcaHome = keplerHome;
+
+/** ~/.kepler/projects/{hash}/ for a given project path. */
 export function projectDir(projectPath) {
-    return path.join(ORCA_HOME, 'projects', projectHash(projectPath));
+    return path.join(KEPLER_HOME, 'projects', projectHash(projectPath));
 }
 
-/** ~/.orca/projects/{hash}/index/ — BM25 search index. */
+/** ~/.kepler/projects/{hash}/index/ — BM25 search index. */
 export function indexDir(projectPath) {
     return path.join(projectDir(projectPath), 'index');
 }
 
-/** ~/.orca/projects/{hash}/checkpoints/ — file undo. */
+/** ~/.kepler/projects/{hash}/checkpoints/ — file undo. */
 export function checkpointsDir(projectPath) {
     return path.join(projectDir(projectPath), 'checkpoints');
 }
 
-/** ~/.orca/projects/{hash}/state.json — current session. */
+/** ~/.kepler/projects/{hash}/state.json — current session. */
 export function statePath(projectPath) {
     return path.join(projectDir(projectPath), 'state.json');
 }
 
-/** ~/.orca/projects/{hash}/sessions/ — session archive. */
+/** ~/.kepler/projects/{hash}/sessions/ — session archive. */
 export function sessionsDir(projectPath) {
     return path.join(projectDir(projectPath), 'sessions');
 }
 
-/** ~/.orca/projects/{hash}/hooks.json — project hooks. */
+/** ~/.kepler/projects/{hash}/hooks.json — project hooks. */
 export function projectHooksPath(projectPath) {
     return path.join(projectDir(projectPath), 'hooks.json');
 }
 
-/** ~/.orca/conversations/ — central conversation storage. */
+/** ~/.kepler/conversations/ — central conversation storage. */
 export function conversationsDir() {
-    return path.join(ORCA_HOME, 'conversations');
+    return path.join(KEPLER_HOME, 'conversations');
 }
 
-/** ~/.orca/conversations/{sessionId}.jsonl */
+/** ~/.kepler/conversations/{sessionId}.jsonl */
 export function conversationPath(sessionId) {
     return path.join(conversationsDir(), `${sessionId}.jsonl`);
 }
 
-/** ~/.orca/hooks.json — global hooks. */
+/** ~/.kepler/hooks.json — global hooks. */
 export function globalHooksPath() {
-    return path.join(ORCA_HOME, 'hooks.json');
+    return path.join(KEPLER_HOME, 'hooks.json');
 }
 
-/** ~/.orca/history.jsonl — prompt history. */
+/** ~/.kepler/history.jsonl — prompt history. */
 export function historyPath() {
-    return path.join(ORCA_HOME, 'history.jsonl');
+    return path.join(KEPLER_HOME, 'history.jsonl');
 }

package/src/core/session-manager.mjs

@@ -1,8 +1,8 @@
 /**
  * Session Manager — persist session state, history, and conversation messages.
  *
- * All data lives under ~/.orca/:
- *   ~/.orca/
+ * All data lives under ~/.kepler/:
+ *   ~/.kepler/
  *     projects/{hash}/
  *       state.json              — current session metadata
  *       sessions/               — session metadata archive
@@ -29,7 +29,7 @@ const MAX_SESSIONS = 100;
 export class SessionManager {
     constructor(projectPath = process.cwd()) {
         this.projectPath = projectPath;
-        this.projectOrcaDir = getProjectDir(projectPath);
+        this.projectKeplerDir = getProjectDir(projectPath);
         this.statePath = getStatePath(projectPath);
         this.sessionsDir = getSessionsDir(projectPath);
         this.conversationsDir = getConversationsDir();
@@ -37,7 +37,7 @@ export class SessionManager {
     }
 
     _ensureDirs() {
-        fs.mkdirSync(this.projectOrcaDir, { recursive: true });
+        fs.mkdirSync(this.projectKeplerDir, { recursive: true });
         fs.mkdirSync(this.sessionsDir, { recursive: true });
         fs.mkdirSync(this.conversationsDir, { recursive: true });
     }

package/src/core/settings-sync.mjs

@@ -2,14 +2,14 @@
  * Settings Sync — fetch user settings from Tarang web and cache locally.
  *
  * Syncs: gateway_type, model preferences, configured providers.
- * Cached in ~/.orca/config.json alongside auth token.
+ * Cached in ~/.kepler/config.json alongside auth token.
  */
 
 import { resolveWebUrl } from './backend-url.mjs';
 
 /**
  * Fetch user settings from the web API using CLI token.
- * @param {string} token - CLI auth token (orca_xxx)
+ * @param {string} token - CLI auth token (kepler_xxx)
  * @returns {Promise<Object|null>} Settings object or null on failure
  */
 export async function fetchRemoteSettings(token) {
@@ -29,7 +29,7 @@ export async function fetchRemoteSettings(token) {
 
         if (!resp.ok) {
             if (resp.status === 401) {
-                process.stderr.write('\x1b[33mSettings sync: token expired or invalid. Run `orca login` to re-authenticate.\x1b[0m\n');
+                process.stderr.write('\x1b[33mSettings sync: token expired or invalid. Run `kepler login` to re-authenticate.\x1b[0m\n');
             }
             return null;
         }
@@ -44,7 +44,7 @@ export async function fetchRemoteSettings(token) {
 /**
  * Merge remote settings into local config.
  * Remote settings override local only for fields that are set.
- * @param {Object} localConfig - Current ~/.orca/config.json content
+ * @param {Object} localConfig - Current ~/.kepler/config.json content
  * @param {Object} remote - Settings from fetchRemoteSettings()
  * @returns {Object} Merged config to save
  */

package/src/core/stream-client.mjs

@@ -106,7 +106,7 @@ export class TarangStreamClient {
         }
 
         if (response.status === 401) {
-            yield { type: EVENT_TYPES.ERROR, data: { message: 'Authentication failed. Run `orca login` to re-authenticate.', fatal: true } };
+            yield { type: EVENT_TYPES.ERROR, data: { message: 'Authentication failed. Run `kepler login` to re-authenticate.', fatal: true } };
             return;
         }
         if (!response.ok) {

package/src/index.mjs

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 /**
- * @devtarang/orca v1.0.1 — Orca AI Coding Agent CLI
+ * @axplusb/kepler v1.0.1 — Kepler AI Coding Agent CLI
  *
  * Phase 3: Hybrid local/remote/auto + advanced features.
  */
 
-// Load .env file from cwd or ~/.orca/.env
+// Load .env file from cwd or ~/.kepler/.env
 import { readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 
-for (const envPath of [join(process.cwd(), '.env'), join(homedir(), '.orca', '.env')]) {
+for (const envPath of [join(process.cwd(), '.env'), join(homedir(), '.kepler', '.env')]) {
     if (existsSync(envPath)) {
         for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
             const match = line.match(/^\s*([\w]+)\s*=\s*(.+?)\s*$/);
@@ -117,12 +117,12 @@ function printUsage() {
     const B = '\x1b[1m', C = '\x1b[36m', D = '\x1b[2m', G = '\x1b[32m', R = '\x1b[0m';
 
     process.stderr.write(`${B}USAGE${R}\n`);
-    process.stderr.write(`  ${C}orca "instruction"${R}         Execute instruction\n`);
-    process.stderr.write(`  ${C}orca${R}                       Interactive mode (REPL)\n`);
-    process.stderr.write(`  ${C}orca login${R}                 Authenticate via GitHub OAuth\n`);
-    process.stderr.write(`  ${C}orca configure${R}             Open settings in browser\n`);
-    process.stderr.write(`  ${C}orca config --show${R}         Display local configuration\n`);
-    process.stderr.write(`  ${C}orca resume${R}                Resume a paused session\n`);
+    process.stderr.write(`  ${C}kepler "instruction"${R}         Execute instruction\n`);
+    process.stderr.write(`  ${C}kepler${R}                       Interactive mode (REPL)\n`);
+    process.stderr.write(`  ${C}kepler login${R}                 Authenticate via GitHub OAuth\n`);
+    process.stderr.write(`  ${C}kepler configure${R}             Open settings in browser\n`);
+    process.stderr.write(`  ${C}kepler config --show${R}         Display local configuration\n`);
+    process.stderr.write(`  ${C}kepler resume${R}                Resume a paused session\n`);
     process.stderr.write('\n');
     process.stderr.write(`${B}MODE FLAGS${R}\n`);
     process.stderr.write(`  ${G}--local${R}                      Direct LLM API ${D}(<100ms, offline)${R}\n`);
@@ -133,7 +133,7 @@ function printUsage() {
     process.stderr.write(`${B}MODEL FLAGS${R}\n`);
     process.stderr.write(`  ${G}--system-prompt <text>${R}       Override system prompt\n`);
     process.stderr.write(`  ${G}--max-turns <n>${R}              Maximum conversation turns\n`);
-    process.stderr.write(`  ${D}Models are configured via: orca configure${R}\n`);
+    process.stderr.write(`  ${D}Models are configured via: kepler configure${R}\n`);
     process.stderr.write('\n');
     process.stderr.write(`${B}PERMISSION FLAGS${R}\n`);
     process.stderr.write(`  ${G}--yes, -y${R}                    Auto-approve all operations\n`);
@@ -187,7 +187,7 @@ import { startTerminalRepl } from './terminal/repl.mjs';
 
 async function main() {
     const args = parseArgs(process.argv.slice(2));
-    if (args.version) { console.log(`@devtarang/orca ${VERSION}`); process.exit(0); }
+    if (args.version) { console.log(`@axplusb/kepler ${VERSION}`); process.exit(0); }
     if (args.help) { printUsage(); process.exit(0); }
 
     const auth = new TarangAuth();
@@ -219,7 +219,7 @@ async function main() {
             if (remote.models?.reasoning)    process.stderr.write(`\x1b[32m✓ Coding:\x1b[0m       ${remote.models.reasoning}\n`);
             if (remote.models?.local)        process.stderr.write(`\x1b[32m✓ Local:\x1b[0m        ${remote.models.local}\n`);
             if (remote.configured_providers?.length) process.stderr.write(`\x1b[32m✓ Providers:\x1b[0m   ${remote.configured_providers.join(', ')}\n`);
-            process.stderr.write('\n\x1b[32m✓ Settings saved to ~/.orca/config.json\x1b[0m\n');
+            process.stderr.write('\n\x1b[32m✓ Settings saved to ~/.kepler/config.json\x1b[0m\n');
         } catch (err) {
             process.stderr.write(`\x1b[31m✗ ${err.message}\x1b[0m\n`);
         }

package/src/terminal/analytics.mjs

@@ -72,12 +72,12 @@ function extractPrompt(entry) {
 
 export function formatSessionsReport(sessions, limit) {
   if (!sessions.length) {
-    return 'No local sessions found in ~/.orca/projects.\n';
+    return 'No local sessions found in ~/.kepler/projects.\n';
   }
 
   const lines = [];
-  lines.push(`ORCA SESSIONS  ${sessions.length} shown`);
-  lines.push(`Recent local transcripts from ~/.orca/projects  (limit ${limit})`);
+  lines.push(`KEPLER SESSIONS  ${sessions.length} shown`);
+  lines.push(`Recent local transcripts from ~/.kepler/projects  (limit ${limit})`);
   lines.push('');
 
   for (const session of sessions) {
@@ -96,8 +96,8 @@ export function formatSessionsReport(sessions, limit) {
 
 export function formatStatsReport(stats, tools, models, days, paths) {
   const lines = [];
-  lines.push(`ORCA STATS  ${relativeDaysLabel(days)}`);
-  lines.push(`Store: ${paths.orcaDir}`);
+  lines.push(`KEPLER STATS  ${relativeDaysLabel(days)}`);
+  lines.push(`Store: ${paths.keplerDir}`);
   lines.push('');
   lines.push(`Sessions        ${formatNumber(stats.totalSessions)}`);
   lines.push(`Messages        ${formatNumber(stats.totalUserMessages + stats.totalAssistantMessages)}  (${formatNumber(stats.totalUserMessages)} user, ${formatNumber(stats.totalAssistantMessages)} assistant)`);
@@ -131,12 +131,12 @@ export function formatStatsReport(stats, tools, models, days, paths) {
 
 export function formatHistoryReport(entries, limit) {
   if (!entries.length) {
-    return 'No local prompt history found in ~/.orca/history.jsonl.\n';
+    return 'No local prompt history found in ~/.kepler/history.jsonl.\n';
   }
 
   const lines = [];
-  lines.push(`ORCA HISTORY  ${entries.length} shown`);
-  lines.push(`Recent prompts from ~/.orca/history.jsonl  (limit ${limit})`);
+  lines.push(`KEPLER HISTORY  ${entries.length} shown`);
+  lines.push(`Recent prompts from ~/.kepler/history.jsonl  (limit ${limit})`);
   lines.push('');
 
   for (const entry of entries) {
@@ -202,7 +202,7 @@ export async function runHistoryCommand(args = []) {
   process.stdout.write(formatHistoryReport(history, limit));
 }
 
-// Dashboard removed — now using Orca Pulse (pulse/cli.js)
+// Dashboard removed — now using Kepler Pulse (pulse/cli.js)
 
 export async function _runDashboardCommand_REMOVED() { /* see pulse/cli.js */ }
 
@@ -272,8 +272,8 @@ export async function _OLD_runDashboardCommand(args = []) {
   const actualPort = typeof address === 'object' && address ? address.port : requestedPort;
   const url = `http://${host}:${actualPort}`;
 
-  process.stderr.write(`\x1b[36mOrca dashboard\x1b[0m ${url}\n`);
-  process.stderr.write(`\x1b[2mReading local analytics from ${getStorePaths().orcaDir}\x1b[0m\n`);
+  process.stderr.write(`\x1b[36mKepler dashboard\x1b[0m ${url}\n`);
+  process.stderr.write(`\x1b[2mReading local analytics from ${getStorePaths().keplerDir}\x1b[0m\n`);
   process.stderr.write(`\x1b[2mPress Ctrl+C to stop the dashboard server.\x1b[0m\n`);
 
   if (shouldOpen) {

package/src/terminal/main.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Orca CLI — ANSI Terminal UI.
+ * Kepler CLI — ANSI Terminal UI.
  * Zero React. Zero Ink. Zero flickering.
  */
 
@@ -19,7 +19,7 @@ const subcommandArgs = process.argv.slice(3);
 
 async function main() {
   if (subcommand === 'dashboard') {
-    // Launch Orca Pulse Next.js dashboard
+    // Launch Kepler Pulse Next.js dashboard
     const { spawn } = await import('node:child_process');
     const { fileURLToPath } = await import('node:url');
     const path = await import('node:path');
@@ -76,28 +76,28 @@ async function main() {
     const { createRequire } = await import('node:module');
     const require = createRequire(import.meta.url);
     const { version } = require('../../package.json');
-    process.stdout.write(`orca v${version}\n`);
+    process.stdout.write(`kepler v${version}\n`);
     return;
   }
 
   if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
     process.stderr.write(`
-  \x1b[1m\x1b[36morca\x1b[0m — Orchestration of Composable Agents
+  \x1b[1m\x1b[36mkepler\x1b[0m — AI Coding Agent — codekepler.ai
 
   \x1b[1mUsage:\x1b[0m
-    orca                    Start interactive REPL
-    orca "instruction"      Run a single instruction
-    orca --headless -p "x"  Non-interactive: auto-approve, JSONL output
-    orca --resume            Resume last conversation
-    orca dashboard          Open Orca Pulse analytics dashboard
-    orca login              Sign in via browser
-    orca logout             Sign out and clear credentials
-    orca version            Show version
+    kepler                    Start interactive REPL
+    kepler "instruction"      Run a single instruction
+    kepler --headless -p "x"  Non-interactive: auto-approve, JSONL output
+    kepler --resume            Resume last conversation
+    kepler dashboard          Open Kepler Pulse analytics dashboard
+    kepler login              Sign in via browser
+    kepler logout             Sign out and clear credentials
+    kepler version            Show version
 
   \x1b[1mAnalytics:\x1b[0m
-    orca sessions           List recent local sessions
-    orca stats              Show aggregate local session stats
-    orca history            Show recent prompt history
+    kepler sessions           List recent local sessions
+    kepler stats              Show aggregate local session stats
+    kepler history            Show recent prompt history
 
   \x1b[1mREPL Commands:\x1b[0m
     /help                   Show available commands
@@ -121,7 +121,7 @@ async function main() {
     TARANG_ENV              Set backend (local, development, production)
     ANTHROPIC_API_KEY       Direct Anthropic API key
     OPENROUTER_API_KEY      OpenRouter API key
-    ORCA_CONFIG_DIR         Override config directory (default: ~/.orca)
+    KEPLER_CONFIG_DIR         Override config directory (default: ~/.kepler)
 
   \x1b[2mDocs: https://devtarang.ai/docs\x1b[0m
 `);

package/src/terminal/repl.mjs

@@ -1,5 +1,5 @@
 /**
- * Orca REPL — Full Claude-like terminal UX.
+ * Kepler REPL — Full Claude-like terminal UX.
  *
  * Pure ANSI. No React. No Ink. No flickering.
  *
@@ -148,12 +148,12 @@ function printBanner(auth) {
 //
 //   ✓ 3 tools · 1.2s · $0.02                      ctx 21% · 42k tok
 //   ╶─────────────────────────────────────────────────────────────────╴
-//   orca ›
+//   kepler ›
 //
 // Layout on first prompt (no stats yet):
 //
 //   ╶─────────────────────────────────────────────────────────────────╴
-//   orca ›
+//   kepler ›
 
 /**
  * Build the contextual status strip — compact, one line.
@@ -765,7 +765,7 @@ async function handleCommand(input, ctx) {
 
   switch (cmd) {
     case '/help':
-      process.stderr.write(`\n  ${c.bold('Orca Commands')}\n`);
+      process.stderr.write(`\n  ${c.bold('Kepler Commands')}\n`);
       process.stderr.write(`  ${c.gray('─'.repeat(44))}\n`);
       for (const [name, desc] of Object.entries(COMMANDS)) {
         process.stderr.write(`  ${c.brand(name.padEnd(14))} ${desc}\n`);
@@ -937,7 +937,7 @@ async function handleCommand(input, ctx) {
       process.stderr.write(`\n  ${c.bold('Conversation')} (${session.history.length} messages)\n`);
       process.stderr.write(`  ${c.gray('─'.repeat(40))}\n`);
       for (const msg of session.history.slice(-20)) {
-        const role = msg.role === 'user' ? c.white('You') : c.brand('Orca');
+        const role = msg.role === 'user' ? c.white('You') : c.brand('Kepler');
         process.stderr.write(`  ${role}: ${msg.content.slice(0, 80)}${msg.content.length > 80 ? '...' : ''}\n`);
       }
       process.stderr.write('\n');
@@ -1016,7 +1016,7 @@ async function handleCommand(input, ctx) {
         const instr = s.instruction ? s.instruction.slice(0, 40) : '(no instruction)';
         process.stderr.write(`  ${c.brand(s.sessionId)}  ${c.dim(date)}  ${s.messageCount} msgs  ${c.dim(instr)}\n`);
       }
-      process.stderr.write(`\n  ${c.dim('Resume with:')} orca --resume <sessionId>\n`);
+      process.stderr.write(`\n  ${c.dim('Resume with:')} kepler --resume <sessionId>\n`);
       return;
     }
 
@@ -1123,7 +1123,7 @@ async function handleCommand(input, ctx) {
     case '/logout': {
       const success = ctx.auth.logout();
       if (success) {
-        process.stderr.write(`  ${c.green('✓')} ${c.dim('Signed out. Credentials cleared from ~/.orca/config.json')}\n`);
+        process.stderr.write(`  ${c.green('✓')} ${c.dim('Signed out. Credentials cleared from ~/.kepler/config.json')}\n`);
         process.stderr.write(`  ${c.dim('Run /login to sign in again.')}\n`);
       } else {
         process.stderr.write(`  ${c.yellow('!')} ${c.dim('No credentials to clear.')}\n`);
@@ -1172,11 +1172,11 @@ export async function startTerminalRepl() {
   const skipPerms = cliArgs.freeswim;
   const approval = new ApprovalManager({ autoApprove: skipPerms });
 
-  // Session manager — persists conversation messages to .orca/conversations/
+  // Session manager — persists conversation messages to .kepler/conversations/
   const sessionMgr = new SessionManager(safeCwd());
   _sessionMgr = sessionMgr; // expose to renderEvent
 
-  // Local JSONL writer — writes cc-lens compatible session data to ~/.orca/
+  // Local JSONL writer — writes cc-lens compatible session data to ~/.kepler/
   const jsonlWriter = new JsonlWriter(safeCwd(), VERSION);
 
   // Persistent stream client — session_id captured from backend on first turn
@@ -1261,7 +1261,7 @@ export async function startTerminalRepl() {
 
   process.stderr.write(`\n  ${c.dim('Press')} ${c.brand('Enter')} ${c.dim('to start, or type a prompt below.')}\n`);
 
-  const PROMPT = `${c.brand('orca')} ${c.dim('›')} `;
+  const PROMPT = `${c.brand('kepler')} ${c.dim('›')} `;
 
   const rl = readline.createInterface({
     input: process.stdin,
@@ -1326,8 +1326,8 @@ export async function startTerminalRepl() {
       return;
     }
 
-    // Orca response label
-    process.stderr.write(`\n${c.bold(c.brand('orca'))}\n`);
+    // Kepler response label
+    process.stderr.write(`\n${c.bold(c.brand('kepler'))}\n`);
 
     // Create or reuse stream client — sessionId persists across turns
     if (!streamClient || streamClient.baseUrl !== creds.backendUrl || streamClient.token !== creds.token) {

package/src/tools/agent.mjs

@@ -87,10 +87,10 @@ export const AgentTool = {
             settings: {
                 stream: false,
                 stagnationDetection: !['0', 'false', 'no', 'off'].includes(
-                    (process.env.ORCA_STAGNATION_DETECTION ?? '0').toLowerCase(),
+                    (process.env.KEPLER_STAGNATION_DETECTION ?? '0').toLowerCase(),
                 ),
                 stagnationThreshold: Number.parseInt(
-                    process.env.ORCA_STAGNATION_THRESHOLD
+                    process.env.KEPLER_STAGNATION_THRESHOLD
                     ?? '3',
                     10,
                 ),

package/src/ui/banner.mjs

@@ -1,5 +1,5 @@
 /**
- * Banner & Branding — Tarang CLI startup display.
+ * Banner & Branding — Kepler CLI startup display.
  */
 
 import { execSync } from 'node:child_process';
@@ -17,13 +17,13 @@ const BLUE = '\x1b[34m';
 const BOLD_GREEN = '\x1b[1;32m';
 const BOLD_CYAN = '\x1b[1;36m';
 
-const BANNER_ORCA = [
-    ' ██████╗  ██████╗   ██████╗  █████╗ ',
-    '██╔═══██╗ ██╔══██╗ ██╔════╝ ██╔══██╗',
-    '██║   ██║ ██████╔╝ ██║      ███████║',
-    '██║   ██║ ██╔══██╗ ██║      ██╔══██║',
-    '╚██████╔╝ ██║  ██║ ╚██████╗ ██║  ██║',
-    ' ╚═════╝  ╚═╝  ╚═╝  ╚═════╝ ╚═╝  ╚═╝',
+const BANNER_KEPLER = [
+    '██╗  ██╗ ███████╗ ██████╗  ██╗     ███████╗ ██████╗ ',
+    '██║ ██╔╝ ██╔════╝ ██╔══██╗ ██║     ██╔════╝ ██╔══██╗',
+    '█████╔╝  █████╗   ██████╔╝ ██║     █████╗   ██████╔╝',
+    '██╔═██╗  ██╔══╝   ██╔═══╝  ██║     ██╔══╝   ██╔══██╗',
+    '██║  ██╗ ███████╗ ██║      ███████╗ ███████╗ ██║  ██║',
+    '╚═╝  ╚═╝ ╚══════╝ ╚═╝      ╚══════╝ ╚══════╝ ╚═╝  ╚═╝',
 ];
 
 /**
@@ -31,10 +31,10 @@ const BANNER_ORCA = [
  */
 export function printBanner() {
     process.stderr.write('\n');
-    for (const line of BANNER_ORCA) {
+    for (const line of BANNER_KEPLER) {
         process.stderr.write(`  ${BOLD_CYAN}${line}${RESET}\n`);
     }
-    process.stderr.write(`  ${DIM}Orchestration of Composable Agents${RESET}\n`);
+    process.stderr.write(`  ${DIM}AI Coding Agent — codekepler.ai${RESET}\n`);
     process.stderr.write('\n');
 }
 
@@ -105,7 +105,7 @@ export function printStyledConfig(creds) {
         return `${check} ${val.slice(0, 6)}...${val.slice(-4)}`;
     };
 
-    process.stderr.write(`\n${BOLD}Orca Configuration${RESET} ${DIM}(~/.orca/config.json)${RESET}\n`);
+    process.stderr.write(`\n${BOLD}Kepler Configuration${RESET} ${DIM}(~/.kepler/config.json)${RESET}\n`);
     process.stderr.write(`${'─'.repeat(50)}\n`);
     process.stderr.write(`  Token:          ${mask(creds.token)}\n`);
     process.stderr.write(`  OpenRouter:     ${mask(creds.openRouterKey)}\n`);
@@ -167,7 +167,7 @@ export function getLoginSuccessHTML() {
 <html>
 <head>
     <meta charset="utf-8">
-    <title>Orca - Login Successful</title>
+    <title>Kepler - Login Successful</title>
     <style>
         body {
             font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
@@ -189,7 +189,7 @@ export function getLoginSuccessHTML() {
             margin-bottom: 8px;
         }
         .dev { color: #3fb950; }
-        .orca { color: #58a6ff; }
+        .kepler { color: #58a6ff; }
         .check {
             font-size: 64px;
             color: #3fb950;
@@ -222,14 +222,14 @@ export function getLoginSuccessHTML() {
 <body>
     <div class="container">
         <div class="logo">
-            <span class="orca">ORCA</span>
+            <span class="kepler">KEPLER</span>
         </div>
         <div class="check">&#10003;</div>
         <h1>Login Successful!</h1>
         <p>You can close this tab and return to your terminal.</p>
         <div class="hint">
             <p>Next step: set your API key</p>
-            <code>orca config --openrouter-key YOUR_KEY</code>
+            <code>kepler config --openrouter-key YOUR_KEY</code>
         </div>
     </div>
 </body>

package/src/ui/slash-commands.mjs

@@ -41,7 +41,7 @@ function cmdHelp(ctx) {
     const BOLD = '\x1b[1m', CYAN = '\x1b[36m', DIM = '\x1b[2m', GREEN = '\x1b[32m', BLUE = '\x1b[34m', RESET = '\x1b[0m';
 
     process.stderr.write(`\n${BLUE}┌──────────────────────────────────────────────┐${RESET}\n`);
-    process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Orca Help${RESET}                                   ${BLUE}│${RESET}\n`);
+    process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Kepler Help${RESET}                                   ${BLUE}│${RESET}\n`);
     process.stderr.write(`${BLUE}├──────────────────────────────────────────────┤${RESET}\n`);
     process.stderr.write(`${BLUE}│${RESET}                                              ${BLUE}│${RESET}\n`);
     process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Commands:${RESET}                                   ${BLUE}│${RESET}\n`);
@@ -94,7 +94,7 @@ function cmdClear(ctx) {
 }
 
 function cmdSessions() {
-    const sessDir = path.join(process.cwd(), '.orca', 'sessions');
+    const sessDir = path.join(process.cwd(), '.kepler', 'sessions');
     if (!fs.existsSync(sessDir)) {
         process.stderr.write('No sessions found.\n');
         return;
@@ -131,7 +131,7 @@ async function cmdIndex() {
         const retriever = new ContextRetriever(cwd);
         const result = await retriever.buildIndex();
         process.stderr.write(`\x1b[32m✓ Index built: ${result.fileCount} files, ${result.chunkCount} chunks\x1b[0m\n`);
-        process.stderr.write(`\x1b[2m  Stored at: ${path.join(cwd, '.orca', 'index')}\x1b[0m\n`);
+        process.stderr.write(`\x1b[2m  Stored at: ${path.join(cwd, '.kepler', 'index')}\x1b[0m\n`);
     } catch (err) {
         process.stderr.write(`\x1b[31mIndex build failed: ${err.message}\x1b[0m\n`);
     }
@@ -186,7 +186,7 @@ function cmdRefresh(ctx) {
         process.stderr.write('\x1b[31mNo auth module available.\x1b[0m\n');
         return;
     }
-    // Force re-read from ~/.orca/config.json
+    // Force re-read from ~/.kepler/config.json
     ctx.auth._config = null;
     const creds = ctx.auth.loadCredentials();
     const GREEN = '\x1b[32m', DIM = '\x1b[2m', CYAN = '\x1b[36m', RESET = '\x1b[0m';