codeforge-dev 1.5.4 → 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
@@ -9,6 +20,7 @@
 ### Fixed
 
 - **ccstatusline powerline glyphs**: Powerline separators/caps were empty strings, rendering as underscores. Now uses proper Nerd Font glyphs (U+E0B0, U+E0B4, U+E0B6)
+- **Unicode rendering in external terminals**: tmux rendered ALL Unicode as underscores because `docker exec` doesn't propagate locale vars. External terminal scripts now pass `LANG`/`LC_ALL=en_US.UTF-8` and use `tmux -u` to force UTF-8 mode. Locale exports also added to `.bashrc`/`.zshrc` as permanent fallback
 
 ### Fixed
 

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/connect-external-terminal.ps1

@@ -73,14 +73,18 @@ Write-Host "======================================"
 Write-Host ""
 
 # Connect to container with tmux as vscode user (where aliases are defined)
-# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
-docker exec -it --user vscode $CONTAINER_ID bash -c "
+# Pass UTF-8 locale so tmux renders Unicode correctly (not as underscores)
+docker exec -it `
+  -e LANG=en_US.UTF-8 `
+  -e LC_ALL=en_US.UTF-8 `
+  --user vscode $CONTAINER_ID bash -c "
+  export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
   if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
-    tmux attach-session -t '$TMUX_SESSION'
+    tmux -u attach-session -t '$TMUX_SESSION'
   else
-    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    tmux -u new-session -d -s '$TMUX_SESSION' -c /workspaces
     sleep 0.5
     tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
-    tmux attach-session -t '$TMUX_SESSION'
+    tmux -u attach-session -t '$TMUX_SESSION'
   fi
 "

package/.devcontainer/connect-external-terminal.sh

@@ -65,14 +65,19 @@ echo "======================================"
 echo ""
 
 # Connect to container with tmux as vscode user (where aliases are defined)
-# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
-exec docker exec -it --user vscode "$CONTAINER_ID" bash -c "
+# Pass UTF-8 locale so tmux renders Unicode correctly (not as underscores)
+# Use tmux -u to force UTF-8 mode as a belt-and-suspenders measure
+exec docker exec -it \
+  -e LANG=en_US.UTF-8 \
+  -e LC_ALL=en_US.UTF-8 \
+  --user vscode "$CONTAINER_ID" bash -c "
+  export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
   if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
-    tmux attach-session -t '$TMUX_SESSION'
+    tmux -u attach-session -t '$TMUX_SESSION'
   else
-    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    tmux -u new-session -d -s '$TMUX_SESSION' -c /workspaces
     sleep 0.5
     tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
-    tmux attach-session -t '$TMUX_SESSION'
+    tmux -u attach-session -t '$TMUX_SESSION'
   fi
 "

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,13 +47,29 @@ 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)
         if ! grep -q 'export CLAUDE_CONFIG_DIR=' "$rc" 2>/dev/null; then
             echo "export CLAUDE_CONFIG_DIR=\"${CLAUDE_CONFIG_DIR}\"" >> "$rc"
         fi
+        # Export UTF-8 locale so tmux renders Unicode correctly (docker exec doesn't inherit locale)
+        if ! grep -q 'export LANG=en_US.UTF-8' "$rc" 2>/dev/null; then
+            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.4",
+  "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": {