codeforge-dev 1.4.0 → 1.5.1

package/.devcontainer/.env

@@ -17,6 +17,9 @@ SETUP_ALIASES=true
 # Setup: install official Anthropic plugins
 SETUP_PLUGINS=true
 
+# Setup: auto-update Claude Code CLI to latest on container start (runs in background)
+SETUP_UPDATE_CLAUDE=true
+
 # Plugin blacklist (comma-separated plugin names to skip during auto-install)
 # Example: PLUGIN_BLACKLIST="workflow-enhancer,auto-formatter"
-PLUGIN_BLACKLIST="workflow-enhancer"
+PLUGIN_BLACKLIST="workflow-enhancer,planning-reminder"

package/.devcontainer/CHANGELOG.md

@@ -1,5 +1,122 @@
 # CodeForge Devcontainer Changelog
 
+## [v1.5.0] - 2026-02-06
+
+### Added
+
+#### Agent Teams (Experimental)
+- **Claude Code Agent Teams**: Enabled via `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"` and `teammateMode: "auto"`
+- **System prompt guidance**: Agent Teams section with 3–5 active teammate limit and usage heuristics
+- **Task tracking**: `CLAUDE_CODE_ENABLE_TASKS: "true"` for structured task management
+- **Effort level**: `CLAUDE_CODE_EFFORT_LEVEL: "high"`
+
+#### Features
+- **tmux feature**: Split-pane terminal multiplexer for Agent Teams
+  - Pre-configured Catppuccin color palette, mouse support, 10,000-line scrollback
+  - Creates `claude-teams` session on container start
+- **Biome feature**: Fast JS/TS/JSON/CSS formatter via global `@biomejs/biome` install
+- **External terminal connectors**: Bash (`.sh`) and PowerShell (`.ps1`) scripts to connect host terminals to devcontainer tmux sessions
+- **Claude Code auto-update**: `setup-update-claude.sh` checks for newer Claude Code native binary on every container start
+  - Runs non-blocking in background via `setup.sh`
+  - Downloads from GCS, verifies SHA256 checksum, atomic binary replacement
+  - Controlled by `SETUP_UPDATE_CLAUDE` env var in `.env` (default: `true`)
+
+#### Plugins
+- **code-directive plugin**: Replaces `codedirective-skills` with expanded hook infrastructure
+  - **New skill**: `debugging` — Log forensics, Docker log analysis, error pattern recognition
+  - **Hooks**: `skill-suggester.py` (UserPromptSubmit, SubagentStart), `syntax-validator.py` + `collect-edited-files.py` (PostToolUse)
+  - All 10 existing skills migrated from `codedirective-skills`
+
+#### VS Code Extensions
+- `GitHub.vscode-github-actions` — GitHub Actions workflow support
+- `fabiospampinato.vscode-todo-plus` — Todo+ task management
+
+### Changed
+
+- **Default model**: Claude Opus 4-5 → **Claude Opus 4-6** (frontier)
+- **Max output tokens**: 64,000 → **128,000**
+- **Container memory**: 3GB → **4GB** (`--memory-swap` raised to 8GB)
+- **External terminal connectors**: Now run as `vscode` user and auto-launch `cc` on new tmux sessions
+- **Auto-formatter**: Switched from PostToolUse (`format-file.py`) to Stop hook (`format-on-stop.py`)
+  - Added Biome support for JS/TS/CSS alongside existing Black and gofmt
+  - Batch-formats all edited files when Claude stops instead of formatting on every edit
+- **Auto-linter**: Switched from PostToolUse to Stop hook
+- **Agent-browser**: Optimized to install only Chromium (previously installed all Playwright browsers)
+
+### Removed
+
+- **codedirective-skills plugin**: Replaced by `code-directive` (all skills preserved)
+- **format-file.py**: Replaced by `format-on-stop.py`
+- **`CLAUDE_CODE_SUBAGENT_MODEL`**: Environment variable removed (no longer needed)
+
+### Gitignore
+
+- Added `claude-dev-discord-logs/`, `devforge/`
+
+---
+
+## [v1.4.0] - 2026-02-01
+
+### Breaking
+
+- **Package rename**: `claudepod` → `codeforge-dev` on npm. Install via `npx codeforge-dev`
+- **Full rebrand**: All references renamed from ClaudePod/claudepod to CodeForge/codeforge
+
+### Added
+
+#### Plugins
+- **codedirective-skills plugin**: 9 coding reference skills for the CodeDirective tech stack
+  - `fastapi` - Routing, middleware, SSE, Pydantic models
+  - `pydantic-ai` - Agents, tools, models, streaming
+  - `svelte5` - Runes, reactivity, components, routing, dnd, LayerCake, AI SDK
+  - `sqlite` - Python/JS patterns, schema, pragmas, advanced queries
+  - `docker` - Dockerfile patterns, Compose services
+  - `docker-py` - Container lifecycle, resources, security
+  - `claude-code-headless` - CLI flags, output, SDK/MCP
+  - `testing` - FastAPI and Svelte testing patterns
+  - `skill-building` - Meta-skill for authoring skills
+- **codeforge-lsp plugin**: Replaces `claudepod-lsp` with identical functionality
+- **Svelte MCP plugin**: Added `svelte@sveltejs/mcp` to official plugins
+- **Plugin blacklist system**: `PLUGIN_BLACKLIST` env var in `.env` to skip plugins during auto-install
+  - Parsed by `is_blacklisted()` helper in `setup-plugins.sh`
+  - Default: `workflow-enhancer` blacklisted
+
+#### System Prompt
+- **`<execution_discipline>`**: Verify before assuming, read before writing, instruction fidelity, verify after writing, no silent deviations
+- **`<professional_objectivity>`**: Prioritize technical accuracy over agreement, direct measured language
+- **`<structural_search>`**: ast-grep and tree-sitter usage guidance with when-to-use-which
+- **Scope discipline**: Modify only what the task requires, trust internal code, prefer inline clarity
+- **Continuation sessions**: Re-read source files after compaction, verify state before changes
+- **Brevity additions**: No problem restatement, no filler/narrative, no time estimates
+
+#### DevContainer
+- **Bun runtime**: Added `ghcr.io/rails/devcontainer/features/bun:1.0.2`
+- **Playwright browsers**: Installed via `npx playwright install --with-deps` in agent-browser feature
+- **Memory cap**: Container limited to 3GB via `--memory=3g --memory-swap=3g`
+- **TMPDIR**: Set to `/workspaces/.tmp`
+- **VS Code remote extension**: `wenbopan.vscode-terminal-osc-notifier` configured as UI extension
+
+### Changed
+
+- **Permission model**: `--dangerously-skip-permissions` → `--permission-mode plan --allow-dangerously-skip-permissions`
+- **Settings**: `autoCompact: true`, `alwaysThinkingEnabled: true`
+- **Autocompact threshold**: 80% → 95%
+- **Cleanup period**: 360 days → 60 days
+- **Tool search**: Added `ENABLE_TOOL_SEARCH: "auto:5"`
+- **Tree-sitter**: Removed Go grammar from defaults
+- **Ticket-workflow commands**: Renamed `ticket:` → `ticket꞉` for cross-platform filesystem compatibility
+- **notify-hook**: Added empty `matcher` field to hooks.json schema
+
+### Removed
+
+- **claudepod-lsp plugin**: Replaced by `codeforge-lsp`
+
+### Gitignore
+
+- Added `code-directive/`, `article/`, `claude-research/`, `dashboard/`, `simple-review/`, `workflow-enhancer/`
+
+---
+
 ## [v1.3.1] - 2025-01-24
 
 ### Fixed

