@antonior/claude-code-setup 2.0.1 → 2.0.3

package/README.md

@@ -41,6 +41,7 @@ The installer installs these for you if missing:
 | `jq` | hooks (JSON parsing) | **Required** — install aborts without it. |
 | `python3` | `transcript-search` MCP + video-FPS hook | Best-effort — feature stays dormant if it can't install. |
 | `ffmpeg` | `claude-video-vision` MCP | Best-effort. |
+| `tmux` | optional `cr` tmux launch workflow (lives in shell config, not shipped) | Best-effort. |
 | `git`, `eslint`, `tsc` | commit-scan / lint / typecheck hooks | Optional — hooks no-op cleanly when absent. |
 
 ## What it installs (into `~/.claude/`)
@@ -85,6 +86,34 @@ The installer reproduces **100% of the configuration and behaviour**. Two things
 1. **Log into Claude Code** (your account — you'd do this on any new machine anyway).
 2. **Give `claude-video-vision` your own API key** if you use video analysis.
 
+## Shell workflow (optional, not shipped)
+
+The package mirrors `~/.claude` only, so anything in your shell config (`~/.zshrc`) is **not** shipped. Add it per machine. These two bits drive how I launch Claude:
+
+**Start Claude in bypass mode** (skips per-tool permission prompts). Note: `skipDangerousModePermissionPrompt` in `settings.json` only suppresses the warning; this alias is what actually starts a session in bypass mode:
+
+```sh
+alias claude="claude --dangerously-skip-permissions"
+```
+
+**`cr` — launch Claude inside a tmux session** (named after the current directory, or pass a name: `cr myname`):
+
+```sh
+cr() {
+  local session="${1:-$(basename "$PWD")}"
+  session="${session//[.:]/_}"   # tmux treats . and : as target separators
+  if tmux has-session -t "$session" 2>/dev/null; then
+    tmux attach-session -t "$session"
+  else
+    tmux new-session -s "$session" -d -c "$PWD"
+    tmux send-keys -t "$session" "claude --dangerously-skip-permissions --remote-control '$session'" Enter
+    tmux attach-session -t "$session"
+  fi
+}
+```
+
+`cr` needs `tmux`, which the installer now installs best effort (see the dependencies table). After editing `~/.zshrc`, run `source ~/.zshrc` or open a new terminal.
+
 ## Maintaining (for me)
 
 The package is an exact mirror of my own `~/.claude`. To refresh it from my live config and publish:

package/bin/install.js

@@ -153,6 +153,7 @@ function main() {
     if (!brewInstall('jq', { required: true })) process.exit(1);
     brewInstall('python3');
     brewInstall('ffmpeg');
+    brewInstall('tmux');
   }
 
   // 2. Mirror every shipped config file into ~/.claude at the same relative
@@ -171,9 +172,37 @@ function main() {
   console.log(c.bold(c.green('\nDone. Restart Claude Code to apply.')));
   console.log(c.dim('Overwrites are backed up to <file>.bak. Unmanaged files already in ~/.claude are left untouched.'));
   if (!CONFIG_ONLY) {
-    console.log(c.dim('Two one-time steps on a new machine (identity, not config — they can\'t ship):'));
-    console.log(c.dim('  1. Log into Claude Code.'));
-    console.log(c.dim('  2. For video analysis, give claude-video-vision your own API key.\n'));
+    const bar = c.yellow('━'.repeat(64));
+    console.log(`
+${bar}
+${c.bold(c.yellow('  MANUAL STEPS: do these once on each machine'))}
+${c.dim('  (a package can only write ~/.claude; your shell config and your')}
+${c.dim('  account cannot ship, so set them up yourself)')}
+${bar}
+
+${c.bold('1) Shell setup')} — add to ${c.bold('~/.zshrc')}, then run: ${c.bold('source ~/.zshrc')}
+
+   ${c.dim('# start Claude in bypass mode (skips permission prompts)')}
+   alias claude="claude --dangerously-skip-permissions"
+
+   ${c.dim('# cr: open Claude in a tmux session named after the current dir')}
+   cr() {
+     local session="\${1:-$(basename "$PWD")}"
+     session="\${session//[.:]/_}"   # tmux treats . and : as separators
+     if tmux has-session -t "$session" 2>/dev/null; then
+       tmux attach-session -t "$session"
+     else
+       tmux new-session -s "$session" -d -c "$PWD"
+       tmux send-keys -t "$session" "claude --dangerously-skip-permissions --remote-control '$session'" Enter
+       tmux attach-session -t "$session"
+     fi
+   }
+
+${c.bold('2) Log into Claude Code')} (your account).
+${c.bold('3) claude-video-vision API key')}: add your own if you use video analysis.
+
+${bar}
+`);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antonior/claude-code-setup",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Install Antonio's full Claude Code setup: hooks, slash commands, skills, statusline, settings, and MCP servers (transcript-search + video-vision)",
   "bin": {
     "claude-code-setup": "bin/install.js"