@synth1s/cloak 1.0.0 → 1.1.0

package/README.md

@@ -18,45 +18,34 @@ Cloak gives each account its own isolated directory using Claude Code's official
 npm install -g @synth1s/cloak
 ```
 
-Add to your `.bashrc` or `.zshrc`:
-
-```bash
-eval "$(cloak init)"
-```
+That's it. No setup required. All commands work immediately.
 
 ## Quick start
 
 ```bash
-# Cloak your Claude with your work identity
-claude account create work
+# Save your current Claude session
+cloak create work
 
 # Log out, log in with another account, then:
-claude account create home
+cloak create home
 
 # Throw on a cloak and go
-claude -a work
-claude -a home
+cloak launch work
+cloak launch 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 |
+| `cloak create [name]` | Save current session as a new cloak |
+| `cloak launch <name> [args...]` | Throw on a cloak and launch Claude |
+| `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) |
 
 ## Concurrent sessions
 
@@ -64,12 +53,32 @@ Different terminal, different cloak. No conflicts.
 
 ```bash
 # Terminal A — wearing the work cloak:
-claude -a work
+cloak launch work
 
 # Terminal B — wearing the home cloak:
-claude -a home
+cloak launch home
 ```
 
+## Shell integration (optional)
+
+Want `claude -a work` and `claude account` syntax? Add to your `.bashrc` or `.zshrc`:
+
+```bash
+eval "$(cloak init)"
+```
+
+This enables:
+
+| 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` |
+
 ## How it works
 
 Each cloak is an isolated directory that acts as a [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/en/env-vars):
@@ -86,12 +95,11 @@ 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` and launches Claude Code. That's it. Each terminal gets its own environment, so you can wear different cloaks simultaneously.
+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.
 
 ## Requirements
 
 - Node.js >= 18
-- bash or zsh (for shell integration)
 
 ## Documentation
 

package/package.json

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

package/src/cli.js

@@ -5,6 +5,7 @@ import { readFileSync } from 'fs'
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
 
+import { showTipIfNeeded } from './lib/tip.js'
 import { createAccount } from './commands/create.js'
 import { switchAccount } from './commands/switch.js'
 import { listAccounts } from './commands/list.js'
@@ -17,6 +18,8 @@ import { initShell } from './commands/init.js'
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'))
 
+showTipIfNeeded()
+
 program
   .name('cloak')
   .description('Cloak your Claude. Switch identities in seconds.')

package/src/commands/init.js

@@ -1,6 +1,8 @@
 export function getInitScript() {
   /* eslint-disable no-template-curly-in-string */
   const lines = [
+    'export CLOAK_SHELL_INTEGRATION=1',
+    '',
     'claude() {',
     '  if [ "$1" = "account" ]; then',
     '    local subcmd="$2"',

package/src/lib/tip.js

@@ -0,0 +1,14 @@
+import chalk from 'chalk'
+
+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.env.CLOAK_TIP_SHOWN = '1'
+}