package/.devcontainer/README.md

@@ -1,7 +1,7 @@
 # CodeForge DevContainer
 
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL%203.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![npm version](https://img.shields.io/npm/v/codeforge.svg)](https://www.npmjs.com/package/codeforge)
+[![npm version](https://img.shields.io/npm/v/codeforge-dev.svg)](https://www.npmjs.com/package/codeforge-dev)
 
 A curated development environment optimized for AI-powered coding with Claude Code. CodeForge comes pre-configured with language servers, code intelligence tools, and official Anthropic plugins to streamline your development workflow.
 
@@ -125,6 +125,8 @@ GitHub CLI credentials are automatically persisted across container rebuilds. Th
 | `git` | Version control |
 | `jq` | JSON processor |
 | `curl` | HTTP client |
+| `tmux` | Terminal multiplexer for Agent Teams split-pane sessions |
+| `biome` | Fast JS/TS/JSON/CSS formatter |
 | `agent-browser` | Headless browser automation for AI agents |
 
 ### Code Intelligence
@@ -187,9 +189,9 @@ Edit `.devcontainer/.env` to customize behavior:
 Default settings are in `.devcontainer/config/settings.json`. These are copied to `/workspaces/.claude/settings.json` on first run.
 
 Key defaults:
-- **Model**: Claude Opus 4.5
+- **Model**: Claude Opus 4-6
 - **Default mode**: Plan (prompts before executing)
-- **Max output tokens**: 64,000
+- **Max output tokens**: 128,000
 
 ### System Prompt
 
@@ -207,6 +209,8 @@ CodeForge includes several custom devcontainer features:
 | `ast-grep` | Structural code search using AST patterns |
 | `tree-sitter` | Parser with JS/TS/Python grammars |
 | `lsp-servers` | Pyright and TypeScript language servers |
+| `tmux` | Terminal multiplexer with Catppuccin theme for Agent Teams |
+| `biome` | Fast JS/TS/JSON/CSS formatter (global install) |
 
 ## Essential Gotchas
 

package/.devcontainer/config/main-system-prompt.md

@@ -123,6 +123,13 @@ Subagents (via `Task`):
 - Report findings; never decide or modify
 - Types: `Explore` (fast search), `Plan` (design), `general-purpose` (complex), `Bash` (commands)
 
+Agent Teams (when enabled):
+- CRITICAL: Limit to 3-5 active teammates maximum based on task complexity
+- Simple tasks: no team needed; moderate: 2-3 teammates; complex multi-layer: up to 5
+- Use teams for: parallel investigation, cross-layer work (frontend/backend/tests), competing hypotheses
+- Avoid teams for: sequential tasks, same-file edits, simple changes, routine work
+- Always clean up teams when work completes
+
 Parallelization:
 - Parallel: independent searches, multi-file reads, different perspectives
 - Sequential: when output feeds next step, cumulative context needed
@@ -233,6 +240,9 @@ Write minimal code that satisfies requirements.
 
 Non-trivial changes require an approved plan — see <execution_gate>.
 
+When spawning agent teams, assess complexity first. Never exceed 5 active
+teammates — this is a hard limit to control token costs and coordination overhead.
+
 Address concrete problems present in the codebase.
 
 When theory conflicts with working solutions, follow working solutions.

package/.devcontainer/config/settings.json

@@ -3,15 +3,14 @@
   "autoCompact": true,
   "alwaysThinkingEnabled": true,
   "env": {
-    "ANTHROPIC_MODEL": "claude-opus-4-5-20251101",
-    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-4-5-20251101",
-    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101",
+    "ANTHROPIC_MODEL": "claude-opus-4-6",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
     "BASH_DEFAULT_TIMEOUT_MS": "240000",
     "BASH_MAX_TIMEOUT_MS": "600000",
     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "true",
-    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
+    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000",
     "MAX_MCP_OUTPUT_TOKENS": "10000",
     "MAX_THINKING_TOKENS": "63999",
     "MCP_TIMEOUT": "120000",
@@ -19,8 +18,13 @@
     "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": 95,
     "CLAUDE_CODE_SHELL": "zsh",
     "FORCE_AUTOUPDATE_PLUGINS": true,
-    "ENABLE_TOOL_SEARCH": "auto:5"
+    "ENABLE_TOOL_SEARCH": "auto:5",
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "CLAUDE_CODE_EFFORT_LEVEL": "high",
+    "CLAUDE_CODE_ENABLE_TASKS": "true"
   },
+  "teammateMode": "auto",
+  "effortLevel": "high",
   "includeCoAuthoredBy": false,
   "permissions": {
     "allow": [

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

@@ -0,0 +1,86 @@
+#
+# Connect to CodeForge devcontainer from external terminal with tmux
+# For Claude Code Agent Teams split-pane support
+#
+# Usage: .\connect-external-terminal.ps1
+#
+# Prerequisites:
+#   - Docker Desktop installed and running
+#   - Devcontainer already running (via VS Code or CLI)
+#
+# This script will:
+#   1. Auto-detect your running devcontainer
+#   2. Attach to it with an interactive shell
+#   3. Start or attach to a tmux session named "claude-teams"
+#
+
+$ErrorActionPreference = "Stop"
+
+$TMUX_SESSION = "claude-teams"
+$CONTAINER_LABEL = "devcontainer.local_folder"
+
+Write-Host "======================================"
+Write-Host "  CodeForge External Terminal Connect"
+Write-Host "======================================"
+Write-Host ""
+
+# Find the devcontainer
+Write-Host "Searching for running devcontainer..."
+
+try {
+    $CONTAINER_ID = docker ps --filter "label=$CONTAINER_LABEL" --format "{{.ID}}" | Select-Object -First 1
+} catch {
+    Write-Host ""
+    Write-Host "ERROR: Docker command failed. Is Docker Desktop running?" -ForegroundColor Red
+    Write-Host ""
+    exit 1
+}
+
+if ([string]::IsNullOrWhiteSpace($CONTAINER_ID)) {
+    Write-Host ""
+    Write-Host "ERROR: No running devcontainer found." -ForegroundColor Red
+    Write-Host ""
+    Write-Host "Make sure your devcontainer is running:"
+    Write-Host "  1. Open VS Code"
+    Write-Host "  2. Open the folder containing .devcontainer/"
+    Write-Host "  3. Use 'Dev Containers: Reopen in Container'"
+    Write-Host ""
+    exit 1
+}
+
+# Get container name for display
+$CONTAINER_NAME = docker ps --filter "id=$CONTAINER_ID" --format "{{.Names}}"
+Write-Host "Found container: $CONTAINER_NAME ($CONTAINER_ID)"
+Write-Host ""
+
+# Check if tmux is available in the container
+$tmuxCheck = docker exec $CONTAINER_ID which tmux 2>$null
+if ([string]::IsNullOrWhiteSpace($tmuxCheck)) {
+    Write-Host "ERROR: tmux is not installed in the container." -ForegroundColor Red
+    Write-Host "Rebuild the devcontainer to install the tmux feature."
+    exit 1
+}
+
+Write-Host "Connecting to tmux session '$TMUX_SESSION'..."
+Write-Host ""
+Write-Host "Tips:"
+Write-Host "  - Agent Teams will use this terminal for split panes"
+Write-Host "  - Run 'claude' to start Claude Code"
+Write-Host "  - Press Ctrl+B then D to detach (keeps session running)"
+Write-Host "  - Mouse support is enabled for pane selection"
+Write-Host ""
+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 "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux 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'
+  fi
+"

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

@@ -0,0 +1,78 @@
+#!/bin/bash
+#
+# Connect to CodeForge devcontainer from external terminal with tmux
+# For Claude Code Agent Teams split-pane support
+#
+# Usage: ./connect-external-terminal.sh
+#
+# Prerequisites:
+#   - Docker installed and running
+#   - Devcontainer already running (via VS Code or CLI)
+#
+# This script will:
+#   1. Auto-detect your running devcontainer
+#   2. Attach to it with an interactive shell
+#   3. Start or attach to a tmux session named "claude-teams"
+#
+
+set -e
+
+TMUX_SESSION="claude-teams"
+CONTAINER_LABEL="devcontainer.local_folder"
+
+echo "======================================"
+echo "  CodeForge External Terminal Connect"
+echo "======================================"
+echo ""
+
+# Find the devcontainer
+echo "Searching for running devcontainer..."
+CONTAINER_ID=$(docker ps --filter "label=$CONTAINER_LABEL" --format "{{.ID}}" | head -n1)
+
+if [ -z "$CONTAINER_ID" ]; then
+    echo ""
+    echo "ERROR: No running devcontainer found."
+    echo ""
+    echo "Make sure your devcontainer is running:"
+    echo "  1. Open VS Code"
+    echo "  2. Open the folder containing .devcontainer/"
+    echo "  3. Use 'Dev Containers: Reopen in Container'"
+    echo ""
+    exit 1
+fi
+
+# Get container name for display
+CONTAINER_NAME=$(docker ps --filter "id=$CONTAINER_ID" --format "{{.Names}}")
+echo "Found container: $CONTAINER_NAME ($CONTAINER_ID)"
+echo ""
+
+# Check if tmux is available in the container
+if ! docker exec "$CONTAINER_ID" which tmux > /dev/null 2>&1; then
+    echo "ERROR: tmux is not installed in the container."
+    echo "Rebuild the devcontainer to install the tmux feature."
+    exit 1
+fi
+
+echo "Connecting to tmux session '$TMUX_SESSION'..."
+echo ""
+echo "Tips:"
+echo "  - Agent Teams will use this terminal for split panes"
+echo "  - Run 'claude' to start Claude Code"
+echo "  - Press Ctrl+B then D to detach (keeps session running)"
+echo "  - Mouse support is enabled for pane selection"
+echo ""
+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 "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux 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'
+  fi
+"

package/.devcontainer/devcontainer.json

@@ -20,6 +20,7 @@
     "ghcr.io/devcontainers/features/go",
     "ghcr.io/rails/devcontainer/features/bun",
     "ghcr.io/anthropics/devcontainer-features/claude-code",
+    "./features/tmux",
     "./features/agent-browser",
     "./features/claude-monitor",
     "./features/ccusage",
@@ -27,6 +28,7 @@
     "./features/ast-grep",
     "./features/tree-sitter",
     "./features/lsp-servers",
+    "./features/biome",
     "./features/notify-hook"
   ],
 
@@ -41,9 +43,9 @@
       "moby": false
     },
     "ghcr.io/devcontainers-extra/features/uv:1": {},
-    "ghcr.io/devcontainers/features/go:1": {},
     "ghcr.io/rails/devcontainer/features/bun:1.0.2": {},
     "ghcr.io/anthropics/devcontainer-features/claude-code:1": {},
+    "./features/tmux": {},
     "./features/ccusage": {
       "version": "latest",
       "shells": "both",
@@ -61,6 +63,7 @@
     "./features/tree-sitter": {},
     "./features/lsp-servers": {},
     "./features/agent-browser": {},
+    "./features/biome": {},
     "./features/notify-hook": {
       "enableBell": true,
       "enableOsc": true
@@ -82,13 +85,15 @@
         }
       },
       "extensions": [
-        "wenbopan.vscode-terminal-osc-notifier"
+        "wenbopan.vscode-terminal-osc-notifier",
+        "GitHub.vscode-github-actions",
+        "fabiospampinato.vscode-todo-plus"
       ]
     }
   },
 
   "runArgs": [
-    "--memory=3g",
-    "--memory-swap=3g"
+    "--memory=4g",
+    "--memory-swap=8g"
   ]
 }

