@synth1s/cloak 1.4.1 → 1.5.1

package/README.md

@@ -98,6 +98,47 @@ Each cloak is an isolated directory that acts as a [`CLAUDE_CONFIG_DIR`](https:/
 
 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.
 
+## FAQ
+
+### Will switching accounts overwrite my settings or preferences?
+
+No. Each account is a completely isolated directory. Switching only changes which directory Claude Code reads from — it doesn't copy, move, or overwrite any files. Your settings, MCP servers, and preferences for each account stay exactly where they are.
+
+### Can I lose data when running multiple accounts simultaneously?
+
+No, as long as each terminal uses a **different** account. Each account has its own directory (`~/.cloak/profiles/<name>/`), so there's no file overlap. Terminal A writing to `work/` and Terminal B writing to `home/` never interfere.
+
+### What about token renewals? Are they preserved when I switch?
+
+Yes. When Claude Code renews your OAuth token during a session, it writes the new token to the active account's directory. When you switch away and back, the renewed token is still there — Cloak never touches those files.
+
+### What happens if I create a new account? Does it affect existing ones?
+
+No. `cloak create` copies your current session into a **new** directory. Existing accounts are not modified. It's a snapshot, not a move.
+
+### What if I run the same account in two terminals at once?
+
+This is not recommended. Two Claude Code instances writing to the same directory (`~/.cloak/profiles/work/`) can cause token conflicts. This is a Claude Code limitation, not specific to Cloak — the same issue exists without Cloak if you open two `claude` instances normally.
+
+### What happens if I uninstall Cloak?
+
+Your account directories remain in `~/.cloak/`. Claude Code continues to work normally with its default config. To use a saved account manually, set the environment variable:
+
+```bash
+export CLAUDE_CONFIG_DIR=~/.cloak/profiles/work
+claude
+```
+
+To clean up completely: `rm -rf ~/.cloak`
+
+### Is my auth token safe?
+
+Cloak never transmits, logs, or modifies your tokens. It only copies files during `cloak create` (from Claude Code's config to a profile directory) and changes an environment variable during `cloak switch`. All data stays local on your machine.
+
+### Does Cloak work with Claude Code IDE extensions (VSCode, JetBrains)?
+
+IDE extensions may not respect `CLAUDE_CONFIG_DIR` ([known limitation](https://github.com/anthropics/claude-code/issues/4739)). Cloak is designed for terminal-based Claude Code usage.
+
 ## Requirements
 
 - Node.js >= 18

package/package.json

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

package/src/commands/create.js

@@ -1,5 +1,4 @@
 import { existsSync, copyFileSync, mkdirSync } from 'fs'
-import chalk from 'chalk'
 import inquirer from 'inquirer'
 import {
   claudeAuthPath,
@@ -11,14 +10,14 @@ import {
   ensureProfilesDir,
 } from '../lib/paths.js'
 import { validateAccountName } from '../lib/validate.js'
+import * as msg from '../lib/messages.js'
 
 export async function createAccount(name, options = {}) {
-  // Interactive prompt if no name given
   if (!name) {
     const answer = await inquirer.prompt([{
       type: 'input',
       name: 'accountName',
-      message: 'Account name:',
+      message: msg.prompts.accountName,
       validate: (v) => {
         const result = validateAccountName(v.trim())
         return result.valid || result.error
@@ -29,37 +28,36 @@ export async function createAccount(name, options = {}) {
 
   const validation = validateAccountName(name)
   if (!validation.valid) {
-    console.error(chalk.red(`✖ ${validation.error}`))
+    console.error(msg.validationError(validation.error))
     process.exit(1)
     return
   }
 
   const authSource = claudeAuthPath()
   if (!existsSync(authSource)) {
-    console.error(chalk.red('✖ No active Claude Code session found.'))
-    console.log(chalk.dim('  Open Claude Code and log in first.'))
+    console.error(msg.noActiveSession())
+    console.log(msg.loginFirst())
     process.exit(1)
     return
   }
 
   if (profileExists(name)) {
     if (options.confirm === false) {
-      console.log(chalk.dim('Cancelled.'))
+      console.log(msg.cancelled())
       return
     }
     if (options.confirm === undefined) {
       const { overwrite } = await inquirer.prompt([{
         type: 'confirm',
         name: 'overwrite',
-        message: `Cloak "${name}" already exists. Overwrite?`,
+        message: msg.prompts.overwriteConfirm(name),
         default: false,
       }])
       if (!overwrite) {
-        console.log(chalk.dim('Cancelled.'))
+        console.log(msg.cancelled())
         return
       }
     }
-    // options.confirm === true → proceed
   }
 
   ensureProfilesDir()
@@ -73,5 +71,5 @@ export async function createAccount(name, options = {}) {
     copyFileSync(settingsSource, profileSettingsPath(name))
   }
 
-  console.log(chalk.green(`✔ Cloak "${name}" created.`))
+  console.log(msg.cloakCreated(name))
 }

package/src/commands/delete.js

@@ -1,32 +1,32 @@
 import { rmSync } from 'fs'
-import chalk from 'chalk'
 import inquirer from 'inquirer'
 import { profileDir, profileExists, getActiveProfile } from '../lib/paths.js'
 import { validateAccountName } from '../lib/validate.js'
+import * as msg from '../lib/messages.js'
 
 export async function deleteAccount(name, options = {}) {
   const validation = validateAccountName(name)
   if (!validation.valid) {
-    console.error(chalk.red(`✖ ${validation.error}`))
+    console.error(msg.validationError(validation.error))
     process.exit(1)
     return
   }
 
   if (!profileExists(name)) {
-    console.error(chalk.red(`✖ Account "${name}" not found.`))
+    console.error(msg.accountNotFound(name))
     process.exit(1)
     return
   }
 
   if (getActiveProfile() === name) {
-    console.error(chalk.red(`✖ Can't discard a cloak you're wearing.`))
-    console.log(chalk.dim('  Switch to another account first.'))
+    console.error(msg.cannotDiscardActive())
+    console.log(msg.suggestSwitchFirst())
     process.exit(1)
     return
   }
 
   if (options.confirm === false) {
-    console.log(chalk.dim('Cancelled.'))
+    console.log(msg.cancelled())
     return
   }
 
@@ -34,15 +34,15 @@ export async function deleteAccount(name, options = {}) {
     const { confirm } = await inquirer.prompt([{
       type: 'confirm',
       name: 'confirm',
-      message: `Delete cloak "${name}"?`,
+      message: msg.prompts.deleteConfirm(name),
       default: false,
     }])
     if (!confirm) {
-      console.log(chalk.dim('Cancelled.'))
+      console.log(msg.cancelled())
       return
     }
   }
 
   rmSync(profileDir(name), { recursive: true, force: true })
-  console.log(chalk.green(`✔ Cloak "${name}" discarded.`))
+  console.log(msg.cloakDiscarded(name))
 }

package/src/commands/list.js

@@ -1,5 +1,5 @@
-import chalk from 'chalk'
 import { listProfileNames, getActiveProfile } from '../lib/paths.js'
+import * as msg from '../lib/messages.js'
 
 export function listAccounts() {
   const names = listProfileNames().sort()
@@ -11,17 +11,14 @@ export function listAccounts() {
   }))
 
   if (accounts.length === 0) {
-    console.log(chalk.dim('No cloaks in your wardrobe yet.'))
-    console.log(chalk.dim('Run: claude account create <name>'))
+    console.log(msg.noCloaksYet())
+    console.log(msg.suggestCreate())
     return accounts
   }
 
-  console.log(chalk.bold('\nClaude Code Accounts\n'))
+  console.log(msg.accountListHeader())
   accounts.forEach(({ name, active: isActive }) => {
-    const marker = isActive ? chalk.green('● ') : chalk.dim('○ ')
-    const label = isActive ? chalk.green.bold(name) : chalk.white(name)
-    const tag = isActive ? chalk.green(' (active)') : ''
-    console.log(`  ${marker}${label}${tag}`)
+    console.log(msg.accountListItem(name, isActive))
   })
   console.log()
 

package/src/commands/rename.js

@@ -1,31 +1,31 @@
 import { renameSync } from 'fs'
-import chalk from 'chalk'
 import { profileDir, profileExists, getActiveProfile } from '../lib/paths.js'
 import { validateAccountName } from '../lib/validate.js'
+import * as msg from '../lib/messages.js'
 
 export async function renameAccount(oldName, newName) {
   const oldValidation = validateAccountName(oldName)
   if (!oldValidation.valid) {
-    console.error(chalk.red(`✖ ${oldValidation.error}`))
+    console.error(msg.validationError(oldValidation.error))
     process.exit(1)
     return
   }
 
   const newValidation = validateAccountName(newName)
   if (!newValidation.valid) {
-    console.error(chalk.red(`✖ ${newValidation.error}`))
+    console.error(msg.validationError(newValidation.error))
     process.exit(1)
     return
   }
 
   if (!profileExists(oldName)) {
-    console.error(chalk.red(`✖ Account "${oldName}" not found.`))
+    console.error(msg.accountNotFound(oldName))
     process.exit(1)
     return
   }
 
   if (profileExists(newName)) {
-    console.error(chalk.red(`✖ Account "${newName}" is already in use.`))
+    console.error(msg.accountAlreadyInUse(newName))
     process.exit(1)
     return
   }
@@ -33,8 +33,8 @@ export async function renameAccount(oldName, newName) {
   renameSync(profileDir(oldName), profileDir(newName))
 
   if (getActiveProfile() === oldName) {
-    console.log(chalk.yellow(`⚠ Run \`claude account switch ${newName}\` to update your session.`))
+    console.log(msg.updateSessionAfterRename(newName))
   }
 
-  console.log(chalk.green(`✔ Cloak "${oldName}" renamed to "${newName}".`))
+  console.log(msg.cloakRenamed(oldName, newName))
 }

package/src/commands/switch.js

@@ -1,66 +1,66 @@
-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'
+import * as msg from '../lib/messages.js'
 
 export async function switchAccount(name, options = {}) {
   const validation = validateAccountName(name)
   if (!validation.valid) {
-    console.error(chalk.red(`✖ ${validation.error}`))
+    console.error(msg.validationError(validation.error))
     process.exit(1)
     return
   }
 
   if (!profileExists(name)) {
-    console.error(chalk.red(`✖ Account "${name}" not found.`))
-    console.log(chalk.dim(`  Run: claude account create ${name}`))
+    console.error(msg.accountNotFound(name))
+    console.log(msg.suggestCreate(name))
     process.exit(1)
     return
   }
 
   const active = getActiveProfile()
   if (active === name) {
-    console.log(chalk.yellow(`⚡ Already wearing cloak "${name}".`))
+    console.log(msg.alreadyWearing(name))
     return
   }
 
   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`)
+    process.stdout.write(msg.printEnvExport(dir))
+    process.stdout.write(msg.printEnvEcho(name))
     return
   }
 
   // No shell integration — prompt user to set it up
-  console.log(chalk.yellow('\n⚠ Shell integration is required to switch accounts.\n'))
+  console.log('\n' + msg.switchRequired() + '\n')
 
   let choice = options.setupChoice
   if (choice === undefined) {
     const answer = await inquirer.prompt([{
       type: 'list',
       name: 'choice',
-      message: 'How would you like to proceed?',
+      message: msg.prompts.setupChoice,
       choices: [
-        { name: 'Set it up now (recommended)', value: 'auto' },
-        { name: 'Show manual instructions', value: 'manual' },
+        { name: msg.prompts.setupAuto, value: 'auto' },
+        { name: msg.prompts.setupManual, value: 'manual' },
       ],
     }])
     choice = answer.choice
   }
 
+  const rcFile = getRcFilePath()
+
   if (choice === 'auto') {
-    const rcFile = getRcFilePath()
     if (!isAlreadyInstalled(rcFile)) {
       installToRcFile(rcFile)
-      console.log(chalk.green(`✔ Shell integration added to ${rcFile}`))
+      console.log(msg.shellIntegrationAdded(rcFile))
     } else {
-      console.log(chalk.dim(`  Already installed in ${rcFile}`))
+      console.log(msg.alreadyInstalled(rcFile))
     }
-    console.log(chalk.dim(`\n  Run: `) + chalk.white(`source ${rcFile} && cloak switch ${name}\n`))
+    console.log(msg.setupRunCommand(rcFile, name))
   } else {
-    console.log(chalk.dim(`\n  Run: `) + chalk.white(`echo 'eval "$(cloak init)"' >> ${getRcFilePath()} && source ${getRcFilePath()} && cloak switch ${name}\n`))
+    console.log(msg.setupManualCommand(rcFile, name))
   }
 }

package/src/commands/whoami.js

@@ -1,10 +1,10 @@
-import chalk from 'chalk'
 import { getActiveProfile } from '../lib/paths.js'
+import * as msg from '../lib/messages.js'
 
 export function whoami() {
   const active = getActiveProfile()
   if (!active) {
-    console.log(chalk.dim('No cloak. Using default Claude Code config.'))
+    console.log(msg.noCloak())
     return null
   }
   console.log(active)

package/src/lib/messages.js

@@ -0,0 +1,148 @@
+import chalk from 'chalk'
+
+// Icons — consistent across all messages
+const icon = {
+  success: chalk.green('✔'),
+  error: chalk.red('✖'),
+  warning: chalk.yellow('⚠'),
+  tip: '💡',
+  active: chalk.green('●'),
+  inactive: chalk.dim('○'),
+}
+
+// --- Success messages ---
+
+export function cloakCreated(name) {
+  return `${icon.success} Cloak ${chalk.bold(`"${name}"`)} created. Ready to wear!`
+}
+
+export function cloakSwitched(name) {
+  return `${icon.success} Now wearing cloak ${chalk.bold(`"${name}"`)}.`
+}
+
+export function cloakDiscarded(name) {
+  return `${icon.success} Cloak ${chalk.bold(`"${name}"`)} discarded.`
+}
+
+export function cloakRenamed(oldName, newName) {
+  return `${icon.success} Cloak ${chalk.bold(`"${oldName}"`)} is now ${chalk.bold(`"${newName}"`)}.`
+}
+
+export function shellIntegrationAdded(rcFile) {
+  return `${icon.success} All set! Shell integration added to ${chalk.bold(rcFile)}.`
+}
+
+// --- Error messages ---
+
+export function validationError(error) {
+  return `${icon.error} ${error}`
+}
+
+export function accountNotFound(name) {
+  return `${icon.error} Couldn't find a cloak named ${chalk.bold(`"${name}"`)}.`
+}
+
+export function noActiveSession() {
+  return `${icon.error} No active Claude Code session found.`
+}
+
+export function cannotDiscardActive() {
+  return `${icon.error} You're currently wearing this cloak.`
+}
+
+export function accountAlreadyInUse(name) {
+  return `${icon.error} A cloak named ${chalk.bold(`"${name}"`)} already exists.`
+}
+
+// --- Warning messages ---
+
+export function alreadyWearing(name) {
+  return `${icon.warning} You're already wearing cloak ${chalk.bold(`"${name}"`)}.`
+}
+
+export function switchRequired() {
+  return `${icon.warning} Quick setup needed to enable switching.`
+}
+
+export function updateSessionAfterRename(newName) {
+  return `${icon.warning} To keep using this cloak, run: ${chalk.white(`claude account switch ${newName}`)}`
+}
+
+// --- Info / hints ---
+
+export function suggestCreate(name) {
+  return chalk.dim(`  Try: claude account create ${name || '<name>'}`)
+}
+
+export function suggestSwitchFirst() {
+  return chalk.dim('  Switch to a different cloak first, then try again.')
+}
+
+export function loginFirst() {
+  return chalk.dim('  Open Claude Code and log in first.')
+}
+
+export function cancelled() {
+  return chalk.dim('No changes made.')
+}
+
+export function noCloak() {
+  return chalk.dim('No cloak active — using default Claude Code config.')
+}
+
+export function noCloaksYet() {
+  return chalk.dim('No cloaks in your wardrobe yet.')
+}
+
+export function accountListHeader() {
+  return chalk.bold('\nYour Cloaks\n')
+}
+
+export function accountListItem(name, isActive) {
+  const marker = isActive ? icon.active : icon.inactive
+  const label = isActive ? chalk.green.bold(name) : chalk.white(name)
+  const tag = isActive ? chalk.green(' (active)') : ''
+  return `  ${marker} ${label}${tag}`
+}
+
+export function alreadyInstalled(rcFile) {
+  return chalk.dim(`  Already set up in ${rcFile} — you're good!`)
+}
+
+// --- Setup instructions ---
+
+export function setupRunCommand(rcFile, name) {
+  return chalk.dim('\n  Almost there! Run: ') + chalk.white(`source ${rcFile} && cloak switch ${name}\n`)
+}
+
+export function setupManualCommand(rcFile, name) {
+  return chalk.dim('\n  Run: ') + chalk.white(`echo 'eval "$(cloak init)"' >> ${rcFile} && source ${rcFile} && cloak switch ${name}\n`)
+}
+
+// --- Tip ---
+
+export function shellIntegrationTip() {
+  return chalk.dim(`\n${icon.tip} Tip: Enable "claude -a" and "claude account" with:\n`) +
+    chalk.dim('   echo \'eval "$(cloak init)"\' >> ~/.bashrc && source ~/.bashrc\n\n')
+}
+
+// --- Print-env (stdout, no chalk — evaluated by shell) ---
+
+export function printEnvExport(dir) {
+  return `export CLAUDE_CONFIG_DIR=${dir}\n`
+}
+
+export function printEnvEcho(name) {
+  return `echo "${cloakSwitched(name)}"\n`
+}
+
+// --- Prompt messages ---
+
+export const prompts = {
+  accountName: 'Name your cloak:',
+  overwriteConfirm: (name) => `Cloak "${name}" already exists. Replace it?`,
+  deleteConfirm: (name) => `Remove cloak "${name}"? This can't be undone.`,
+  setupChoice: 'How would you like to proceed?',
+  setupAuto: 'Set it up now (recommended)',
+  setupManual: 'Show me the manual steps',
+}

package/src/lib/tip.js

@@ -1,14 +1,11 @@
-import chalk from 'chalk'
+import { shellIntegrationTip } from './messages.js'
 
 export function showTipIfNeeded() {
   if (process.env.CLOAK_SHELL_INTEGRATION === '1') return
   if (process.env.CLOAK_TIP_SHOWN === '1') return
   if (!process.stdout.isTTY) return
 
-  process.stderr.write(
-    chalk.dim('\n💡 Tip: Run this once to enable "claude -a" and "claude account":\n') +
-    chalk.dim('   echo \'eval "$(cloak init)"\' >> ~/.bashrc && source ~/.bashrc\n\n')
-  )
+  process.stderr.write(shellIntegrationTip())
 
   process.env.CLOAK_TIP_SHOWN = '1'
 }