feat: auto-switch by directory with cloak bind/unbind (121 tests)

New commands:
- cloak bind <name> — creates .cloak file in current directory
- cloak unbind — removes .cloak file

Shell function reads .cloak file before launching claude.
If present, auto-switches to the indicated profile.
Follows .nvmrc/.node-version convention.

Example:
  cd ~/projects/company && cloak bind work
  cd ~/projects/personal && cloak bind home
  cd ~/projects/company && claude  # auto-uses work profile

New tests: BI-01 to BI-06, I-13, I-14

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: goulartfs

src/cli.js

@@ -13,6 +13,8 @@ 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 { bindAccount } from './commands/bind.js'
+import { unbindAccount } from './commands/unbind.js'
 import { initShell } from './commands/init.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -94,6 +96,22 @@ program
     return renameAccount(oldName, newName)
   })
 
+program
+  .command('bind <name>')
+  .description('Bind this directory to a cloak')
+  .action((name) => {
+    renderContextBar('bind')
+    return bindAccount(name)
+  })
+
+program
+  .command('unbind')
+  .description('Unbind this directory')
+  .action(() => {
+    renderContextBar('unbind')
+    return unbindAccount()
+  })
+
 program
   .command('context-bar', { hidden: true })
   .argument('<command>')

src/commands/bind.js

@@ -0,0 +1,24 @@
+import { writeFileSync } from 'fs'
+import { join } from 'path'
+import { profileExists } from '../lib/paths.js'
+import { validateAccountName } from '../lib/validate.js'
+import * as msg from '../lib/messages.js'
+
+export async function bindAccount(name, dir = process.cwd()) {
+  const validation = validateAccountName(name)
+  if (!validation.valid) {
+    console.error(msg.validationError(validation.error))
+    process.exit(1)
+    return
+  }
+
+  if (!profileExists(name)) {
+    console.error(msg.accountNotFound(name))
+    console.error(msg.suggestCreate(name))
+    process.exit(1)
+    return
+  }
+
+  writeFileSync(join(dir, '.cloak'), name + '\n')
+  console.log(msg.cloakBound(name))
+}

src/commands/init.js