package/.devcontainer/features/agent-browser/install.sh

@@ -58,11 +58,11 @@ agent-browser install --with-deps 2>/dev/null || {
     agent-browser install 2>/dev/null || true
 }
 
-# Install Playwright browsers and dependencies
-echo "[agent-browser] Installing Playwright browsers..."
-npx playwright install --with-deps 2>/dev/null || {
-    echo "[agent-browser] WARNING: Playwright install with deps failed, trying without --with-deps"
-    npx playwright install 2>/dev/null || true
+# Install Playwright Chromium only (not all browsers)
+echo "[agent-browser] Installing Playwright Chromium..."
+npx playwright install chromium --with-deps 2>/dev/null || {
+    echo "[agent-browser] WARNING: Playwright chromium install with deps failed, trying without --with-deps"
+    npx playwright install chromium 2>/dev/null || true
 }
 
 echo "[agent-browser] Installed: $(agent-browser --version 2>/dev/null || echo 'unknown')"

package/.devcontainer/features/biome/devcontainer-feature.json

@@ -0,0 +1,16 @@
+{
+  "id": "biome",
+  "version": "1.0.0",
+  "name": "Biome",
+  "description": "Fast JS/TS/JSON/CSS formatter and linter",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "latest",
+      "description": "Biome version to install"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/node"
+  ]
+}

