codeforge-dev 1.5.5 → 1.5.6

package/.devcontainer/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CodeForge Devcontainer Changelog
 
+## [v1.5.6] - 2026-02-06
+
+### Added
+
+- **tmux as default terminal**: All terminals (VS Code, WezTerm, docker exec) now auto-enter tmux `claude-teams` session. Ensures `$TMUX` is always set so Agent Teams `teammateMode: "auto"` uses split panes
+  - VS Code: Added `tmux` terminal profile as default in `devcontainer.json` (`tmux -u new-session -A -s claude-teams`)
+  - All shells: Auto-enter tmux block in `.bashrc`/`.zshrc` via `setup-aliases.sh` (guarded: skips if already in tmux, non-interactive, or tmux not installed)
+  - Plain `bash` profile kept as alternative in VS Code
+
+---
+
 ## [v1.5.3] - 2026-02-06
 
 ### Added

package/.devcontainer/README.md

@@ -150,10 +150,7 @@ GitHub CLI credentials are automatically persisted across container rebuilds. Th
 
 ### The `cc` Command
 
-The `cc` command is a wrapper that:
-- Creates a project-local `.claude/` directory if missing
-- Copies default configuration files
-- Launches Claude Code with the project's system prompt
+The `cc` command is an alias that launches Claude Code with the project's system prompt and plan-mode permissions. All terminals (VS Code, WezTerm, docker exec) auto-enter a tmux `claude-teams` session for Agent Teams split-pane support.
 
 ```bash
 cc                    # Start Claude Code in current directory
@@ -216,8 +213,9 @@ CodeForge includes several custom devcontainer features:
 
 - **Authentication required**: Run `claude` once to authenticate before using `cc`
 - **Plan mode default**: The container starts in "plan" mode, which prompts for approval before making changes
-- **Project-local config**: The `cc` command creates `.claude/` in your current directory for project-specific settings
+- **Project-local config**: Config files are auto-copied to `.claude/` on container start via `setup-config.sh`
 - **GitHub auth persists**: Run `gh auth login` once; credentials survive container rebuilds (stored in `/workspaces/.gh/`)
+- **Terminals auto-enter tmux**: All interactive shells auto-enter the `claude-teams` tmux session for Agent Teams split panes. Use the `bash` terminal profile in VS Code if you need a plain shell
 
 ## Further Reading
 

package/.devcontainer/devcontainer.json

@@ -78,7 +78,16 @@
   "customizations": {
     "vscode": {
       "settings": {
-        "terminal.integrated.defaultProfile.linux": "bash",
+        "terminal.integrated.profiles.linux": {
+          "tmux": {
+            "path": "tmux",
+            "args": ["-u", "new-session", "-A", "-s", "claude-teams"]
+          },
+          "bash": {
+            "path": "bash"
+          }
+        },
+        "terminal.integrated.defaultProfile.linux": "tmux",
         "terminal.integrated.enableBell": true,
         "remote.extensionKind": {
           "wenbopan.vscode-terminal-osc-notifier": ["ui"]

package/.devcontainer/scripts/setup-aliases.sh

@@ -47,7 +47,7 @@ for rc in ~/.bashrc ~/.zshrc; do
             sed -i '/alias specwright=/d' "$rc"
         fi
 
-        # --- Add environment and aliases ---
+        # --- Add environment, auto-tmux, and aliases ---
         echo "" >> "$rc"
         echo "# Claude Code environment and aliases (managed by setup-aliases.sh)" >> "$rc"
         # Export CLAUDE_CONFIG_DIR so it's available in all shells (not just VS Code remoteEnv)
@@ -59,6 +59,17 @@ for rc in ~/.bashrc ~/.zshrc; do
             echo 'export LANG=en_US.UTF-8' >> "$rc"
             echo 'export LC_ALL=en_US.UTF-8' >> "$rc"
         fi
+        # Auto-enter tmux for Agent Teams split-pane support
+        # Guards: not already in tmux, interactive shell only, tmux available
+        if ! grep -q 'Auto-enter tmux' "$rc" 2>/dev/null; then
+            cat >> "$rc" << 'TMUX_BLOCK'
+
+# Auto-enter tmux for Agent Teams split-pane support
+if [ -z "$TMUX" ] && [ -n "$PS1" ] && command -v tmux &>/dev/null; then
+    exec tmux -u new-session -A -s claude-teams
+fi
+TMUX_BLOCK
+        fi
         echo "$ALIAS_CC" >> "$rc"
         echo "$ALIAS_CLAUDE" >> "$rc"
         echo "$ALIAS_CCRAW" >> "$rc"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeforge-dev",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "description": "Complete development container that sets up Claude Code with modular devcontainer features, modern dev tools, and persistent configurations. Drop it into any project and get a production-ready AI development environment in minutes.",
   "main": "setup.js",
   "bin": {