@synth1s/cloak 1.1.3 → 1.3.0

package/README.md

@@ -18,8 +18,6 @@ Cloak gives each account its own isolated directory using Claude Code's official
 npm install -g @synth1s/cloak
 ```
 
-That's it. No setup required. All commands work immediately.
-
 ## Quick start
 
 ```bash
@@ -29,9 +27,12 @@ cloak create work
 # Log out, log in with another account, then:
 cloak create home
 
+# Set up shell integration (recommended)
+echo 'eval "$(cloak init)"' >> ~/.bashrc && source ~/.bashrc
+
 # Throw on a cloak and go
-cloak launch work
-cloak launch home
+claude -a work
+claude -a home
 ```
 
 ## Commands
@@ -39,45 +40,45 @@ cloak launch home
 | Command | Description |
 |---------|-------------|
 | `cloak create [name]` | Save current session as a new cloak |
-| `cloak launch <name> [args...]` | Throw on a cloak and launch Claude |
+| `cloak switch <name>` | Set `CLAUDE_CONFIG_DIR` for the current shell |
 | `cloak list` | See all cloaks in your wardrobe |
 | `cloak whoami` | Which cloak are you wearing? |
 | `cloak delete <name>` | Discard a cloak |
 | `cloak rename <old> <new>` | Rename a cloak |
-| `cloak switch <name>` | Set `CLAUDE_CONFIG_DIR` without launching |
-| `cloak init` | Output shell integration code (optional) |
+| `cloak init` | Output shell integration code |
 
-## Concurrent sessions
+## Shell integration (recommended)
 
-Different terminal, different cloak. No conflicts.
+Add to your `.bashrc` or `.zshrc`:
 
 ```bash
-# Terminal A — wearing the work cloak:
-cloak launch work
-
-# Terminal B — wearing the home cloak:
-cloak launch home
+eval "$(cloak init)"
 ```
 
-## Shell integration (optional)
+This enables:
+
+| Command | Description |
+|---------|-------------|
+| `claude -a <name>` | Throw on a cloak and launch Claude |
+| `claude -a <name> [args...]` | Throw on a cloak and launch with arguments |
+| `claude account create [name]` | Save current session as a new cloak |
+| `claude account switch <name>` | Wear a different cloak |
+| `claude account list` | See all cloaks in your wardrobe |
+| `claude account whoami` | Which cloak are you wearing? |
+| `claude account delete <name>` | Discard a cloak |
+| `claude account rename <old> <new>` | Rename a cloak |
+
+## Concurrent sessions
 
-Want `claude -a work` and `claude account` syntax? Add to your `.bashrc` or `.zshrc`:
+Different terminal, different cloak. No conflicts.
 
 ```bash
-eval "$(cloak init)"
-```
-
-This enables:
+# Terminal A — wearing the work cloak:
+claude -a work
 
-| Command | Routes to |
-|---------|-----------|
-| `claude -a <name>` | `cloak launch <name>` |
-| `claude account create [name]` | `cloak create` |
-| `claude account list` | `cloak list` |
-| `claude account whoami` | `cloak whoami` |
-| `claude account switch <name>` | `cloak switch` (sets env in current shell) |
-| `claude account delete <name>` | `cloak delete` |
-| `claude account rename <old> <new>` | `cloak rename` |
+# Terminal B — wearing the home cloak:
+claude -a home
+```
 
 ## How it works
 
