axel-setup 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -9,7 +9,15 @@ Releases are grouped by date and logical scope. npm package releases use semver
 
 ## [Unreleased]
 
-<!-- Nothing pending. -->
+---
+
+## [0.4.0] 2026-06-28 iTerm2 session theming add-on
+
+### Added
+- `extras/iterm-theming/` optional add-on (macOS + iTerm2 only): per-session tab color, directory plus git branch badge, `tabname`/`tabcolor` helpers, and an opt-in "Claude" dynamic profile (bigger badge, confirm-before-closing, unlimited scrollback). Installed explicitly via `extras/iterm-theming/install.sh` (idempotent, backs up `~/.zshrc`, ShellCheck-clean). Not run by `bootstrap.sh`, which stays additive to `~/.claude` only.
+
+### Changed
+- CI: `actions/checkout` bumped to v7 (#29) and `actions/setup-node` bumped to v6 (#27).
 
 ---
 

package/README.md

@@ -54,7 +54,7 @@ See [AXEL Multi-Runtime Roadmap](docs/roadmap/multi-runtime.md) for the adapter
 The recommended install path is directly through npx:
 
 ```bash
-npx axel-setup@0.3.0 --dry-run --user-name "Your Name"
+npx axel-setup@0.4.0 --dry-run --user-name "Your Name"
 ```
 
 By default AXEL uses `--profile core`, a public safe Claude Code install that keeps conservative permissions and skips optional side effects such as plugin installation, usage monitor launchd setup, keybindings, and the external GSD installer. Use `--profile personal` or `--profile full` when you explicitly want the fuller local automation setup.
@@ -62,7 +62,7 @@ By default AXEL uses `--profile core`, a public safe Claude Code install that ke
 Alternatively, for a macOS one-line installer, use the pinned curl wrapper. It checks for Claude Code, jq, zsh, and Node before delegating to the packaged npm release:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/cveralyon/axel-setup/v0.3.0/install.sh | bash -s -- --dry-run --user-name "Your Name"
+curl -fsSL https://raw.githubusercontent.com/cveralyon/axel-setup/v0.4.0/install.sh | bash -s -- --dry-run --user-name "Your Name"
 ```
 
 Before the first npm publish, use the same wrapper against the GitHub package source:
@@ -190,6 +190,17 @@ bash bootstrap.sh --dry-run
 
 **Safe to run multiple times.** The bootstrap is fully additive — it only adds what's missing, proposes upgrades for existing files, and never overwrites your configuration, memory, or CLAUDE.md.
 
+### Optional: iTerm2 session theming (macOS)
+
+A separate, opt-in add-on under [`extras/iterm-theming/`](extras/iterm-theming/) gives each iTerm2 session a distinct, stable tab color plus a directory and git branch badge, so parallel sessions are easy to tell apart at a glance. It is **not** run by `bootstrap.sh`: it is macOS + iTerm2 only, and it is the one component that writes outside `~/.claude` (to `~/.config/iterm`, `~/.zshrc`, and iTerm2 DynamicProfiles). Install it explicitly:
+
+```bash
+bash extras/iterm-theming/install.sh            # install (idempotent, backs up ~/.zshrc)
+bash extras/iterm-theming/install.sh --dry-run  # preview, change nothing
+```
+
+See [`extras/iterm-theming/README.md`](extras/iterm-theming/README.md) for what it does, the commands it adds, and how to revert.
+
 ## Prerequisites
 
 | Tool | Why | Install |

package/axel-manifest.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "package": {
     "name": "axel-setup",
-    "version": "0.3.0"
+    "version": "0.4.0"
   },
   "defaultTarget": "claude",
   "targets": {

package/install.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env sh
 set -eu
 
-AXEL_PACKAGE="${AXEL_SETUP_PACKAGE:-axel-setup@0.3.0}"
+AXEL_PACKAGE="${AXEL_SETUP_PACKAGE:-axel-setup@0.4.0}"
 AXEL_NPX="${AXEL_SETUP_NPX:-npx}"
 
 die() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axel-setup",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Claude Code-first team configuration package with hooks, agents, commands, skills, plugins, and repeatable bootstrap tooling.",
   "license": "MIT",
   "author": {