codekin 0.4.1 → 0.5.1

package/README.md

@@ -25,9 +25,8 @@ This will:
 1. Install Node.js 20+ if needed (via nvm)
 2. Install the `codekin` npm package globally
 3. Generate an auth token
-4. Prompt for optional LLM API keys (Groq, OpenAI, Gemini, Anthropic) for session auto-naming
-5. Install and start a persistent background service
-6. Print your access URL
+4. Install and start a persistent background service
+5. Print your access URL
 
 Open the printed URL in your browser, enter your Codekin Web token when prompted, and you're ready to go.
 
@@ -41,38 +40,40 @@ codekin service install         # (Re-)install the background service
 codekin service uninstall       # Remove the background service
 codekin start                   # Run in foreground (for debugging)
 codekin setup --regenerate      # Generate a new auth token
+codekin upgrade                 # Upgrade to latest version
 codekin uninstall               # Remove Codekin entirely
 ```
 
 ## Features
 
 - **Multi-session terminal** — Open and switch between multiple Claude Code sessions, one per repo
+- **Agent Joe** — AI orchestrator agent that spawns and manages up to 5 concurrent child sessions, with a dedicated chat UI, welcome screen, and color-coded sidebar status indicators
+- **Git worktrees** — Isolate sessions in dedicated worktree directories, with mid-session creation, auto-enable setting, and session context preservation
 - **Session archive** — Full retrieval and re-activation of archived sessions
 - **Repo browser** — Auto-discovers local repos and GitHub org repos
 - **Screenshot upload** — Drag-and-drop or paste images; the file path is sent to Claude so it can read them natively
 - **Skill browser** — Browse and invoke `/skills` defined in each repo's `.claude/skills/`, with inline slash-command autocomplete
 - **Diff viewer** — Side panel showing staged/unstaged file changes with per-file discard support
 - **Command palette** — `Ctrl+K` to quickly search repos, skills, and actions
-- **Approval management** — Persistent approval storage with detailed per-permission revoking
+- **Approval management** — Persistent approval storage with per-permission revoking, permission mode selector, and per-session tool pre-approvals
 - **Mobile-friendly** — Responsive layout that works on phones and tablets
 - **Markdown browser** — Browse and view `.md` files directly in the UI
 - **AI Workflows** — Scheduled code and repository audits and maintenance, with support for custom workflows defined as Markdown files
 - **GitHub webhooks** — Automated bugfixing on CI failures via webhook integration
-- **LLM-powered chores** — Optional API keys (Groq, OpenAI, Gemini, Anthropic) for background tasks like session auto-naming
+- **Upgrade notifications** — In-app banner when a newer version is available
 
 ## Upgrade
 
-Re-run the install script — it's idempotent and will upgrade to the latest version:
-
 ```bash
-curl -fsSL codekin.ai/install.sh | bash
+codekin upgrade
 ```
 
-Or upgrade manually:
+This checks npm for the latest version, installs it, and restarts the background service if running.
+
+Alternatively, re-run the install script:
 
 ```bash
