codeforge-dev 1.7.0 → 1.9.0

package/.devcontainer/scripts/setup.sh

@@ -1,8 +1,6 @@
 #!/bin/bash
 # Master setup script for CodeForge devcontainer
 
-set -e
-
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 DEVCONTAINER_DIR="$(dirname "$SCRIPT_DIR")"
 ENV_FILE="$DEVCONTAINER_DIR/.env"
@@ -19,13 +17,15 @@ fi
 : "${CONFIG_SOURCE_DIR:=$DEVCONTAINER_DIR/config}"
 : "${SETUP_CONFIG:=true}"
 : "${SETUP_ALIASES:=true}"
-: "${OVERWRITE_CONFIG:=false}"
+: "${SETUP_AUTH:=true}"
 : "${SETUP_PLUGINS:=true}"
 : "${SETUP_UPDATE_CLAUDE:=true}"
 : "${SETUP_PROJECTS:=true}"
 
-export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS SETUP_UPDATE_CLAUDE SETUP_PROJECTS
+export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES SETUP_AUTH SETUP_PLUGINS SETUP_UPDATE_CLAUDE SETUP_PROJECTS
 
+SETUP_START=$(date +%s)
+SETUP_RESULTS=()
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  CodeForge Setup"
@@ -35,22 +35,31 @@ echo ""
 run_script() {
     local script="$1"
     local enabled="$2"
-    local name="$(basename $script .sh)"
+    local name
+    name="$(basename "$script" .sh)"
 
     if [ "$enabled" = "true" ]; then
         if [ -f "$script" ]; then
-            echo "Running $name..."
-            bash "$script"
-            echo ""
+            printf "  %-30s" "$name..."
+            if bash "$script" 2>&1; then
+                echo "done"
+                SETUP_RESULTS+=("$name:ok")
+            else
+                echo "FAILED (exit $?)"
+                SETUP_RESULTS+=("$name:failed")
+            fi
         else
-            echo "WARNING: $script not found, skipping"
+            echo "  $name... not found, skipping"
+            SETUP_RESULTS+=("$name:missing")
         fi
     else
-        echo "Skipping $name (disabled)"
+        echo "  $name... skipped (disabled)"
+        SETUP_RESULTS+=("$name:disabled")
     fi
 }
 
 run_script "$SCRIPT_DIR/setup-symlink-claude.sh" "true"
+run_script "$SCRIPT_DIR/setup-auth.sh" "$SETUP_AUTH"
 run_script "$SCRIPT_DIR/setup-config.sh" "$SETUP_CONFIG"
 run_script "$SCRIPT_DIR/setup-aliases.sh" "$SETUP_ALIASES"
 run_script "$SCRIPT_DIR/setup-plugins.sh" "$SETUP_PLUGINS"
@@ -59,14 +68,38 @@ run_script "$SCRIPT_DIR/setup-projects.sh" "$SETUP_PROJECTS"
 # Non-blocking: check for Claude Code updates in background
 if [ "$SETUP_UPDATE_CLAUDE" = "true" ]; then
     if [ -f "$SCRIPT_DIR/setup-update-claude.sh" ]; then
-        echo "Running setup-update-claude (background)..."
+        echo "  Claude Code update checking in background..."
+        echo "  (If 'claude' fails, wait a moment and retry)"
         bash "$SCRIPT_DIR/setup-update-claude.sh" &
         disown
+        SETUP_RESULTS+=("setup-update-claude:ok")
+    else
+        SETUP_RESULTS+=("setup-update-claude:missing")
     fi
 else
-    echo "Skipping setup-update-claude (disabled)"
+    echo "  setup-update-claude... skipped (disabled)"
+    SETUP_RESULTS+=("setup-update-claude:disabled")
 fi
 
+echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Setup Complete"
+echo "  Setup Summary"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+FAILURES=0
+for result in "${SETUP_RESULTS[@]}"; do
+    name="${result%%:*}"
+    status="${result##*:}"
+    case "$status" in
+        ok)       printf "  ✓ %s\n" "$name" ;;
+        failed)   printf "  ✗ %s (FAILED)\n" "$name"; FAILURES=$((FAILURES + 1)) ;;
+        disabled) printf "  - %s (disabled)\n" "$name" ;;
+        missing)  printf "  ? %s (not found)\n" "$name" ;;
+    esac
+done
+ELAPSED=$(( $(date +%s) - SETUP_START ))
+echo ""
+if [ $FAILURES -gt 0 ]; then
+    echo "  $FAILURES step(s) failed. Check output above for details."
+fi
+echo "  Completed in ${ELAPSED}s"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/README.md

@@ -37,215 +37,46 @@ npx codeforge-dev@1.2.3
 
 - **Docker Desktop** (or compatible container runtime like Podman)
 - **VS Code** with the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers), or **GitHub Codespaces**
