@axplusb/kepler 1.0.4 → 1.0.5

package/KEPLER-README.md

@@ -84,8 +84,100 @@ Platform default included free. Bring your own API key for unlimited.
 
 | Model | Score | Cost |
 |-------|-------|------|
-| DeepSeek V4 Flash | 30.7% (92/300) | $0.03/fix |
-| DeepSeek V4 Pro | 50% (14/28 sample) | $0.48/fix |
+| DeepSeek V4 Flash | 39.7% (119/300) | $0.046/instance |
+| DeepSeek V4 Flash (baseline) | 30.7% (92/300) | $0.03/instance |
+| DeepSeek V4 Pro | 50% (14/28 sample) | $0.48/instance |
+
+### Running SWE-bench
+
+Benchmarks run on an Azure VM (`swebench-eval-vm`, D8s_v3) with a local backend + CLI.
+
+**Setup (one-time):**
+
+```bash
+# Deploy backend + CLI + harness to VM
+./benchmark/vm-setup.sh
+```
+
+**Run benchmark:**
+
+```bash
+# SSH into VM
+ssh azureuser@20.9.77.9
+
+# Start backend
+source ~/.tarang-benchmark.env
+cd ~/tarang-backend
+source ~/backend-env/bin/activate
+uvicorn app.main:app --port 8000 &
+
+# Run all 300 instances (3 parallel workers, skip already-done)
+source ~/swebench-env/bin/activate
+cd ~/tarang-npm
+python3 benchmark/swe-bench/harness.py \
+    --dataset lite \
+    --model deepseek/deepseek-v4-flash \
+    --parallel 3 \
+    --skip-done \
+    --timeout 600
+```
+
+**Flags:**
+
+| Flag | Description |
+|------|-------------|
+| `--dataset lite\|verified\|full` | SWE-bench split (default: lite, 300 instances) |
+| `--model <id>` | OpenRouter model ID |
+| `--parallel <n>` | Number of parallel workers (default: 1) |
+| `--skip-done` | Skip instances already in the output file |
+| `--timeout <s>` | Per-instance timeout in seconds (default: 600) |
+| `--limit <n>` | Only run first N instances |
+| `--instance <id>` | Run a single instance by ID |
+| `--gen-only` | Generate patches only (skip test evaluation) |
+| `--output <path>` | Custom output file path |
+
+**Results** are saved incrementally to `benchmark/results/<model>_<dataset>.json` — no data loss on kill.
+
+**Convenience scripts on VM:**
+
+```bash
+# Watchdog (auto-restarts on crash)
+tmux new-session -d -s bench "bash /tmp/start-parallel.sh"
+
+# Check progress
+tmux capture-pane -t bench -p | tail -20
+
+# Or use the pre-built start script
+./start-benchmark.sh deepseek/deepseek-v4-flash
+```
+
+## Terminal-Bench
+
+Use the benchmark-only adapter under `benchmark/terminal-bench/` when you want to
+evaluate Kepler in Terminal-Bench without touching the production CLI.
+
+It runs with:
+
+- a separate backend venv
+- a separate backend port (`8001` by default)
+- a custom `--agent-import-path kepler_agent:KeplerAgent`
+- per-trial workspace isolation so memory does not leak across tasks
+
+Reusable entrypoints:
+
+```bash
+benchmark/terminal-bench/setup-kepler-backend.sh
+benchmark/terminal-bench/run-kepler-backend.sh
+benchmark/terminal-bench/run-kepler-benchmark.sh --task-id hello-world
+```
+
+Environment variables that can be overridden in another machine or CI setup:
+
+`BACKEND_DIR`, `FRAMEWORK_DIR`, `VENV_DIR`, `TB_VENV`, `TARANG_NPM_DIR`,
+`ENV_FILE`, `BACKEND_URL`, `PORT`, `MODEL`, `DATASET`, `CONCURRENCY`.
+
+Create a local `.tarang-tbench.env` with the benchmark credentials and backend
+auth token, then point `ENV_FILE` at it if needed.
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axplusb/kepler",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Kepler — AI coding agent that plans, builds, tests, and ships. 30.7% on SWE-bench Lite.",
   "type": "module",
   "bin": {

package/pulse/app/activity/page.tsx

@@ -175,7 +175,7 @@ export default function ActivityPage() {
                     <CalendarDays className="h-4 w-4 shrink-0 text-muted-foreground" />
                     Day of Week
                   </CardTitle>
-                  <CardDescription>Which days you use Orca most</CardDescription>
+                  <CardDescription>Which days you use Kepler most</CardDescription>
                 </CardHeader>
                 <CardContent className="flex flex-1 flex-col justify-between pt-3 pb-0">
                   <DayOfWeekChart data={data.dow_counts} />

package/pulse/app/api/import/route.ts

@@ -24,7 +24,7 @@ export async function POST(req: Request) {
   }
 
   // Note: actual file writing is intentionally not implemented here
-  // to prevent accidental corruption of ~/.orca/ live data.
+  // to prevent accidental corruption of ~/.kepler/ live data.
   // The import feature shows a diff preview only.
 
   return NextResponse.json(diff)

package/pulse/app/api/memory/route.ts

@@ -6,7 +6,7 @@ import { readMemories } from '@/lib/claude-reader'
 
 export const dynamic = 'force-dynamic'
 
-const CLAUDE_DIR = path.join(os.homedir(), '.orca')
+const CLAUDE_DIR = path.join(os.homedir(), '.kepler')
 
 export async function GET() {
   const memories = await readMemories()
@@ -37,7 +37,7 @@ export async function PATCH(req: Request) {
 
     const filePath = path.join(CLAUDE_DIR, 'projects', projectSlug, 'memory', file)
 
-    // Ensure the resolved path stays within ~/.orca/projects/
+    // Ensure the resolved path stays within ~/.kepler/projects/
     const allowedRoot = path.join(CLAUDE_DIR, 'projects')
     if (!filePath.startsWith(allowedRoot + path.sep)) {
       return NextResponse.json({ error: 'Path outside allowed directory' }, { status: 403 })

package/pulse/app/costs/page.tsx

@@ -23,7 +23,7 @@ export default function CostsPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="Costs" subtitle="Estimated spend from ~/.orca/" />
+      <TopBar title="Costs" subtitle="Estimated spend from ~/.kepler/" />
       <div className="p-6 space-y-6">
 
         {error && (

package/pulse/app/export/page.tsx

@@ -146,7 +146,7 @@ export default function ExportPage() {
     <div className="flex flex-col min-h-screen">
       <TopBar
         title="Export & import"
-        subtitle="Download a portable backup of ~/.orca/ analytics or merge data from another machine"
+        subtitle="Download a portable backup of ~/.kepler/ analytics or merge data from another machine"
       />
 
       <div className="p-6 space-y-6 flex-1">
@@ -239,7 +239,7 @@ export default function ExportPage() {
                     </CardTitle>
                   </CardHeader>
                   <CardContent className="pt-0">
-                    <p className="text-xs text-muted-foreground">From ~/.orca/ when available</p>
+                    <p className="text-xs text-muted-foreground">From ~/.kepler/ when available</p>
                   </CardContent>
                 </Card>
               </>
@@ -436,7 +436,7 @@ export default function ExportPage() {
                       <Alert className="border-amber-500/40 bg-amber-500/5">
                         <AlertTriangle className="h-4 w-4 text-amber-600" />
                         <AlertDescription className="text-xs text-amber-800 dark:text-amber-200/90">
-                          Writing merged data to ~/.orca/ is not implemented in this build — this is a preview only.
+                          Writing merged data to ~/.kepler/ is not implemented in this build — this is a preview only.
                         </AlertDescription>
                       </Alert>
                       <div className="max-h-36 overflow-auto rounded-md border border-border/60 bg-background/50 space-y-1 p-2 font-mono text-[11px] text-muted-foreground">

package/pulse/app/globals.css

@@ -86,9 +86,9 @@
   --radius-lg: var(--radius);
   --radius-xl: calc(var(--radius) + 4px);
 
-  /* Orca accent colors */
-  --color-orca-cyan: #06b6d4;
-  --color-orca-cyan-light: #22d3ee;
+  /* Kepler accent colors */
+  --color-kepler-cyan: #06b6d4;
+  --color-kepler-cyan-light: #22d3ee;
   --color-terminal-cyan: #06b6d4;
   --color-terminal-green: #34d399;
   --color-terminal-amber: #f59e0b;

package/pulse/app/help/page.tsx

@@ -2,14 +2,14 @@ import { TopBar } from '@/components/layout/top-bar'
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
 
 const CLI_COMMANDS = [
-  { cmd: 'orca', desc: 'Start interactive REPL' },
-  { cmd: 'orca "instruction"', desc: 'Run a single instruction and exit' },
-  { cmd: 'orca dashboard', desc: 'Open Orca Pulse analytics dashboard' },
-  { cmd: 'orca sessions', desc: 'List recent local sessions' },
-  { cmd: 'orca stats', desc: 'Show aggregate local session stats' },
-  { cmd: 'orca history', desc: 'Show recent prompt history' },
-  { cmd: 'orca login', desc: 'Sign in via browser' },
-  { cmd: 'orca version', desc: 'Show version' },
+  { cmd: 'kepler', desc: 'Start interactive REPL' },
+  { cmd: 'kepler "instruction"', desc: 'Run a single instruction and exit' },
+  { cmd: 'kepler dashboard', desc: 'Open Kepler Pulse analytics dashboard' },
+  { cmd: 'kepler sessions', desc: 'List recent local sessions' },
+  { cmd: 'kepler stats', desc: 'Show aggregate local session stats' },
+  { cmd: 'kepler history', desc: 'Show recent prompt history' },
+  { cmd: 'kepler login', desc: 'Sign in via browser' },
+  { cmd: 'kepler version', desc: 'Show version' },
 ]
 
 const REPL_COMMANDS = [
@@ -38,7 +38,7 @@ const ENV_VARS = [
   { name: 'TARANG_ENV', desc: 'Set backend environment (local, development, production)' },
   { name: 'ANTHROPIC_API_KEY', desc: 'Direct Anthropic API key for local mode' },
   { name: 'OPENROUTER_API_KEY', desc: 'OpenRouter API key' },
-  { name: 'ORCA_CONFIG_DIR', desc: 'Override config directory (default: ~/.orca)' },
+  { name: 'KEPLER_CONFIG_DIR', desc: 'Override config directory (default: ~/.kepler)' },
   { name: 'TARANG_BACKEND_URL', desc: 'Override backend URL explicitly' },
 ]
 
@@ -46,7 +46,7 @@ const FEATURES = [
   { title: 'Multi-Agent Orchestration', desc: 'Primary agent spawns explore, plan, and review sub-agents for complex tasks.' },
   { title: 'Smart Tool Routing', desc: 'Write operations routed to CLI for local execution. Read tools run server-side.' },
   { title: 'Safety Guardrails', desc: 'Destructive commands (rm, delete) always require approval. Path validation on all file operations.' },
-  { title: 'Local JSONL Analytics', desc: 'Every session is recorded to ~/.orca/ for offline analytics via Orca Pulse.' },
+  { title: 'Local JSONL Analytics', desc: 'Every session is recorded to ~/.kepler/ for offline analytics via Kepler Pulse.' },
   { title: 'Conversation History', desc: 'Multi-turn conversations within a REPL session. Context preserved across turns.' },
   { title: 'BM25 Code Index', desc: 'Project files indexed on startup for fast semantic code search.' },
 ]
@@ -67,7 +67,7 @@ function CommandTable({ commands }: { commands: { cmd: string; desc: string }[]
 export default function HelpPage() {
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="Help" subtitle="Orca CLI commands, shortcuts, and configuration" />
+      <TopBar title="Help" subtitle="Kepler CLI commands, shortcuts, and configuration" />
       <div className="px-6 py-6 space-y-6">
 
         <Card>

package/pulse/app/history/page.tsx

@@ -55,7 +55,7 @@ export default function HistoryPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="History" subtitle="~/.orca/history.jsonl" />
+      <TopBar title="History" subtitle="~/.kepler/history.jsonl" />
       <div className="p-4 md:p-6 space-y-4">
 
         {error && (
@@ -92,7 +92,7 @@ export default function HistoryPage() {
             {pageEntries.length === 0 ? (
               <div className="text-center py-16 text-muted-foreground text-sm">
                 {(data.history?.length ?? 0) === 0
-                  ? 'No history found in ~/.orca/history.jsonl'
+                  ? 'No history found in ~/.kepler/history.jsonl'
                   : 'No entries match your search.'}
               </div>
             ) : (

package/pulse/app/layout.tsx

@@ -20,8 +20,8 @@ const pressStart2P = Press_Start_2P({
 })
 
 export const metadata: Metadata = {
-  title: 'Orca Pulse',
-  description: 'Real-time analytics for your Orca AI agent sessions',
+  title: 'Kepler Pulse',
+  description: 'Real-time analytics for your Kepler AI agent sessions',
 }
 
 export default function RootLayout({

package/pulse/app/memory/page.tsx

@@ -260,7 +260,7 @@ export default function MemoryPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="orca-pulse · memory" subtitle="~/.orca/projects/*/memory/" />
+      <TopBar title="kepler-pulse · memory" subtitle="~/.kepler/projects/*/memory/" />
       <div className="p-4 md:p-6 space-y-5">
 
         {error && <p className="text-[#f87171] text-sm font-mono">Error loading memories.</p>}
@@ -338,7 +338,7 @@ export default function MemoryPage() {
                 <p className="text-3xl mb-3">🧠</p>
                 <p className="text-muted-foreground/60 text-sm font-mono">
                   {memories.length === 0
-                    ? 'No memory files found in ~/.orca/projects/*/memory/'
+                    ? 'No memory files found in ~/.kepler/projects/*/memory/'
                     : 'No memories match your filter.'}
                 </p>
               </div>

package/pulse/app/overview-client.tsx

@@ -381,7 +381,7 @@ export function OverviewClient() {
       <Card>
         <CardHeader>
           <CardTitle>Recent Sessions</CardTitle>
-          <CardDescription>Your latest Orca sessions</CardDescription>
+          <CardDescription>Your latest Kepler sessions</CardDescription>
         </CardHeader>
         <CardContent>
           <OverviewConversationTable sessions={sessions} />

package/pulse/app/page.tsx

@@ -5,8 +5,8 @@ export default function OverviewPage() {
   return (
     <div className="flex flex-col min-h-screen">
       <TopBar
-        title="Orca Pulse"
-        subtitle="Real-time analytics for your Orca AI agent sessions"
+        title="Kepler Pulse"
+        subtitle="Real-time analytics for your Kepler AI agent sessions"
       />
       <OverviewClient />
     </div>

package/pulse/app/plans/page.tsx

@@ -251,7 +251,7 @@ export default function PlansPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="orca-pulse · plans" subtitle="~/.orca/plans/" />
+      <TopBar title="kepler-pulse · plans" subtitle="~/.kepler/plans/" />
       <div className="p-4 md:p-6 space-y-5">
 
         {error && <p className="text-[#f87171] text-sm font-mono">Error: {String(error)}</p>}
@@ -289,7 +289,7 @@ export default function PlansPage() {
                 <p className="text-[#d97706] text-2xl mb-3">📋</p>
                 <p className="text-muted-foreground/60 text-sm font-mono">
                   {plans.length === 0
-                    ? 'No plans found in ~/.orca/plans/'
+                    ? 'No plans found in ~/.kepler/plans/'
                     : 'No plans match your search.'}
                 </p>
               </div>

package/pulse/app/projects/page.tsx

@@ -101,7 +101,7 @@ export default function ProjectsPage() {
 
         {!isLoading && sorted.length === 0 && (
           <div className="text-center py-16 text-muted-foreground text-sm">
-            {search ? 'No projects match your search.' : 'No projects found in ~/.orca/'}
+            {search ? 'No projects match your search.' : 'No projects found in ~/.kepler/'}
           </div>
         )}
       </div>

package/pulse/app/sessions/page.tsx

@@ -18,7 +18,7 @@ export default function SessionsPage() {
   return (
     <div className="flex flex-col min-h-screen">
       <TopBar
-        title="Orca Pulse · Sessions"
+        title="Kepler Pulse · Sessions"
         subtitle={data ? `${data.total} total sessions` : 'loading...'}
       />
       <div className="p-6">

package/pulse/app/settings/page.tsx

@@ -83,7 +83,7 @@ export default function SettingsPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="orca-pulse · settings" subtitle="~/.orca/settings.json" />
+      <TopBar title="kepler-pulse · settings" subtitle="~/.kepler/settings.json" />
       <div className="p-4 md:p-6 space-y-6">
         {error && <p className="text-[#f87171] text-sm font-mono">Error: {String(error)}</p>}
         {isLoading && (
@@ -100,13 +100,13 @@ export default function SettingsPage() {
                 <span className="text-primary text-2xl font-mono font-bold">
                   {formatBytes(data.storageBytes)}
                 </span>
-                <span className="text-muted-foreground text-sm font-mono">used by ~/.orca/</span>
+                <span className="text-muted-foreground text-sm font-mono">used by ~/.kepler/</span>
               </div>
             </Section>
 
             <Section title="Settings">
               {Object.keys(data.settings).length === 0 ? (
-                <p className="text-muted-foreground/60 text-sm font-mono">No settings found in ~/.orca/settings.json</p>
+                <p className="text-muted-foreground/60 text-sm font-mono">No settings found in ~/.kepler/settings.json</p>
               ) : (
                 <div className="font-mono text-sm leading-relaxed overflow-x-auto">
                   <JsonValue value={data.settings} />
@@ -139,7 +139,7 @@ export default function SettingsPage() {
 
             <Section title={`Skills (${data.skills.length})`}>
               {data.skills.length === 0 ? (
-                <p className="text-muted-foreground/60 text-sm font-mono">No skills found in ~/.orca/skills/</p>
+                <p className="text-muted-foreground/60 text-sm font-mono">No skills found in ~/.kepler/skills/</p>
               ) : (
                 <div className="grid gap-2">
                   {data.skills.map(skill => (

package/pulse/app/todos/page.tsx

@@ -126,7 +126,7 @@ export default function TodosPage() {
 
   return (
     <div className="flex flex-col min-h-screen">
-      <TopBar title="Todos" subtitle="~/.orca/todos/" />
+      <TopBar title="Todos" subtitle="~/.kepler/todos/" />
       <div className="p-4 md:p-6 space-y-5">
 
         {error && (
@@ -192,7 +192,7 @@ export default function TodosPage() {
                 <CircleCheck className="w-8 h-8 mx-auto mb-3 text-muted-foreground/40" />
                 <p className="text-muted-foreground text-sm">
                   {allItems.length === 0
-                    ? 'No todos found in ~/.orca/todos/'
+                    ? 'No todos found in ~/.kepler/todos/'
                     : 'No todos match your filter.'}
                 </p>
               </div>

package/pulse/app/tools/page.tsx

@@ -201,7 +201,7 @@ export default function ToolsPage() {
             {data.versions.length > 0 && (
               <Card>
                 <CardHeader>
-                  <CardTitle>Orca Version History</CardTitle>
+                  <CardTitle>Kepler Version History</CardTitle>
                   <CardDescription>Versions seen across your sessions</CardDescription>
                 </CardHeader>
                 <CardContent>

package/pulse/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * Orca Pulse — local analytics dashboard launcher.
- * Launches a Next.js dev server from ~/.orca-pulse/ cache directory.
+ * Kepler Pulse — local analytics dashboard launcher.
+ * Launches a Next.js dev server from ~/.kepler-pulse/ cache directory.
  */
 
 const { spawn, exec } = require('child_process')
@@ -11,9 +11,9 @@ const path = require('path')
 const fs   = require('fs')
 
 const PKG_DIR   = __dirname
-const CACHE_DIR = path.join(os.homedir(), '.orca-pulse')
+const CACHE_DIR = path.join(os.homedir(), '.kepler-pulse')
 
-// ANSI helpers — Orca cyan palette
+// ANSI helpers — Kepler cyan palette
 const C   = '\x1b[36m'     // cyan
 const C2  = '\x1b[96m'     // bright cyan
 const DIM = '\x1b[2m'
@@ -22,20 +22,10 @@ const R   = '\x1b[0m'
 const G   = '\x1b[32m'
 
 function printBanner() {
-  const art = [
-    `${C}${B} ██████╗ ██████╗  ██████╗ █████╗     ██████╗ ██╗   ██╗██╗     ███████╗███████╗${R}`,
-    `${C}${B}██╔═══██╗██╔══██╗██╔════╝██╔══██╗    ██╔══██╗██║   ██║██║     ██╔════╝██╔════╝${R}`,
-    `${C2}${B}██║   ██║██████╔╝██║     ███████║    ██████╔╝██║   ██║██║     ███████╗█████╗  ${R}`,
-    `${C2}${B}██║   ██║██╔══██╗██║     ██╔══██║    ██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ${R}`,
-    `${C}${B}╚██████╔╝██║  ██║╚██████╗██║  ██║    ██║     ╚██████╔╝███████╗███████║███████╗${R}`,
-    `${C}${B} ╚═════╝ ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝    ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝${R}`,
-  ]
-
-  console.log()
-  art.forEach((line) => console.log('  ' + line))
   console.log()
-  const configDir = process.env.ORCA_CONFIG_DIR ?? path.join(os.homedir(), '.orca')
-  console.log(`  ${B}${C}Orca Pulse${R}   ${DIM}— real-time analytics for your Orca sessions${R}`)
+  const configDir = process.env.KEPLER_CONFIG_DIR ?? path.join(os.homedir(), '.kepler')
+  console.log(`  ${B}${C}K · E · P · L · E · R${R}`)
+  console.log(`  ${B}${C2}Kepler Pulse${R}   ${DIM}real-time agent analytics${R}`)
   console.log()
   console.log(`  ${DIM}Data dir:${R}    ${C2}${configDir}${R}`)
   console.log()
@@ -58,7 +48,7 @@ function openBrowser(url) {
   exec(cmd)
 }
 
-// Source dirs/files to mirror into ~/.orca-pulse/
+// Source dirs/files to mirror into ~/.kepler-pulse/
 const SRC_DIRS  = ['app', 'components', 'lib', 'types', 'public']
 const SRC_FILES = ['next.config.ts', 'tsconfig.json', 'postcss.config.mjs', 'components.json']
 
@@ -78,7 +68,7 @@ function syncSource(pkg) {
   }
   // Write a minimal package.json with only runtime dependencies
   fs.writeFileSync(path.join(CACHE_DIR, 'package.json'), JSON.stringify({
-    name: 'orca-pulse-runtime',
+    name: 'kepler-pulse-runtime',
     version: pkg.version,
     dependencies: pkg.dependencies,
   }, null, 2))
@@ -89,8 +79,8 @@ async function main() {
 
   const pkg = require(path.join(PKG_DIR, 'package.json'))
 
-  // Check whether ~/.orca-pulse/ is up-to-date for this version
-  const versionFile = path.join(CACHE_DIR, '.orca-pulse-version')
+  // Check whether ~/.kepler-pulse/ is up-to-date for this version
+  const versionFile = path.join(CACHE_DIR, '.kepler-pulse-version')
   const cachedVersion = fs.existsSync(versionFile)
     ? fs.readFileSync(versionFile, 'utf8').trim()
     : null
@@ -120,13 +110,13 @@ async function main() {
   const port = await findFreePort(3000)
   const url  = `http://localhost:${port}`
 
-  // Pass ORCA_CONFIG_DIR to the Next.js process so it reads from ~/.orca/
-  const orcaDir = process.env.ORCA_CONFIG_DIR ?? path.join(os.homedir(), '.orca')
+  // Pass KEPLER_CONFIG_DIR to the Next.js process so it reads from ~/.kepler/
+  const keplerDir = process.env.KEPLER_CONFIG_DIR ?? path.join(os.homedir(), '.kepler')
   const env = {
     ...process.env,
     PORT: String(port),
-    ORCA_CONFIG_DIR: orcaDir,
-    CLAUDE_CONFIG_DIR: orcaDir,
+    KEPLER_CONFIG_DIR: keplerDir,
+    CLAUDE_CONFIG_DIR: keplerDir,
   }
 
   console.log(`  ${DIM}Starting server on${R} ${C2}${B}${url}${R}\n`)

package/pulse/components/layout/sidebar.tsx

@@ -101,7 +101,7 @@ function SidebarContents({
             <span
               className="dark:[text-shadow:0_1px_0_#0e4f5c,0_2px_0_#083344,0_3px_6px_rgba(0,0,0,0.35)] [text-shadow:0_1px_0_rgba(255,255,255,0.4)]"
             >
-              Orca Pulse
+              Kepler Pulse
             </span>
           </span>
         )}
@@ -140,7 +140,7 @@ function SidebarContents({
       )}>
         {!collapsed && (
           <span className="text-xs text-sidebar-foreground/50">
-            Orca Pulse
+            Kepler Pulse
           </span>
         )}
         <button

package/pulse/components/sessions/replay/user-tool-result.tsx

@@ -19,7 +19,7 @@ function restAfterAction(s: string, idx: number, needleLen: number): string | un
 }
 
 /**
- * Best-effort parse of common Orca / tool sandbox result strings.
+ * Best-effort parse of common Kepler / tool sandbox result strings.
  */
 export function parseToolResultMessage(raw: string): ParsedToolResult {
   const s = raw.trim()

package/pulse/lib/claude-reader.ts

@@ -32,7 +32,7 @@ export async function resolveProjectPath(slug: string): Promise<string> {
   return slugToPath(slug)
 }
 
-const CLAUDE_DIR = process.env.ORCA_CONFIG_DIR ?? process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), '.orca')
+const CLAUDE_DIR = process.env.KEPLER_CONFIG_DIR ?? process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), '.kepler')
 
 export function claudePath(...segments: string[]): string {
   return path.join(CLAUDE_DIR, ...segments)

package/pulse/lib/decode.ts

@@ -10,7 +10,7 @@ export function slugToPath(slug: string): string {
 }
 
 /**
- * Encode a filesystem path to the slug format used by Orca.
+ * Encode a filesystem path to the slug format used by Kepler.
  */
 export function pathToSlug(path: string): string {
   return path.replace(/\//g, '-')

package/pulse/package.json

@@ -1,8 +1,8 @@
 {
-  "name": "orca-pulse",
-  "version": "1.0.0",
+  "name": "kepler-pulse",
+  "version": "1.0.1",
   "private": true,
-  "description": "Orca Pulse — real-time analytics dashboard for Orca AI agent sessions",
+  "description": "Kepler Pulse — real-time analytics dashboard for Kepler AI agent sessions",
   "scripts": {
     "dev": "next dev",
     "build": "next build",

package/src/auth/tarang-auth.mjs

@@ -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 = process.env.KEPLER_HOME || process.env.ORCA_HOME || path.join(os.homedir(), '.kepler');
+const CONFIG_DIR = process.env.KEPLER_HOME || path.join(os.homedir(), '.kepler');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 
 export class TarangAuth {

package/src/config/cli-args.mjs

@@ -26,6 +26,7 @@ export function parseArgs(args) {
         systemPrompt: null,
         addDirs: [],
         maxTurns: null,
+        timeout: null,
         allowedTools: null,
         disallowedTools: null,
         resume: false,
@@ -72,6 +73,10 @@ export function parseArgs(args) {
                 result.maxTurns = parseInt(args[++i], 10);
                 break;
 
+            case '--timeout':
+                result.timeout = parseInt(args[++i], 10);
+                break;
+
             case '--allowedTools':
                 result.allowedTools = args[++i]?.split(',').map(s => s.trim());
                 break;

package/src/context/retriever.mjs

@@ -8,7 +8,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { indexDir as getIndexDir } from '../core/paths.mjs';
 
-const IGNORED_DIRS = new Set(['.git', 'node_modules', '.orca', '__pycache__', '.venv', 'venv', 'dist', 'build', '.next']);
+const IGNORED_DIRS = new Set(['.git', 'node_modules', '.kepler', '__pycache__', '.venv', 'venv', 'dist', 'build', '.next']);
 const CODE_EXTS = new Set(['.js', '.mjs', '.ts', '.tsx', '.py', '.go', '.rs', '.java', '.rb', '.php', '.c', '.cpp', '.h', '.css', '.html', '.json', '.yaml', '.yml', '.toml', '.md', '.sh']);
 const MAX_FILE_SIZE = 100_000; // 100KB
 const CHUNK_LINES = 50;

package/src/context/skeleton.mjs

@@ -12,7 +12,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 
-const IGNORED_DIRS = new Set(['.git', 'node_modules', '.orca', '__pycache__', '.venv', 'venv', 'dist', 'build', '.next', '.cache', 'coverage', '.tox']);
+const IGNORED_DIRS = new Set(['.git', 'node_modules', '.kepler', '__pycache__', '.venv', 'venv', 'dist', 'build', '.next', '.cache', 'coverage', '.tox']);
 const CODE_EXTS = new Set(['.js', '.mjs', '.ts', '.tsx', '.py', '.go', '.rs', '.java', '.rb', '.c', '.cpp', '.h']);
 const MAX_FILE_SIZE = 200_000;
 

package/src/core/approval.mjs

@@ -10,7 +10,7 @@
  * Shell commands are risk-assessed (safe/medium/high).
  */
 
-import * as path from 'node:path';
+import { toolDisplayLabel, toolDisplaySummary } from '../terminal/tool-display.mjs';
 
 // ── Tool Classification ──
 
@@ -66,44 +66,6 @@ const WHITE = '\x1b[37m';
 
 const write = (s) => process.stderr.write(s);
 
-// ── Tool Description ──
-
-function shortPath(p) {
-    if (!p) return '';
-    const cwd = process.cwd();
-    return p.startsWith(cwd) ? p.slice(cwd.length + 1) : p;
-}
-
-function toolSummary(toolName, args) {
-    switch (toolName) {
-        case 'shell':
-            return args.command || '(empty)';
-        case 'write_file':
-            return shortPath(args.path || args.file_path || '');
-        case 'write_project': {
-            const files = args.files || [];
-            if (files.length === 0) return 'batch write';
-            return files.map(f => shortPath(f.path || f.file_path || '')).join(', ');
-        }
-        case 'edit_file': {
-            const fp = shortPath(args.path || args.file_path || '');
-            const search = (args.search || '').slice(0, 30);
-            return search ? `${fp} "${search}..."` : fp;
-        }
-        case 'delete_file':
-            return shortPath(args.path || args.file_path || '');
-        case 'read_file':
-        case 'read_files':
-            return shortPath(args.file_path || args.path || (args.file_paths || [])[0] || '');
-        case 'search_code':
-            return `"${args.query || args.pattern || ''}"`;
-        case 'list_files':
-            return args.pattern || args.path || '';
-        default:
-            return Object.values(args || {}).filter(v => typeof v === 'string').join(', ').slice(0, 50) || '';
-    }
-}
-
 // ── Approval Manager ──
 
 export class ApprovalManager {
@@ -138,7 +100,7 @@ export class ApprovalManager {
         return `${DIM}ask${RST}`;
     }
 
-    async check(toolName, args, requireApproval = false) {
+    async check(toolName, args, requireApproval = false, context = {}) {
         if (this.planMode && WRITE_TOOLS.has(toolName)) {
             return { approved: false, reason: `Blocked by plan mode: ${toolName}` };
         }
@@ -157,11 +119,11 @@ export class ApprovalManager {
                 return { approved: true };
             }
             if (FORCE_APPROVAL_SHELL.some(p => p.test(args.command || ''))) {
-                return this._prompt(toolName, args);
+                return this._prompt(toolName, args, context);
             }
         }
         if (NEVER_AUTO_APPROVE.has(toolName)) {
-            return this._prompt(toolName, args);
+            return this._prompt(toolName, args, context);
         }
         if (this.approveAll) {
             this.history.push({ tool: toolName, decision: 'auto', time: Date.now() });
@@ -171,20 +133,27 @@ export class ApprovalManager {
             this.history.push({ tool: toolName, decision: 'type-auto', time: Date.now() });
             return { approved: true };
         }
-        return this._prompt(toolName, args);
+        return this._prompt(toolName, args, context);
     }
 
-    async _prompt(toolName, args) {
+    async _prompt(toolName, args, context = {}) {
         const baseRisk = RISK_LEVELS[toolName] || 'medium';
-        const risk = toolName === 'shell' ? assessShellRisk(args.command) : baseRisk;
-        const summary = toolSummary(toolName, args);
+        const assessedRisk = toolName === 'shell' ? assessShellRisk(args.command) : baseRisk;
+        const risk = context.risk || assessedRisk;
+        const label = toolDisplayLabel(toolName);
+        const summary = toolDisplaySummary(toolName, args);
         const isDestructive = risk === 'high';
 
-        // ── Prompt line ──
+        write(`\n  ${isDestructive ? `${YELLOW}⚠${RST}` : `${CYAN}?${RST}`}  ${BOLD}Approval required${RST}\n`);
+        write(`  ${GRAY}Action${RST}  ${WHITE}${label}${RST}\n`);
+        if (summary) write(`  ${GRAY}Target${RST}  ${WHITE}${summary.slice(0, 160)}${RST}\n`);
+        write(`  ${GRAY}Risk${RST}    ${isDestructive ? YELLOW : CYAN}${risk}${RST}\n`);
+        if (context.reason) write(`  ${GRAY}Reason${RST}  ${DIM}${String(context.reason).slice(0, 160)}${RST}\n`);
+
         if (isDestructive) {
-            write(`  ${YELLOW}⚠${RST}  ${DIM}Allow?${RST} ${WHITE}[y]${RST} yes  ${WHITE}[n]${RST} no  ${WHITE}[d]${RST} details\n`);
+            write(`  ${DIM}Choose${RST}  ${WHITE}[y]${RST} allow once  ${WHITE}[n]${RST} deny  ${WHITE}[d]${RST} details\n`);
         } else {
-            write(`  ${DIM}?${RST}  ${DIM}Allow?${RST} ${WHITE}[y]${RST} yes  ${WHITE}[n]${RST} no  ${WHITE}[a]${RST} always  ${WHITE}[t]${RST} type  ${WHITE}[d]${RST} details\n`);
+            write(`  ${DIM}Choose${RST}  ${WHITE}[y]${RST} once  ${WHITE}[n]${RST} deny  ${WHITE}[t]${RST} this action  ${WHITE}[a]${RST} all  ${WHITE}[d]${RST} details\n`);
         }
 
         const key = await this._readKey();
@@ -206,7 +175,7 @@ export class ApprovalManager {
 
             case 'a':
             case 'A':
-                if (isDestructive) return this._prompt(toolName, args);
+                if (isDestructive) return this._prompt(toolName, args, context);
                 this.approveAll = true;
                 write(`  ${GREEN}✓✓${RST} ${DIM}allow-all activated${RST}\n\n`);
                 this.history.push({ tool: toolName, decision: 'approve-all', time: Date.now() });
@@ -214,7 +183,7 @@ export class ApprovalManager {
 
             case 't':
             case 'T':
-                if (isDestructive) return this._prompt(toolName, args);
+                if (isDestructive) return this._prompt(toolName, args, context);
                 this.approvedToolTypes.add(toolName);
                 write(`  ${GREEN}✓${RST}  ${DIM}always allow ${toolName}${RST}\n\n`);
                 this.history.push({ tool: toolName, decision: 'type-approve', time: Date.now() });
@@ -223,10 +192,10 @@ export class ApprovalManager {
             case 'd':
             case 'D':
                 write(`\n${DIM}${JSON.stringify(args, null, 2)}${RST}\n\n`);
-                return this._prompt(toolName, args);
+                return this._prompt(toolName, args, context);
 
             default:
-                return this._prompt(toolName, args);
+                return this._prompt(toolName, args, context);
         }
     }
 

package/src/core/paths.mjs

@@ -22,7 +22,7 @@ import * as path from 'node:path';
 import * as os from 'node:os';
 import * as crypto from 'node:crypto';
 
-const KEPLER_HOME = process.env.KEPLER_HOME || process.env.ORCA_HOME || path.join(os.homedir(), '.kepler');
+const KEPLER_HOME = process.env.KEPLER_HOME || path.join(os.homedir(), '.kepler');
 
 /**
  * Hash a project path to a short directory name.

package/src/core/stream-client.mjs

@@ -290,7 +290,12 @@ export class TarangStreamClient {
         }
 
         // Use the same ApprovalManager for consistent UX
-        const { approved, reason: denyReason } = await this.approval.check(tool, args || {}, true);
+        const { approved, reason: denyReason } = await this.approval.check(
+            tool,
+            args || {},
+            true,
+            { risk, reason },
+        );
 
         // Map ApprovalManager decision to framework scope
         let decision, scope;

package/src/core/tool-executor.mjs

@@ -5,7 +5,7 @@
  * This bridge translates those into OCC tool calls and wraps the results.
  *
  * Safety guardrails integrated — prevents destructive operations on source code.
- * 14 tools mapped: 7 OCC-bridged + 7 Tarang-specific.
+ * 20 tools mapped across file, search, shell, validation, and Git operations.
  */
 
 import { createToolRegistry } from '../tools/registry.mjs';

package/src/terminal/main.mjs

@@ -135,7 +135,7 @@ async function main() {
     await runHeadless({
       instruction: args.prompt,
       model: args.model,
-      timeout: args.maxTurns ? args.maxTurns * 60 : 300,
+      timeout: args.timeout || (args.maxTurns ? args.maxTurns * 60 : 600),
       verbose: args.verbose,
     });
     return;

package/src/terminal/repl.mjs

@@ -30,7 +30,7 @@ import { ContextRetriever } from '../context/retriever.mjs';
 import { buildProjectSkeleton } from '../context/skeleton.mjs';
 import { SessionManager } from '../core/session-manager.mjs';
 import { parseArgs } from '../config/cli-args.mjs';
-import { formatShellCommand, toolDisplayLabel } from './tool-display.mjs';
+import { formatShellCommand, toolDisplayLabel, toolDisplaySummary } from './tool-display.mjs';
 
 import { createRequire } from 'node:module';
 const __require = createRequire(import.meta.url);
@@ -120,18 +120,19 @@ function printBanner(auth) {
   const env = process.env.TARANG_ENV || 'production';
   const authStatus = creds.token ? c.green('authenticated') : c.red('/login to start');
 
-  const art = [
-    '   ██████╗ ██████╗  ██████╗ █████╗',
-    '  ██╔═══██╗██╔══██╗██╔════╝██╔══██╗',
-    '  ██║   ██║██████╔╝██║     ███████║',
-    '  ██║   ██║██╔══██╗██║     ██╔══██║',
-    '  ╚██████╔╝██║  ██║╚██████╗██║  ██║',
-    '   ╚═════╝ ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝',
-  ];
+  const CYAN = '\x1b[36m';
+  const DIM = '\x1b[2m';
+  const BOLD = '\x1b[1m';
+  const YELLOW = '\x1b[33m';
+  const RST = '\x1b[0m';
+
   process.stderr.write('\n');
-  for (const line of art) {
-    process.stderr.write(c.brand(line) + '\n');
-  }
+  process.stderr.write(`${DIM}         ✦${RST}\n`);
+  process.stderr.write(`${DIM}      ╭──────────────────────────╮${RST}\n`);
+  process.stderr.write(`${DIM}      │${RST}  ${BOLD}${CYAN}K · E · P · L · E · R${RST}  ${DIM}│${RST}\n`);
+  process.stderr.write(`${DIM}      ╰──────── ${YELLOW}◯${RST}${DIM} ───────────────╯${RST}\n`);
+  process.stderr.write(`${DIM}            ╱ ╲${RST}\n`);
+  process.stderr.write(`${DIM}       the agentic os${RST}\n`);
   process.stderr.write('\n');
   process.stderr.write(`  ${c.gray('v' + VERSION)}  ${c.dim(env)}  ${authStatus}\n`);
   process.stderr.write('\n');
@@ -221,52 +222,7 @@ function renderToolCall(data) {
   const args = data?.args || {};
   const indent = session.inSubAgent ? '     ' : '  ';
 
-  // Build summary string (what the tool will do)
-  let summary;
-  switch (tool) {
-    case 'read_file': {
-      const fp = shortPath(args.file_path || args.path || '');
-      const range = args.start_line && args.end_line
-        ? ` lines ${args.start_line}-${args.end_line}`
-        : args.start_line ? ` from line ${args.start_line}` : '';
-      summary = `${fp}${range}`;
-      break;
-    }
-    case 'write_file': {
-      const fp = shortPath(args.file_path || args.path || '');
-      const lines = args.content ? `, ${args.content.split('\n').length} lines` : '';
-      summary = `${fp}${lines}`;
-      break;
-    }
-    case 'edit_file': {
-      const fp = shortPath(args.file_path || args.path || '');
-      const search = args.search ? `, "${(args.search || '').slice(0, 30)}..."` : '';
-      summary = `${fp}${search}`;
-      break;
-    }
-    case 'shell':
-      summary = args.command || '';
-      break;
-    case 'search_code':
-      summary = `"${args.query || args.pattern || ''}"`;
-      break;
-    case 'list_files':
-      summary = `${args.pattern || '*'}${args.path ? ` in ${shortPath(args.path)}` : ''}`;
-      break;
-    case 'delete_file':
-      summary = shortPath(args.file_path || args.path || '');
-      break;
-    case 'read_files':
-      summary = (args.file_paths || args.paths || []).map(shortPath).join(', ');
-      break;
-    case 'write_project': {
-      const files = (args.files || []).map(f => shortPath(f.path || f.file_path || ''));
-      summary = files.length > 0 ? files.join(', ') : '';
-      break;
-    }
-    default:
-      summary = Object.values(args || {}).filter(v => typeof v === 'string').join(', ').slice(0, 60);
-  }
+  const summary = toolDisplaySummary(tool, args, { cwd: safeCwd() });
 
   // Render: ⏺ Human-readable action(summary)
   // Use terminal width minus label and padding, minimum 60

package/src/terminal/tool-display.mjs

@@ -21,6 +21,10 @@ const TOOL_LABELS = Object.freeze({
   analyze_code: 'Analyze code',
   explore: 'Explore codebase',
   plan: 'Create implementation plan',
+  verify: 'Verify implementation',
+  debug: 'Debug issue',
+  refactor: 'Refactor code',
+  ask_user: 'Ask for input',
 });
 
 export function toolDisplayLabel(tool) {
@@ -36,6 +40,84 @@ export function toolDisplayLabel(tool) {
     .join(' ');
 }
 
+function currentWorkingDirectory() {
+  try {
+    return process.cwd();
+  } catch {
+    return '';
+  }
+}
+
+function shortPath(filePath, cwd = currentWorkingDirectory()) {
+  const value = String(filePath || '');
+  if (cwd && value.startsWith(`${cwd}/`)) return value.slice(cwd.length + 1);
+  return value;
+}
+
+export function toolDisplaySummary(tool, args = {}, { cwd } = {}) {
+  switch (tool) {
+    case 'shell':
+      return args.command || '(empty command)';
+    case 'read_file': {
+      const filePath = shortPath(args.file_path || args.path, cwd);
+      if (args.start_line && args.end_line) {
+        return `${filePath} · lines ${args.start_line}-${args.end_line}`;
+      }
+      if (args.start_line) return `${filePath} · from line ${args.start_line}`;
+      return filePath;
+    }
+    case 'read_files':
+      return (args.file_paths || args.paths || [])
+        .map(filePath => shortPath(filePath, cwd))
+        .join(', ');
+    case 'write_file': {
+      const filePath = shortPath(args.file_path || args.path, cwd);
+      const lineCount = typeof args.content === 'string'
+        ? args.content.split('\n').length
+        : null;
+      return lineCount ? `${filePath} · ${lineCount} lines` : filePath;
+    }
+    case 'write_project':
+      return (args.files || [])
+        .map(file => shortPath(file.path || file.file_path, cwd))
+        .filter(Boolean)
+        .join(', ') || 'Project files';
+    case 'edit_file': {
+      const filePath = shortPath(args.file_path || args.path, cwd);
+      const search = String(args.search || '').trim();
+      return search ? `${filePath} · match "${search.slice(0, 40)}${search.length > 40 ? '...' : ''}"` : filePath;
+    }
+    case 'delete_file':
+      return shortPath(args.file_path || args.path, cwd);
+    case 'search_code':
+    case 'search_files':
+    case 'grep':
+      return `"${args.query || args.pattern || ''}"${args.path ? ` in ${shortPath(args.path, cwd)}` : ''}`;
+    case 'list_files':
+      return `${args.pattern || '*'}${args.path ? ` in ${shortPath(args.path, cwd)}` : ''}`;
+    case 'run_tests':
+    case 'validate_build':
+    case 'lint_check':
+      return args.command || args.path || args.file_path || '';
+    case 'git_diff':
+    case 'git_status':
+      return args.path ? shortPath(args.path, cwd) : '';
+    case 'explore':
+    case 'plan':
+    case 'verify':
+    case 'debug':
+    case 'refactor':
+      return args.query || args.task || args.prompt || '';
+    case 'ask_user':
+      return args.question || args.prompt || '';
+    default:
+      return Object.values(args)
+        .filter(value => typeof value === 'string' && value)
+        .join(', ')
+        .slice(0, 120);
+  }
+}
+
 export function formatShellCommand(command, colors) {
   const tokens = String(command || '').match(/"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|&&|\|\||[|;<>]|[^\s]+|\s+/g) || [];
   let expectsCommand = true;

package/src/ui/banner.mjs

@@ -17,24 +17,17 @@ const BLUE = '\x1b[34m';
 const BOLD_GREEN = '\x1b[1;32m';
 const BOLD_CYAN = '\x1b[1;36m';
 
-const BANNER_KEPLER = [
-    '██╗  ██╗ ███████╗ ██████╗  ██╗     ███████╗ ██████╗ ',
-    '██║ ██╔╝ ██╔════╝ ██╔══██╗ ██║     ██╔════╝ ██╔══██╗',
-    '█████╔╝  █████╗   ██████╔╝ ██║     █████╗   ██████╔╝',
-    '██╔═██╗  ██╔══╝   ██╔═══╝  ██║     ██╔══╝   ██╔══██╗',
-    '██║  ██╗ ███████╗ ██║      ███████╗ ███████╗ ██║  ██║',
-    '╚═╝  ╚═╝ ╚══════╝ ╚═╝      ╚══════╝ ╚══════╝ ╚═╝  ╚═╝',
-];
-
 /**
- * Print the branded ASCII art banner.
+ * Print the branded orbital banner.
  */
 export function printBanner() {
     process.stderr.write('\n');
-    for (const line of BANNER_KEPLER) {
-        process.stderr.write(`  ${BOLD_CYAN}${line}${RESET}\n`);
-    }
-    process.stderr.write(`  ${DIM}AI Coding Agent — codekepler.ai${RESET}\n`);
+    process.stderr.write(`${DIM}         ✦${RESET}\n`);
+    process.stderr.write(`${DIM}      ╭──────────────────────────╮${RESET}\n`);
+    process.stderr.write(`${DIM}      │${RESET}  ${BOLD}${CYAN}K · E · P · L · E · R${RESET}  ${DIM}│${RESET}\n`);
+    process.stderr.write(`${DIM}      ╰──────── ${YELLOW}◯${RESET}${DIM} ───────────────╯${RESET}\n`);
+    process.stderr.write(`${DIM}            ╱ ╲${RESET}\n`);
+    process.stderr.write(`${DIM}       the agentic os${RESET}\n`);
     process.stderr.write('\n');
 }
 

package/src/ui/formatter.mjs

@@ -8,6 +8,8 @@
  *   White for content and summaries
  */
 
+import { toolDisplayLabel, toolDisplaySummary } from '../terminal/tool-display.mjs';
+
 const RESET = '\x1b[0m';
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[2m';
@@ -179,50 +181,14 @@ export class EventFormatter {
 
         this.toolCount++;
 
-        // Build human-readable description
-        const desc = this._toolDescription(tool, args);
-        process.stderr.write(`  ${this._spinner()} [${this.toolCount}] ${CYAN}${tool}: ${desc}${RESET}\n`);
+        const label = toolDisplayLabel(tool);
+        const summary = toolDisplaySummary(tool, args);
+        const detail = summary ? `${DIM}${summary}${RESET}` : '';
+        process.stderr.write(`  ${this._spinner()} [${this.toolCount}] ${CYAN}${label}${RESET}${detail ? `  ${detail}` : ''}\n`);
 
         this.toolCalls.push({ name: tool, callId, startTime: Date.now() });
     }
 
-    _toolDescription(tool, args) {
-        switch (tool) {
-            case 'read_file':
-                return `Reading ${args.file_path || 'file'}...`;
-            case 'read_files': {
-                const paths = args.file_paths || [];
-                return `Reading ${paths.length} files...`;
-            }
-            case 'write_file':
-                return `Writing ${args.file_path || 'file'}...`;
-            case 'write_project': {
-                const files = args.files || [];
-                return `Writing ${files.length} files...`;
-            }
-            case 'edit_file':
-                return `Editing ${args.file_path || 'file'}...`;
-            case 'list_files':
-                return `Listing files${args.pattern ? ' (' + args.pattern + ')' : ''}...`;
-            case 'search_files':
-                return `Searching for "${args.pattern || ''}"...`;
-            case 'search_code':
-                return `Searching code: ${args.query || ''}...`;
-            case 'shell': {
-                const cmd = (args.command || '').slice(0, 60);
-                return `Running: ${cmd}${(args.command || '').length > 60 ? '...' : ''}`;
-            }
-            case 'validate_build':
-                return `Running build validation...`;
-            case 'validate_file':
-                return `Validating ${args.file_path || 'file'}...`;
-            case 'lint_check':
-                return `Linting ${args.file_path || 'file'}...`;
-            default:
-                return `${tool}...`;
-        }
-    }
-
     _toolDone(data) {
         const tool = data?.tool || '';
         const success = data?.success !== false;

package/README.md.orca

@@ -1,82 +0,0 @@
-# @devtarang/orca
-
-Orca — AI coding agent that plans, builds, and ships software from your terminal. Multi-agent orchestration with explore, review, and architect sub-agents.
-
-## Install
-
-```bash
-npm install -g @devtarang/orca
-```
-
-## Quick Start
-
-```bash
-orca login                          # Sign in via browser (GitHub/Google)
-orca                                # Start interactive REPL
-orca "add user authentication"      # Run a single instruction
-```
-
-## Commands
-
-```
-orca                    Start interactive REPL
-orca "instruction"      Run a single instruction and exit
-orca login              Sign in via browser
-orca dashboard          Open Orca Pulse analytics dashboard
-orca sessions           List recent local sessions
-orca stats              Aggregate session stats (tokens, cost, tools)
-orca history            Recent prompt history
-orca version            Show version
-```
-
-## REPL Commands
-
-```
-/help                   Show available commands
-/stats                  Session metrics (tokens, cost, tools)
-/cost                   Detailed cost breakdown by model
-/history                Conversation history
-/clear                  Clear conversation history
-/explore <query>        Spawn read-only codebase explorer
-/review <query>         Spawn code review agent
-/architect <query>      Spawn architecture planning agent
-/safety                 Show safety guardrail status
-/revoke                 Revoke auto-approvals
-/exit                   Exit the REPL
-```
-
-## Keyboard
-
-```
-Esc                     Cancel current execution
-Space                   Pause / resume execution
-Ctrl+C                  Exit
-```
-
-## Configuration
-
-Settings are managed via the web dashboard at [devtarang.ai/dashboard/settings](https://devtarang.ai/dashboard/settings) and synced to the CLI automatically.
-
-- **API Key**: Add your OpenRouter/Anthropic/OpenAI key in Settings
-- **Model**: Choose your preferred model (40+ supported)
-- **Gateway**: Select provider (OpenRouter, Anthropic, OpenAI, Bedrock, Google AI, etc.)
-
-Config directory: `~/.orca/`
-
-## Environment Variables
-
-```
-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)
-```
-
-## Links
-
-- [Tarang Platform](https://devtarang.ai)
-- [Documentation](https://devtarang.ai/docs)
-
-## License
-
-MIT