@synth1s/cloak 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 synth1s
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# @synth1s/cloak
+
+> Cloak your Claude. Switch identities in seconds.
+
+Every developer wears a different cloak. One for work, one for personal projects, one for that freelance gig. **Cloak** lets you dress your Claude Code in the right identity — and switch between them without breaking a sweat.
+
+## The problem
+
+Claude Code stores your session in `~/.claude.json`. There's no built-in support for multiple accounts, so switching between personal and work means running `/logout` and `/login` every time — losing your session state in the process.
+
+## The solution
+
+Cloak gives each account its own isolated directory using Claude Code's official [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/en/env-vars) environment variable. Each identity stays separate. No file conflicts. No data loss. Full support for concurrent sessions.
+
+## Install
+
+```bash
+npm install -g @synth1s/cloak
+```
+
+Add to your `.bashrc` or `.zshrc`:
+
+```bash
+eval "$(cloak init)"
+```
+
+## Quick start
+
+```bash
+# Cloak your Claude with your work identity
+claude account create work
+
+# Log out, log in with another account, then:
+claude account create home
+
+# Throw on a cloak and go
+claude -a work
+claude -a home
+```
+
+## Commands
+
+### Wardrobe management
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `claude account create [name]` | | Save current session as a new cloak |
+| `claude account switch <name>` | `use` | Wear a different cloak |
+| `claude account list` | `ls` | See all cloaks in your wardrobe |
+| `claude account delete <name>` | `rm` | Discard a cloak |
+| `claude account whoami` | | Which cloak are you wearing? |
+| `claude account rename <old> <new>` | | Rename a cloak |
+
+### Shortcut
+
+| Command | Description |
+|---------|-------------|
+| `claude -a <name>` | Throw on a cloak and launch Claude |
+| `claude -a <name> [args...]` | Throw on a cloak and launch with arguments |
+
+## Concurrent sessions
+
+Different terminal, different cloak. No conflicts.
+
+```bash
+# Terminal A — wearing the work cloak:
+claude -a work
+
+# Terminal B — wearing the home cloak:
+claude -a home
+```
+
+## How it works
+
+Each cloak is an isolated directory that acts as a [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/en/env-vars):
+
+```
+~/.cloak/
+└── profiles/
+    ├── work/                # Work identity
+    │   ├── .claude.json
+    │   ├── settings.json
+    │   └── ...
+    └── home/                # Personal identity
+        ├── .claude.json
+        └── ...
+```
+
+When you run `claude -a work`, Cloak sets `CLAUDE_CONFIG_DIR=~/.cloak/profiles/work` and launches Claude Code. That's it. Each terminal gets its own environment, so you can wear different cloaks simultaneously.
+
+## Requirements
+
+- Node.js >= 18
+- bash or zsh (for shell integration)
+
+## Documentation
+
+- [Requirements & use cases](docs/requirements.md)
+- [Technical specification](docs/technical-spec.md)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@synth1s/cloak",
+  "version": "1.0.0",
+  "description": "Cloak your Claude. Switch identities in seconds.",
+  "type": "module",
+  "bin": {
+    "cloak": "./src/cli.js"
+  },
+  "scripts": {
+    "test": "node --test tests/"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "account",
+    "profile",
+    "cli",
+    "switch",
+    "multi-account",
+    "cloak"
+  ],
+  "author": "synth1s",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "inquirer": "^10.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/synth1s/cloak.git"
+  },
+  "homepage": "https://github.com/synth1s/cloak#readme",
+  "bugs": {
+    "url": "https://github.com/synth1s/cloak/issues"
+  }
+}

package/src/cli.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+import { program } from 'commander'
+import { readFileSync } from 'fs'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+
+import { createAccount } from './commands/create.js'
+import { switchAccount } from './commands/switch.js'
+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))
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'))
+
+program
+  .name('cloak')
+  .description('Cloak your Claude. Switch identities in seconds.')
+  .version(pkg.version)
+
+program
+  .command('create [name]')
+  .description('Save current session as a new cloak')
+  .action(createAccount)
+
+program
+  .command('switch <name>')
+  .alias('use')
+  .description('Wear a different cloak')
+  .option('--print-env', 'Output export command for eval (used by shell integration)')
+  .action((name, opts) => switchAccount(name, { printEnv: opts.printEnv }))
+
+program
+  .command('list')
+  .alias('ls')
+  .description('See all cloaks in your wardrobe')
+  .action(listAccounts)
+
+program
+  .command('delete <name>')
+  .alias('rm')
+  .description('Discard a cloak')
+  .action((name) => deleteAccount(name))
+
+program
+  .command('whoami')
+  .description('Which cloak are you wearing?')
+  .action(whoami)
+
+program
+  .command('rename <old> <new>')
+  .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')
+  .action(initShell)
+
+program.parse()