package/.devcontainer/features/biome/install.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+set -euo pipefail
+
+VERSION="${VERSION:-latest}"
+
+echo "[biome] Starting installation..."
+echo "[biome] Version: ${VERSION}"
+
+# Install Biome globally via npm
+if [ "${VERSION}" = "latest" ]; then
+    npm install -g @biomejs/biome
+else
+    npm install -g "@biomejs/biome@${VERSION}"
+fi
+
+# Verify installation
+biome --version
+
+echo "[biome] Installation complete"

package/.devcontainer/features/tmux/README.md

@@ -0,0 +1,75 @@
+# tmux Terminal Multiplexer
+
+Installs tmux for Claude Code Agent Teams split-pane support.
+
+## What This Provides
+
+- **tmux** terminal multiplexer for managing multiple terminal sessions
+- Pre-configured for Claude Code Agent Teams with optimized settings
+- Mouse support enabled for easy pane navigation
+- Clean status bar showing session info
+
+## Claude Code Agent Teams Integration
+
+When Agent Teams are enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`) and `teammateMode` is set to `"auto"` or `"tmux"`, Claude Code will automatically use tmux for split-pane display of teammates.
+
+### VS Code Terminal Limitation
+
+The VS Code integrated terminal does **not** support tmux split panes. To use split-pane mode with Agent Teams, you need to connect via an external terminal.
+
+## Using External Terminal for Split Panes
+
+### Option 1: Helper Scripts (Recommended)
+
+Use the provided helper scripts in the `.devcontainer/` folder:
+
+**Linux/macOS:**
+```bash
+cd /path/to/your/project/.devcontainer
+./connect-external-terminal.sh
+```
+
+**Windows (PowerShell):**
+```powershell
+cd C:\path\to\your\project\.devcontainer
+.\connect-external-terminal.ps1
+```
+
+### Option 2: Manual Connection
+
+1. Find your container ID:
+   ```bash
+   docker ps --filter "label=devcontainer.local_folder" --format "{{.ID}}"
+   ```
+
+2. Connect with tmux:
+   ```bash
+   docker exec -it <container-id> tmux new-session -A -s claude-teams
+   ```
+
+## tmux Quick Reference
+
+| Key | Action |
+|-----|--------|
+| `Ctrl+B %` | Split pane vertically |
+| `Ctrl+B "` | Split pane horizontally |
+| `Ctrl+B arrow` | Navigate between panes |
+| `Ctrl+B d` | Detach from session |
+| `Ctrl+B [` | Enter scroll mode (q to exit) |
+
+Mouse support is enabled - click to select panes, drag borders to resize.
+
+## Prerequisites for Host Machine
+
+### Linux
+- Docker installed and running
+- Any terminal emulator (GNOME Terminal, Konsole, Alacritty, etc.)
+
+### Windows
+- Docker Desktop installed and running
+- Windows Terminal or PowerShell
+- No additional software needed - tmux runs inside the container
+
+### macOS
+- Docker Desktop installed and running
+- Terminal.app, iTerm2, or any terminal emulator