-- **Claude Code authentication** - see [Authentication](#authentication) section
+- **Claude Code authentication** — run `claude` on first start to authenticate
 
-## Quick Start
-
-1. **Open in Container**
-   - VS Code: Open the folder, then select "Reopen in Container" from the command palette
-   - Codespaces: Create a new codespace from this repository
-
-2. **Authenticate** (first time only)
-   ```bash
-   claude
-   ```
-   Follow the prompts to authenticate via browser or API key.
-
-3. **Start Claude Code**
-   ```bash
-   cc
-   ```
-
-## Authentication
-
-Claude Code supports multiple authentication methods. On first run, you'll be prompted to choose:
-
-### Browser Login (Recommended)
-
-```bash
-claude
-```
-
-Select "Login with browser" and complete authentication in your browser. This uses your Claude.ai account.
-
-### API Key
-
-For programmatic access or environments without browsers:
-
-```bash
-export ANTHROPIC_API_KEY="sk-ant-..."
-claude
-```
-
-Get an API key from [console.anthropic.com](https://console.anthropic.com/).
-
-### Credential Persistence
-
-Authentication credentials are stored in `/workspaces/.claude/` and persist across container rebuilds.
-
-For more options, see the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code).
-
-## GitHub CLI Authentication
-
-GitHub CLI (`gh`) is pre-installed for repository operations like pushing code, creating pull requests, and accessing private repositories.
-
-### Interactive Login (Recommended)
-
-```bash
-gh auth login
-```
-
-Follow the prompts:
-1. Select **GitHub.com** (or your enterprise server)
-2. Choose your preferred protocol: **HTTPS** (recommended) or **SSH**
-3. Authenticate via **browser** (easiest) or paste a personal access token
-
-### Token-Based Login
-
-For automated setups or environments without browser access:
-
-```bash
-# From a file
-gh auth login --with-token < ~/github-token.txt
-
-# From environment variable
-echo "$GITHUB_TOKEN" | gh auth login --with-token
-```
-
-Generate a token at [github.com/settings/tokens](https://github.com/settings/tokens) with appropriate scopes (typically `repo`, `read:org`).
-
-### Verifying Authentication
-
-```bash
-gh auth status
-```
-
-Expected output shows your authenticated account and token scopes.
-
-### Credential Persistence
-
-GitHub CLI credentials are automatically persisted across container rebuilds. The container is configured to store credentials in `/workspaces/.gh/` (via `GH_CONFIG_DIR`), which is part of the bind-mounted workspace.
-
-**You only need to authenticate once.** After running `gh auth login`, your credentials will survive container rebuilds and be available in future sessions.
-
-## Available Tools
+## What's Included
 
 ### Languages & Runtimes
-| Tool | Description |
-|------|-------------|
-| Python 3.14 | Base language runtime |
-| Node.js LTS | JavaScript runtime |
-| TypeScript | Via Node.js |
-
-### Package Managers
-| Tool | Description |
-|------|-------------|
-| `uv` | Fast Python package manager (pip alternative) |
-| `npm` | Node.js package manager |
-| `pip` / `pipx` | Python package installers |
-
-### Development Tools
-| Tool | Description |
-|------|-------------|
-| `gh` | GitHub CLI for repository operations |
-| `docker` | Container CLI (connects to host Docker) |
-| `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
-| Tool | Description |
-|------|-------------|
-| tree-sitter | AST parsing for JavaScript, TypeScript, Python |
-| ast-grep | Structural code search and rewriting |
-| Pyright | Python language server |
-| TypeScript LSP | TypeScript/JavaScript language server |
 
-### Claude Code Tools
-| Tool | Description |
-|------|-------------|
-| `claude` | Claude Code CLI |
-| `cc` | Wrapper with auto-configuration |
-| `ccusage` | Token usage analyzer |
-| `ccstatusline` | Status line for sessions |
-| `claude-monitor` | Real-time usage tracking |
-
-## Using Claude Code
-
-### 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
-
-```bash
-cc                    # Start Claude Code in current directory
-cc "explain this"     # Start with an initial prompt
-```
-
-### Direct CLI
+Python 3.14, Node.js LTS, TypeScript, Go
 
-For more control, use the `claude` command directly:
-
-```bash
-claude                        # Basic invocation
-claude --help                 # View all options
-claude --resume               # Resume previous session
-```
+### Package Managers
 
-## Configuration
+`uv`, `npm`, `pip` / `pipx`
 
-### Environment Variables
+### Development Tools
 
-Edit `.devcontainer/.env` to customize behavior:
+`gh` (GitHub CLI), `docker`, `git`, `jq`, `curl`, `tmux`, `biome`, `agent-browser`
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `CLAUDE_CONFIG_DIR` | `/workspaces/.claude` | Claude configuration directory |
-| `SETUP_CONFIG` | `true` | Copy config files during setup |
-| `OVERWRITE_CONFIG` | `true` | Overwrite existing configs |
-| `SETUP_ALIASES` | `true` | Add `cc` alias to shell |
-| `SETUP_PLUGINS` | `true` | Install official plugins |
+### Code Intelligence
 
-### Claude Code Settings
+tree-sitter (JS/TS/Python), ast-grep, Pyright, TypeScript LSP
 
-Default settings are in `.devcontainer/config/settings.json`. These are copied to `/workspaces/.claude/settings.json` on first run.
+### Claude Code Tools
 
-Key defaults:
-- **Model**: Claude Opus 4-6
-- **Default mode**: Plan (prompts before executing)
-- **Max output tokens**: 128,000
+`claude`, `cc` (wrapper), `ccusage`, `ccburn`, `ccstatusline`, `claude-monitor`
 
-### System Prompt
+### Custom Features (14)
 
-The default system prompt is in `.devcontainer/config/main-system-prompt.md`. Override it by creating a `.claude/system-prompt.md` in your project directory.
+tmux, agent-browser, claude-monitor, ccusage, ccburn, ccstatusline, ast-grep, tree-sitter, lsp-servers, biome, notify-hook, mcp-qdrant, mcp-reasoner, splitrail
 
-## Custom Features
+### Agents (17) & Skills (16)
 
-CodeForge includes several custom devcontainer features:
+The `code-directive` plugin includes specialized agents (architect, explorer, test-writer, security-auditor, etc.) and domain-specific coding reference skills (fastapi, svelte5, docker, testing, etc.).
 
-| Feature | Description |
-|---------|-------------|
-| `claude-monitor` | Real-time token usage monitoring with ML predictions |
-| `ccusage` | Usage analytics CLI |
-| `ccstatusline` | Compact powerline status display |
-| `ast-grep` | Structural code search using AST patterns |
-| `tree-sitter` | Parser with JS/TS/Python grammars |
-| `lsp-servers` | Pyright and TypeScript language servers |
-| `agent-browser` | Browser automation with accessibility snapshots and screenshots |
-| `tmux` | Terminal multiplexer with Catppuccin theme for Agent Teams |
-| `biome` | Fast JS/TS/JSON/CSS formatter (global install) |
+## Quick Start
 
-## Essential Gotchas
+1. **Install**: `npx codeforge-dev`
+2. **Open in Container**: "Reopen in Container" in VS Code, or create a Codespace
+3. **Authenticate**: Run `claude` and follow prompts
+4. **Start coding**: Run `cc`
 
-- **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
-- **GitHub auth persists**: Run `gh auth login` once; credentials survive container rebuilds (stored in `/workspaces/.gh/`)
+For full usage documentation — authentication, configuration, tools, agents, and keybindings — see [`.devcontainer/README.md`](.devcontainer/README.md).
 
 ## Development
 
@@ -266,6 +97,8 @@ npm publish
 
 ## Further Reading
 
+- [Full Usage Guide](.devcontainer/README.md)
+- [Changelog](.devcontainer/CHANGELOG.md)
 - [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
 - [Dev Containers Specification](https://containers.dev/)
 - [GitHub CLI Manual](https://cli.github.com/manual/)

package/package.json

@@ -1,44 +1,44 @@
 {
-  "name": "codeforge-dev",
-  "version": "1.7.0",
-  "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": {
-    "codeforge": "setup.js"
-  },
-  "scripts": {
-    "test": "node test.js"
-  },
-  "keywords": [
-    "devcontainer",
-    "claude",
-    "claude-code",
-    "mcp",
-    "mcp-server",
-    "ai",
-    "development-environment",
-    "vscode",
-    "container",
-    "qdrant",
-    "reasoner",
-    "ai-development"
-  ],
-  "author": "AnExiledDev",
-  "license": "GPL-3.0",
-  "files": [
-    ".devcontainer/**/*",
-    "setup.js",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AnExiledDev/CodeForge.git"
-  },
-  "homepage": "https://github.com/AnExiledDev/CodeForge#readme",
-  "bugs": {
-    "url": "https://github.com/AnExiledDev/CodeForge/issues"
-  }
+	"name": "codeforge-dev",
+	"version": "1.9.0",
+	"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": {
+		"codeforge": "setup.js"
+	},
+	"scripts": {
+		"test": "node test.js"
+	},
+	"keywords": [
+		"devcontainer",
+		"claude",
+		"claude-code",
+		"mcp",
+		"mcp-server",
+		"ai",
+		"development-environment",
+		"vscode",
+		"container",
+		"qdrant",
+		"reasoner",
+		"ai-development"
+	],
+	"author": "AnExiledDev",
+	"license": "GPL-3.0",
+	"files": [
+		".devcontainer/**/*",
+		"setup.js",
+		"README.md"
+	],
+	"engines": {
+		"node": ">=14.0.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/AnExiledDev/CodeForge.git"
+	},
+	"homepage": "https://github.com/AnExiledDev/CodeForge#readme",
+	"bugs": {
+		"url": "https://github.com/AnExiledDev/CodeForge/issues"
+	}
 }