-npm install -g codekin
-codekin service install
+curl -fsSL codekin.ai/install.sh | bash
 ```
 
 ## Uninstall
@@ -91,10 +92,6 @@ All configuration lives in `~/.config/codekin/env`. Edit this file to override d
 |---|---|---|
 | `PORT` | `32352` | Server port |
 | `REPOS_ROOT` | `~/repos` | Root directory scanned for local repositories |
-| `GROQ_API_KEY` | — | Optional. Enables session auto-naming via Llama 4 Scout (free tier at [groq.com](https://groq.com)) |
-| `OPENAI_API_KEY` | — | Optional. Fallback for session auto-naming via GPT-4o Mini ([platform.openai.com](https://platform.openai.com)) |
-| `GEMINI_API_KEY` | — | Optional. Fallback for session auto-naming via Gemini 2.5 Flash ([aistudio.google.com](https://aistudio.google.com)) |
-| `ANTHROPIC_API_KEY` | — | Optional. Fallback for session auto-naming via Claude Haiku ([console.anthropic.com](https://console.anthropic.com)) |
 
 ## Manual / Advanced Setup
 

package/bin/codekin.mjs

@@ -8,8 +8,9 @@
  *   codekin service install        Install + start background service
  *   codekin service uninstall      Remove background service
  *   codekin service status         Show service status
- *   codekin config                  Update API keys and settings
+ *   codekin config                  Update settings
  *   codekin token                  Print access URL with auth token
+ *   codekin upgrade                Upgrade to latest version
  *   codekin uninstall              Remove Codekin entirely
  */
 
@@ -136,27 +137,7 @@ async function cmdSetup({ regenerate = false } = {}) {
     console.log('Auth token: generated')
   }
 
-  // API keys for session auto-naming
-  console.log('\nSession auto-naming uses an LLM to generate descriptive session names.')
-  console.log('Configure at least one API key below (all optional, press Enter to skip).\n')
-
-  const apiKeys = [
-    { env: 'GROQ_API_KEY',      label: 'Groq',      hint: 'free tier available — groq.com' },
-    { env: 'OPENAI_API_KEY',    label: 'OpenAI',     hint: 'platform.openai.com' },
-    { env: 'GEMINI_API_KEY',    label: 'Gemini',     hint: 'aistudio.google.com' },
-    { env: 'ANTHROPIC_API_KEY', label: 'Anthropic',  hint: 'console.anthropic.com' },
-  ]
-
-  for (const { env, label, hint } of apiKeys) {
-    const current = existing[env]
-    const mask = current ? ` (current: ${current.slice(0, 6)}...${current.slice(-4)})` : ''
-    const answer = await prompt(`  ${label} API key${mask} [${hint}]: `)
-    if (answer) {
-      existing[env] = answer
-    }
-  }
-
-
+  console.log('\nSession auto-naming uses the Claude CLI — no extra API keys needed.')
 
   // Write env file
   const frontendDist = findFrontendDist()
@@ -167,15 +148,7 @@ async function cmdSetup({ regenerate = false } = {}) {
   if (frontendDist) envVars.FRONTEND_DIST = frontendDist
   writeEnvFile(envVars)
 
-  // Show which naming provider will be used
-  const namingProvider = apiKeys.find(k => envVars[k.env])
-  if (namingProvider) {
-    console.log(`\nSession naming provider: ${namingProvider.label}`)
-  } else {
-    console.log('\nNo API keys configured — session auto-naming will be disabled.')
-  }
-
-  console.log(`Config saved to ${CONFIG_DIR}`)
+  console.log(`\nConfig saved to ${CONFIG_DIR}`)
 
   printAccessUrl()
 }
@@ -419,6 +392,50 @@ async function cmdUninstall() {
   console.log('\nCodekin has been completely removed.')
 }
 
+async function cmdUpgrade() {
+  // Read current version
+  const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf-8'))
+  const current = pkg.version
+
+  // Check latest version on npm
+  console.log('Checking for updates...')
+  let latest
+  try {
+    latest = execSync('npm view codekin version', { encoding: 'utf-8' }).trim()
+  } catch {
+    console.error('Failed to check npm registry. Check your network connection.')
+    process.exit(1)
+  }
+
+  if (latest === current) {
+    console.log(`Already on the latest version (v${current}).`)
+    return
+  }
+
+  console.log(`Current: v${current}`)
+  console.log(`Latest:  v${latest}\n`)
+  console.log('Upgrading...')
+
+  const result = spawnSync('npm', ['install', '-g', 'codekin'], { stdio: 'inherit' })
+  if (result.status !== 0) {
+    console.error('\nUpgrade failed. Try running with sudo or check npm permissions.')
+    process.exit(1)
+  }
+
+  // Restart service if running
+  try {
+    const status = execSync('codekin service status', { encoding: 'utf-8' })
+    if (status.includes('running')) {
+      console.log('\nRestarting background service...')
+      spawnSync('codekin', ['service', 'install'], { stdio: 'inherit' })
+    }
+  } catch {
+    // Service not installed — skip
+  }
+
+  console.log(`\nUpgraded to v${latest}.`)
+}
+
 // ---------------------------------------------------------------------------
 // Entry point
 // ---------------------------------------------------------------------------
@@ -434,6 +451,8 @@ if (cmd === 'start') {
   await cmdSetup()
 } else if (cmd === 'token') {
   cmdToken()
+} else if (cmd === 'upgrade') {
+  await cmdUpgrade()
 } else if (cmd === 'uninstall') {
   await cmdUninstall()
 } else if (cmd === 'service') {
@@ -450,11 +469,12 @@ Usage:
   codekin start                   Run server in foreground
   codekin setup                   First-time setup wizard
   codekin setup --regenerate      Regenerate auth token
-  codekin config                  Update API keys and settings
+  codekin config                  Update settings
   codekin service install         Install + start background service
   codekin service uninstall       Remove background service
   codekin service status          Show service status
   codekin token                   Print access URL with auth token
+  codekin upgrade                 Upgrade to latest version
   codekin uninstall               Remove Codekin entirely
 `)
 }