package/src/commands/create.js

@@ -0,0 +1,77 @@
+import { existsSync, copyFileSync, mkdirSync } from 'fs'
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import {
+  claudeAuthPath,
+  claudeSettingsPath,
+  profileDir,
+  profileAuthPath,
+  profileSettingsPath,
+  profileExists,
+  ensureProfilesDir,
+} from '../lib/paths.js'
+import { validateAccountName } from '../lib/validate.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:',
+      validate: (v) => {
+        const result = validateAccountName(v.trim())
+        return result.valid || result.error
+      },
+    }])
+    name = answer.accountName.trim()
+  }
+
+  const validation = validateAccountName(name)
+  if (!validation.valid) {
+    console.error(chalk.red(`✖ ${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.'))
+    process.exit(1)
+    return
+  }
+
+  if (profileExists(name)) {
+    if (options.confirm === false) {
+      console.log(chalk.dim('Cancelled.'))
+      return
+    }
+    if (options.confirm === undefined) {
+      const { overwrite } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'overwrite',
+        message: `Cloak "${name}" already exists. Overwrite?`,
+        default: false,
+      }])
+      if (!overwrite) {
+        console.log(chalk.dim('Cancelled.'))
+        return
+      }
+    }
+    // options.confirm === true → proceed
+  }
+
+  ensureProfilesDir()
+  const dir = profileDir(name)
+  mkdirSync(dir, { recursive: true })
+
+  copyFileSync(authSource, profileAuthPath(name))
+
+  const settingsSource = claudeSettingsPath()
+  if (existsSync(settingsSource)) {
+    copyFileSync(settingsSource, profileSettingsPath(name))
+  }
+
+  console.log(chalk.green(`✔ Cloak "${name}" created.`))
+}

package/src/commands/delete.js

@@ -0,0 +1,48 @@
+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'
+
+export async function deleteAccount(name, options = {}) {
+  const validation = validateAccountName(name)
+  if (!validation.valid) {
+    console.error(chalk.red(`✖ ${validation.error}`))
+    process.exit(1)
+    return
+  }
+
+  if (!profileExists(name)) {
+    console.error(chalk.red(`✖ Account "${name}" not found.`))
+    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.'))
+    process.exit(1)
+    return
+  }
+
+  if (options.confirm === false) {
+    console.log(chalk.dim('Cancelled.'))
+    return
+  }
+
+  if (options.confirm === undefined) {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: `Delete cloak "${name}"?`,
+      default: false,
+    }])
+    if (!confirm) {
+      console.log(chalk.dim('Cancelled.'))
+      return
+    }
+  }
+
+  rmSync(profileDir(name), { recursive: true, force: true })
+  console.log(chalk.green(`✔ Cloak "${name}" discarded.`))
+}

package/src/commands/init.js

@@ -0,0 +1,30 @@
+export function getInitScript() {
+  /* eslint-disable no-template-curly-in-string */
+  const lines = [
+    'claude() {',
+    '  if [ "$1" = "account" ]; then',
+    '    local subcmd="$2"',
+    '    shift 2',
+    '    if [ "$subcmd" = "switch" ] || [ "$subcmd" = "use" ]; then',
+    '      local output',
+    '      output=$(command cloak switch --print-env "$@")',
+    '      local exit_code=$?',
+    '      if [ $exit_code -eq 0 ]; then',
+    '        eval "$output"',
+    '      fi',
+    '    else',
+    '      command cloak "$subcmd" "$@"',
+    '    fi',
+    '  elif [ "$1" = "-a" ] && [ -n "$2" ]; then',
+    '    command cloak launch "${@:2}"',
+    '  else',
+    '    command claude "$@"',
+    '  fi',
+    '}',
+  ]
+  return lines.join('\n') + '\n'
+}
+
+export async function initShell() {
+  process.stdout.write(getInitScript())
+}

package/src/commands/launch.js

@@ -0,0 +1,29 @@
+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)
+    })
+  })
+}

package/src/commands/list.js

@@ -0,0 +1,29 @@
+import chalk from 'chalk'
+import { listProfileNames, getActiveProfile } from '../lib/paths.js'
+
+export function listAccounts() {
+  const names = listProfileNames().sort()
+  const active = getActiveProfile()
+
+  const accounts = names.map(name => ({
+    name,
+    active: name === active,
+  }))
+
+  if (accounts.length === 0) {
+    console.log(chalk.dim('No cloaks in your wardrobe yet.'))
+    console.log(chalk.dim('Run: claude account create <name>'))
+    return accounts
+  }
+
+  console.log(chalk.bold('\nClaude Code Accounts\n'))
+  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()
+
+  return accounts
+}

package/src/commands/rename.js

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

package/src/commands/switch.js

@@ -0,0 +1,37 @@
+import chalk from 'chalk'
+import { profileDir, profileExists, getActiveProfile } from '../lib/paths.js'
+import { validateAccountName } from '../lib/validate.js'
+
+export async function switchAccount(name, options = {}) {
+  const validation = validateAccountName(name)
+  if (!validation.valid) {
+    console.error(chalk.red(`✖ ${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}`))
+    process.exit(1)
+    return
+  }
+
+  const active = getActiveProfile()
+  if (active === name) {
+    console.log(chalk.yellow(`⚡ Already wearing cloak "${name}".`))
+    return
+  }
+
+  const dir = profileDir(name)
+
+  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`)
+}

package/src/commands/whoami.js

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

package/src/lib/paths.js

@@ -0,0 +1,69 @@
+import { homedir } from 'os'
+import { join, resolve, sep } from 'path'
+import { existsSync, mkdirSync, readdirSync } from 'fs'
+
+function getHome() {
+  return process.env.HOME || homedir()
+}
+
+export const HOME = getHome()
+export const CLOAK_DIR = join(HOME, '.cloak')
+export const PROFILES_DIR = join(CLOAK_DIR, 'profiles')
+
+export function claudeAuthPath() {
+  const configDir = process.env.CLAUDE_CONFIG_DIR
+  if (configDir) {
+    return join(configDir, '.claude.json')
+  }
+  return join(HOME, '.claude.json')
+}
+
+export function claudeSettingsPath() {
+  const configDir = process.env.CLAUDE_CONFIG_DIR
+  if (configDir) {
+    return join(configDir, 'settings.json')
+  }
+  return join(HOME, '.claude', 'settings.json')
+}
+
+export function profileDir(name) {
+  return join(PROFILES_DIR, name)
+}
+
+export function profileAuthPath(name) {
+  return join(PROFILES_DIR, name, '.claude.json')
+}
+
+export function profileSettingsPath(name) {
+  return join(PROFILES_DIR, name, 'settings.json')
+}
+
+export function ensureProfilesDir() {
+  if (!existsSync(PROFILES_DIR)) {
+    mkdirSync(PROFILES_DIR, { recursive: true })
+  }
+}
+
+export function profileExists(name) {
+  return existsSync(profileDir(name))
+}
+
+export function listProfileNames() {
+  ensureProfilesDir()
+  return readdirSync(PROFILES_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory())
+    .map(d => d.name)
+}
+
+export function getActiveProfile() {
+  const configDir = process.env.CLAUDE_CONFIG_DIR
+  if (!configDir) return null
+
+  const resolved = resolve(configDir)
+  const profilesResolved = resolve(PROFILES_DIR)
+
+  if (!resolved.startsWith(profilesResolved + sep)) return null
+
+  const name = resolved.slice(profilesResolved.length + 1).split(sep)[0]
+  return name || null
+}

package/src/lib/validate.js

@@ -0,0 +1,21 @@
+const NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/
+
+export function validateAccountName(name) {
+  if (!name || typeof name !== 'string' || name.trim().length === 0) {
+    return { valid: false, error: 'Account name is required.' }
+  }
+
+  if (name.length > 64) {
+    return { valid: false, error: 'Account name must be at most 64 characters.' }
+  }
+
+  if (!/^[a-zA-Z0-9]/.test(name)) {
+    return { valid: false, error: 'Account name must start with a letter or number.' }
+  }
+
+  if (!NAME_PATTERN.test(name)) {
+    return { valid: false, error: 'Account name can only contain letters, numbers, hyphens and underscores.' }
+  }
+
+  return { valid: true }
+}