@@ -95,11 +96,12 @@ Each cloak is an isolated directory that acts as a [`CLAUDE_CONFIG_DIR`](https:/
         └── ...
 ```
 
-When you run `cloak launch work`, Cloak sets `CLAUDE_CONFIG_DIR=~/.cloak/profiles/work` and spawns Claude Code. Each terminal gets its own environment, so you can wear different cloaks simultaneously.
+When you run `claude -a work`, Cloak sets `CLAUDE_CONFIG_DIR=~/.cloak/profiles/work` in your current shell and launches Claude Code. Each terminal gets its own environment, so you can wear different cloaks simultaneously.
 
 ## Requirements
 
 - Node.js >= 18
+- bash or zsh (for shell integration)
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synth1s/cloak",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "Cloak your Claude. Switch identities in seconds.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -12,7 +12,6 @@ import { listAccounts } from './commands/list.js'
 import { deleteAccount } from './commands/delete.js'
 import { whoami } from './commands/whoami.js'
 import { renameAccount } from './commands/rename.js'
-import { launchAccount } from './commands/launch.js'
 import { initShell } from './commands/init.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -59,12 +58,6 @@ program
   .description('Rename a cloak')
   .action(renameAccount)
 
-program
-  .command('launch <name>')
-  .description('Wear a cloak and launch Claude')
-  .argument('[args...]', 'Arguments to pass to claude')
-  .action((name, args) => launchAccount(name, args))
-
 program
   .command('init')
   .description('Output shell integration code')

package/src/commands/init.js

@@ -14,16 +14,6 @@ export function getInitScript() {
     '      if [ $exit_code -eq 0 ]; then',
     '        eval "$output"',
     '      fi',
-    '    elif [ "$subcmd" = "launch" ]; then',
-    '      local name="$1"',
-    '      shift',
-    '      local output',
-    '      output=$(command cloak switch --print-env "$name")',
-    '      local exit_code=$?',
-    '      if [ $exit_code -eq 0 ]; then',
-    '        eval "$output"',
-    '        command claude "$@"',
-    '      fi',
     '    else',
     '      command cloak "$subcmd" "$@"',
     '    fi',

package/src/commands/switch.js

@@ -1,6 +1,8 @@
 import chalk from 'chalk'
+import inquirer from 'inquirer'
 import { profileDir, profileExists, getActiveProfile } from '../lib/paths.js'
 import { validateAccountName } from '../lib/validate.js'
+import { getRcFilePath, isAlreadyInstalled, installToRcFile } from '../lib/setup.js'
 
 export async function switchAccount(name, options = {}) {
   const validation = validateAccountName(name)
@@ -25,13 +27,46 @@ export async function switchAccount(name, options = {}) {
 
   const dir = profileDir(name)
 
+  // Shell integration is active — output for eval
   if (options.printEnv) {
     process.stdout.write(`export CLAUDE_CONFIG_DIR=${dir}\n`)
     process.stdout.write(`echo "${chalk.green(`✔ Now wearing cloak "${name}".`)}"\n`)
     return
   }
 
-  // Manual instructions (no shell integration)
-  console.log(chalk.dim('Run this command to switch:'))
-  console.log(`\n  export CLAUDE_CONFIG_DIR=${dir}\n`)
+  // No shell integration — prompt user to set it up
+  console.log(chalk.yellow('\n⚠ Shell integration is required to switch accounts.\n'))
+
+  let choice = options.setupChoice
+  if (choice === undefined) {
+    const answer = await inquirer.prompt([{
+      type: 'list',
+      name: 'choice',
+      message: 'How would you like to proceed?',
+      choices: [
+        { name: 'Set it up now (recommended)', value: 'auto' },
+        { name: 'Show manual instructions', value: 'manual' },
+      ],
+    }])
+    choice = answer.choice
+  }
+
+  if (choice === 'auto') {
+    const rcFile = getRcFilePath()
+    if (!isAlreadyInstalled(rcFile)) {
+      installToRcFile(rcFile)
+      console.log(chalk.green(`✔ Shell integration added to ${rcFile}`))
+    } else {
+      console.log(chalk.dim(`  Already installed in ${rcFile}`))
+    }
+    console.log(chalk.dim(`\n  Reload your shell to activate:`))
+    console.log(chalk.dim(`    source ${rcFile}\n`))
+    console.log(chalk.dim(`  Then run:`))
+    console.log(chalk.dim(`    claude account switch ${name}\n`))
+  } else {
+    console.log(chalk.dim('\n  Add this to your shell config:'))
+    console.log(`    eval "$(cloak init)"`)
+    console.log(chalk.dim('\n  Then reload and run:'))
+    console.log(chalk.dim(`    claude account switch ${name}\n`))
+  }
 }

package/src/lib/setup.js

@@ -0,0 +1,27 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+
+function getHome() {
+  return process.env.HOME || homedir()
+}
+
+export function getRcFilePath() {
+  const shell = process.env.SHELL || ''
+  if (shell.includes('zsh')) {
+    return join(getHome(), '.zshrc')
+  }
+  return join(getHome(), '.bashrc')
+}
+
+export function isAlreadyInstalled(rcFilePath) {
+  if (!existsSync(rcFilePath)) return false
+  const content = readFileSync(rcFilePath, 'utf8')
+  return content.includes('cloak init')
+}
+
+export function installToRcFile(rcFilePath) {
+  if (isAlreadyInstalled(rcFilePath)) return
+  const line = '\neval "$(cloak init)"\n'
+  writeFileSync(rcFilePath, line, { flag: 'a' })
+}

package/src/commands/launch.js

@@ -1,29 +0,0 @@
-import { spawn as defaultSpawn } from 'child_process'
-import chalk from 'chalk'
-import { profileDir, profileExists } from '../lib/paths.js'
-import { validateAccountName } from '../lib/validate.js'
-
-export function launchAccount(name, extraArgs = [], spawner = defaultSpawn) {
-  const validation = validateAccountName(name)
-  if (!validation.valid) {
-    return Promise.reject(new Error(validation.error))
-  }
-
-  if (!profileExists(name)) {
-    return Promise.reject(new Error(`Account "${name}" not found. Run: claude account create ${name}`))
-  }
-
-  process.env.CLAUDE_CONFIG_DIR = profileDir(name)
-  console.log(chalk.green(`✔ Now wearing cloak "${name}".`))
-
-  return new Promise((resolve, reject) => {
-    const child = spawner('claude', extraArgs, {
-      stdio: 'inherit',
-      env: process.env,
-    })
-
-    child.on('close', (code) => {
-      resolve(code)
-    })
-  })
-}