package/.devcontainer/features/tmux/devcontainer-feature.json

@@ -0,0 +1,17 @@
+{
+  "id": "tmux",
+  "version": "1.0.0",
+  "name": "tmux Terminal Multiplexer",
+  "description": "Installs tmux for Claude Code Agent Teams split-pane support",
+  "documentationURL": "https://github.com/AnExiledDev/CodeForge",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "tmux version to install (or 'latest' for system package)",
+      "default": "latest"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils:2"
+  ]
+}

package/.devcontainer/features/tmux/install.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+set -e
+
+echo "Installing tmux for Claude Code Agent Teams..."
+
+# Install tmux via apt
+apt-get update
+apt-get install -y tmux
+
+# Create a basic tmux config optimized for Claude Code teams
+TMUX_CONF="/etc/tmux.conf"
+cat > "$TMUX_CONF" << 'EOF'
+# Claude Code Agent Teams - tmux configuration
+
+# Enable mouse support for pane selection
+set -g mouse on
+
+# Start window numbering at 1
+set -g base-index 1
+setw -g pane-base-index 1
+
+# Increase scrollback buffer
+set -g history-limit 10000
+
+# Reduce escape time for better responsiveness
+set -sg escape-time 10
+
+# Status bar configuration
+set -g status-style 'bg=#1e1e2e fg=#cdd6f4'
+set -g status-left '[#S] '
+set -g status-right '%H:%M '
+set -g status-left-length 20
+
+# Pane border styling
+set -g pane-border-style 'fg=#45475a'
+set -g pane-active-border-style 'fg=#89b4fa'
+
+# Window status
+setw -g window-status-current-style 'fg=#1e1e2e bg=#89b4fa bold'
+setw -g window-status-current-format ' #I:#W '
+setw -g window-status-style 'fg=#cdd6f4'
+setw -g window-status-format ' #I:#W '
+
+# Enable true color support
+set -g default-terminal "tmux-256color"
+set -ga terminal-overrides ",*256col*:Tc"
+EOF
+
+echo "tmux installed successfully"
+echo "  - Config: $TMUX_CONF"
+echo "  - Use 'tmux new -s claude-teams' to start a session"
+echo "  - Claude Code Agent Teams will auto-detect tmux when available"

package/.devcontainer/plugins/devs-marketplace/.claude-plugin/marketplace.json

@@ -96,10 +96,10 @@
       "category": "development"
     },
     {
-      "name": "codedirective-skills",
+      "name": "code-directive",
       "description": "Coding standards and skills for the CodeDirective project",
       "version": "1.0.0",
-      "source": "./plugins/codedirective-skills",
+      "source": "./plugins/code-directive",
       "category": "development"
     }
   ]

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-formatter",
-  "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
+  "description": "Batch-formats edited files at Stop (Black for Python, gofmt for Go, Biome for JS/TS/CSS)",
   "author": {
     "name": "AnExiledDev"
   }