@@ -43,6 +43,17 @@ export function getInitScript() {
     '      command claude "$@"',
     '    fi',
     '  else',
+    '    if [ -f ".cloak" ]; then',
+    '      local _bind_name',
+    '      _bind_name=$(cat .cloak 2>/dev/null | tr -d "[:space:]")',
+    '      if [ -n "$_bind_name" ]; then',
+    '        local _bind_output',
+    '        _bind_output=$(command cloak switch --print-env "$_bind_name" 2>/dev/null)',
+    '        if [ $? -eq 0 ]; then',
+    '          eval "$_bind_output"',
+    '        fi',
+    '      fi',
+    '    fi',
     '    if [ -n "$CLAUDE_CONFIG_DIR" ]; then',
     '      command cloak context-bar claude',
     '    fi',

src/commands/unbind.js

@@ -0,0 +1,16 @@
+import { unlinkSync, existsSync } from 'fs'
+import { join } from 'path'
+import * as msg from '../lib/messages.js'
+
+export async function unbindAccount(dir = process.cwd()) {
+  const cloakFile = join(dir, '.cloak')
+
+  if (!existsSync(cloakFile)) {
+    console.error(msg.noCloakFile())
+    process.exit(1)
+    return
+  }
+
+  unlinkSync(cloakFile)
+  console.log(msg.cloakUnbound())
+}

src/lib/messages.js

@@ -128,6 +128,20 @@ export function shellIntegrationTip(rcFile) {
     chalk.dim(`   echo 'eval "$(cloak init)"' >> ${file} && source ${file}\n\n`)
 }
 
+// --- Bind/unbind ---
+
+export function cloakBound(name) {
+  return `${icon.success} Bound this directory to cloak ${chalk.bold(`"${name}"`)}.`
+}
+
+export function cloakUnbound() {
+  return `${icon.success} Unbound this directory.`
+}
+
+export function noCloakFile() {
+  return `${icon.error} No .cloak file in this directory.`
+}
+
 // --- Active cloak indicator (shown on claude launch) ---
 
 export function wearingCloak(name) {

tests/bind.test.js

@@ -0,0 +1,88 @@
+import { describe, it, beforeEach, after } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+
+const TMP = fs.mkdtempSync(path.join(os.tmpdir(), 'cloak-test-'))
+process.env.HOME = TMP
+delete process.env.CLAUDE_CONFIG_DIR
+
+const { profileDir, PROFILES_DIR } = await import('../src/lib/paths.js')
+const { bindAccount } = await import('../src/commands/bind.js')
+const { unbindAccount } = await import('../src/commands/unbind.js')
+
+const WORK_DIR = path.join(TMP, 'project')
+
+function createFakeProfile(name) {
+  const dir = profileDir(name)
+  fs.mkdirSync(dir, { recursive: true })
+  fs.writeFileSync(path.join(dir, '.claude.json'), '{}')
+}
+
+function cleanup() {
+  if (fs.existsSync(PROFILES_DIR)) fs.rmSync(PROFILES_DIR, { recursive: true, force: true })
+  const cloakFile = path.join(WORK_DIR, '.cloak')
+  if (fs.existsSync(cloakFile)) fs.unlinkSync(cloakFile)
+}
+
+function interceptExit(fn) {
+  let exitCode = null
+  const original = process.exit
+  process.exit = (code) => { exitCode = code }
+  return async () => {
+    try { await fn() } finally { process.exit = original }
+    return exitCode
+  }
+}
+
+describe('bind', () => {
+  beforeEach(() => {
+    cleanup()
+    if (!fs.existsSync(WORK_DIR)) fs.mkdirSync(WORK_DIR, { recursive: true })
+  })
+
+  after(() => {
+    fs.rmSync(TMP, { recursive: true, force: true })
+  })
+
+  it('BI-01: bind creates .cloak file with profile name', async () => {
+    createFakeProfile('work')
+    await bindAccount('work', WORK_DIR)
+    const content = fs.readFileSync(path.join(WORK_DIR, '.cloak'), 'utf8')
+    assert.equal(content.trim(), 'work')
+  })
+
+  it('BI-02: bind fails for non-existent profile', async () => {
+    const run = interceptExit(() => bindAccount('ghost', WORK_DIR))
+    const code = await run()
+    assert.equal(code, 1)
+    assert.ok(!fs.existsSync(path.join(WORK_DIR, '.cloak')))
+  })
+
+  it('BI-03: bind fails for invalid name', async () => {
+    const run = interceptExit(() => bindAccount('../bad', WORK_DIR))
+    const code = await run()
+    assert.equal(code, 1)
+    assert.ok(!fs.existsSync(path.join(WORK_DIR, '.cloak')))
+  })
+
+  it('BI-04: unbind removes .cloak file', async () => {
+    fs.writeFileSync(path.join(WORK_DIR, '.cloak'), 'work')
+    await unbindAccount(WORK_DIR)
+    assert.ok(!fs.existsSync(path.join(WORK_DIR, '.cloak')))
+  })
+
+  it('BI-05: unbind fails when no .cloak file', async () => {
+    const run = interceptExit(() => unbindAccount(WORK_DIR))
+    const code = await run()
+    assert.equal(code, 1)
+  })
+
+  it('BI-06: .cloak file contains only the profile name', async () => {
+    createFakeProfile('my-project')
+    await bindAccount('my-project', WORK_DIR)
+    const content = fs.readFileSync(path.join(WORK_DIR, '.cloak'), 'utf8')
+    assert.equal(content, 'my-project\n')
+  })
+})

tests/init.test.js

@@ -123,4 +123,27 @@ describe('init', () => {
     assert.ok(ctxIdx > -1, '-a branch contains context-bar')
     assert.ok(claudeIdx > ctxIdx, 'command claude comes after context-bar in -a branch')
   })
+
+  it('I-13: passthrough reads .cloak file', () => {
+    const output = getInitScript()
+    const func = extractFunction(output, 'claude')
+    const lines = func.split('\n')
+
+    const elseIdx = lines.findLastIndex(l => l.trim() === 'else')
+    const afterElse = lines.slice(elseIdx)
+    const cloakFileIdx = afterElse.findIndex(l => l.includes('.cloak'))
+    assert.ok(cloakFileIdx > -1, 'else branch reads .cloak file')
+  })
+
+  it('I-14: .cloak auto-switch happens before context-bar', () => {
+    const output = getInitScript()
+    const func = extractFunction(output, 'claude')
+    const lines = func.split('\n')
+
+    const elseIdx = lines.findLastIndex(l => l.trim() === 'else')
+    const afterElse = lines.slice(elseIdx)
+    const cloakFileIdx = afterElse.findIndex(l => l.includes('.cloak'))
+    const ctxIdx = afterElse.findIndex(l => l.includes('context-bar'))
+    assert.ok(cloakFileIdx < ctxIdx, '.cloak read comes before context-bar')
+  })
 })