diff --git a/.devcontainer/CHANGELOG.md b/.devcontainer/CHANGELOG.md index cc6e83c..3651301 100644 --- a/.devcontainer/CHANGELOG.md +++ b/.devcontainer/CHANGELOG.md @@ -4,6 +4,12 @@ ### Changed +#### Performance +- Commented out Rust toolchain feature — saves ~1.23 GB image size; uncomment in `devcontainer.json` if needed +- Commented out ccms feature pending replacement tool (requires Rust) +- Updated Bun feature to install latest version (was pinned to outdated 1.3.9) +- Added npm cache cleanup to 6 features: agent-browser, ast-grep, biome, claude-session-dashboard, lsp-servers, tree-sitter (saves ~96 MB runtime disk) + #### Port Forwarding - Dynamic port forwarding for all ports in VS Code — previously only port 7847 was statically forwarded; now all ports auto-forward with notification @@ -23,6 +29,9 @@ ### Fixed +#### Bun +- Bun PATH not available in non-interactive shells — Bun is now accessible in all shell contexts + #### Session Context Plugin - **Commit reminder** no longer blocks Claude from stopping — switched from `decision: "block"` to advisory `systemMessage` wrapped in `` tags - **Commit reminder** now uses tiered logic: meaningful changes (3+ files, 2+ source files, or test files) get an advisory suggestion; small changes are silent diff --git a/.devcontainer/CLAUDE.md b/.devcontainer/CLAUDE.md index 5685a2e..27fb235 100644 --- a/.devcontainer/CLAUDE.md +++ b/.devcontainer/CLAUDE.md @@ -80,7 +80,7 @@ git worktree add /workspaces/projects/.worktrees/ -b | `ccraw` | Vanilla Claude Code (bypasses config) | | `ccw` | Claude Code with writing system prompt | | `cc-orc` | Claude Code in orchestrator mode (delegation-first) | -| `ccms` | Search session history (project-scoped) | +| ~~`ccms`~~ | _(commented out — replacement pending)_ | | `ccusage` / `ccburn` | Token usage analysis / burn rate | | `agent-browser` | Headless Chromium (Playwright-based) | | `check-setup` | Verify CodeForge setup health | diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index 20f40b2..6964f80 100755 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -46,12 +46,11 @@ } }, - // Feature install order: external runtimes first (Node, uv, Rust, Bun), + // Feature install order: external runtimes first (Node, uv, Bun), // then Claude Code native binary (no Node dependency), then custom features. // npm-dependent features (agent-browser, ccusage, ccburn, claude-session-dashboard, // biome, lsp-servers) must come after Node. uv-dependent features (ruff, claude-monitor) must - // come after uv. cargo-dependent features (ccms) must come after Rust. - // notify-hook is second-to-last (lightweight, no dependencies). + // come after uv. notify-hook is second-to-last (lightweight, no dependencies). // dbr (devcontainer-bridge) is last — standalone binary, no dependencies. "overrideFeatureInstallOrder": [ "ghcr.io/devcontainers/features/node", @@ -59,7 +58,6 @@ "ghcr.io/devcontainers/features/docker-outside-of-docker", "ghcr.io/devcontainers-extra/features/uv", "ghcr.io/rails/devcontainer/features/bun", - "ghcr.io/devcontainers/features/rust", "./features/claude-code-native", "./features/tmux", "./features/agent-browser", @@ -67,7 +65,6 @@ "./features/ccusage", "./features/ccburn", "./features/ccstatusline", - "./features/ccms", "./features/claude-session-dashboard", "./features/ast-grep", "./features/tree-sitter", @@ -94,10 +91,13 @@ "moby": false }, "ghcr.io/devcontainers-extra/features/uv:1.0": {}, - "ghcr.io/rails/devcontainer/features/bun:1.0.2": {}, - "ghcr.io/devcontainers/features/rust:1.5.0": { + "ghcr.io/rails/devcontainer/features/bun:1.0.2": { "version": "latest" }, + // Uncomment to add Rust toolchain: + // "ghcr.io/devcontainers/features/rust:1.5.0": { + // "version": "latest" + // }, // Uncomment to add Go runtime (not installed by default): // "ghcr.io/devcontainers/features/go:1": {}, "./features/claude-code-native": {}, @@ -120,7 +120,8 @@ "./features/ccstatusline": { "username": "automatic" }, - "./features/ccms": {}, + // Uncomment to add ccms (requires Rust): + // "./features/ccms": {}, "./features/claude-session-dashboard": { "version": "latest", "port": "7847", diff --git a/.devcontainer/features/agent-browser/install.sh b/.devcontainer/features/agent-browser/install.sh index d34a230..c1358d4 100755 --- a/.devcontainer/features/agent-browser/install.sh +++ b/.devcontainer/features/agent-browser/install.sh @@ -58,6 +58,7 @@ npm install -g "${NPM_PACKAGE}" 2>/dev/null || { echo "[agent-browser] WARNING: Global install failed, trying user install" su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || true } +npm cache clean --force 2>/dev/null || true # Download Chromium and install system dependencies echo "[agent-browser] Installing Chromium and system dependencies..." diff --git a/.devcontainer/features/ast-grep/install.sh b/.devcontainer/features/ast-grep/install.sh index 3def52a..e6e531e 100755 --- a/.devcontainer/features/ast-grep/install.sh +++ b/.devcontainer/features/ast-grep/install.sh @@ -55,5 +55,6 @@ npm install -g "${NPM_PACKAGE}" 2>/dev/null || { echo "[ast-grep] WARNING: Global install failed, trying user install" su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || true } +npm cache clean --force 2>/dev/null || true echo "[ast-grep] Installed: $(ast-grep --version 2>/dev/null || echo 'unknown')" diff --git a/.devcontainer/features/biome/install.sh b/.devcontainer/features/biome/install.sh index 28c4d8f..28f5202 100755 --- a/.devcontainer/features/biome/install.sh +++ b/.devcontainer/features/biome/install.sh @@ -33,6 +33,7 @@ if [ "${VERSION}" = "latest" ]; then else npm install -g "@biomejs/biome@${VERSION}" fi +npm cache clean --force 2>/dev/null || true # Verify installation biome --version diff --git a/.devcontainer/features/claude-session-dashboard/install.sh b/.devcontainer/features/claude-session-dashboard/install.sh index daa3ba1..49abca6 100755 --- a/.devcontainer/features/claude-session-dashboard/install.sh +++ b/.devcontainer/features/claude-session-dashboard/install.sh @@ -76,6 +76,7 @@ echo "[claude-session-dashboard] Installing for user: ${USERNAME}" # === INSTALL VIA NPM === echo "[claude-session-dashboard] Installing claude-session-dashboard@${DASHBOARD_VERSION} globally..." npm install -g "claude-session-dashboard@${DASHBOARD_VERSION}" +npm cache clean --force 2>/dev/null || true # === PERSISTENCE SYMLINK (POSTSTART HOOK) === # Settings/cache live at ~/.claude-dashboard, which is ephemeral (/home/vscode). diff --git a/.devcontainer/features/lsp-servers/install.sh b/.devcontainer/features/lsp-servers/install.sh index c3b171e..3402923 100755 --- a/.devcontainer/features/lsp-servers/install.sh +++ b/.devcontainer/features/lsp-servers/install.sh @@ -84,6 +84,8 @@ install_npm_package "typescript" "typescript" "${TS_VERSION}" # Install TypeScript Language Server install_npm_package "typescript-language-server" "typescript-language-server" "${TSLSP_VERSION}" +npm cache clean --force 2>/dev/null || true + # Install gopls (Go LSP) - uses go install since it's a Go package echo "[lsp-servers] Installing gopls..." if command -v go &>/dev/null; then diff --git a/.devcontainer/features/tree-sitter/install.sh b/.devcontainer/features/tree-sitter/install.sh index d474825..d7bbf01 100755 --- a/.devcontainer/features/tree-sitter/install.sh +++ b/.devcontainer/features/tree-sitter/install.sh @@ -170,6 +170,8 @@ if [ "${NEED_PYTHON}" = "true" ]; then echo "[tree-sitter] Python bindings installed" fi +npm cache clean --force 2>/dev/null || true + # === SUMMARY === echo "" echo "[tree-sitter] Installation complete!" diff --git a/.devcontainer/scripts/setup.sh b/.devcontainer/scripts/setup.sh index 2e64bd9..3ad7e5b 100755 --- a/.devcontainer/scripts/setup.sh +++ b/.devcontainer/scripts/setup.sh @@ -162,6 +162,27 @@ if [ "$SETUP_POSTSTART" = "true" ]; then run_poststart_hooks fi +# Fix Bun PATH — external feature only adds to ~/.bashrc (misses non-interactive shells) +if [ -d "$HOME/.bun/bin" ]; then + # Symlink bun binaries into /usr/local/bin for non-login, non-interactive shells (bash -c, exec) + for bin in bun bunx; do + if [ -x "$HOME/.bun/bin/$bin" ] && [ ! -e "/usr/local/bin/$bin" ]; then + sudo ln -sf "$HOME/.bun/bin/$bin" "/usr/local/bin/$bin" + fi + done + # Profile script sets BUN_INSTALL for login/interactive shells (content-idempotent) + if [ ! -f /etc/profile.d/bun.sh ] || ! grep -q 'BUN_INSTALL="\$HOME/.bun"' /etc/profile.d/bun.sh; then + sudo tee /etc/profile.d/bun.sh > /dev/null <<'BUNEOF' +export BUN_INSTALL="$HOME/.bun" +case ":${PATH}:" in + *:"${BUN_INSTALL}/bin":*) ;; + *) export PATH="${BUN_INSTALL}/bin:${PATH}" ;; +esac +BUNEOF + sudo chmod 0644 /etc/profile.d/bun.sh + fi +fi + echo "" echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" echo " Setup Summary" diff --git a/docs/src/content/docs/customization/configuration.md b/docs/src/content/docs/customization/configuration.md index a4f030f..245cd00 100644 --- a/docs/src/content/docs/customization/configuration.md +++ b/docs/src/content/docs/customization/configuration.md @@ -184,10 +184,10 @@ DevContainer features install runtimes and tools. CodeForge pins external featur { "features": { "ghcr.io/devcontainers/features/node:1.7.1": { "version": "lts" }, - "ghcr.io/devcontainers/features/rust:1.5.0": { "version": "latest" }, + // "ghcr.io/devcontainers/features/rust:1.5.0": { "version": "latest" }, // Opt-in "ghcr.io/anthropics/devcontainer-features/claude-code:1.0.5": {}, "./features/ruff": { "version": "latest" }, - "./features/ccms": {} + // "./features/ccms": {} // Currently disabled — replacement pending } } ``` diff --git a/docs/src/content/docs/customization/rules.md b/docs/src/content/docs/customization/rules.md index c3a1941..bd80b17 100644 --- a/docs/src/content/docs/customization/rules.md +++ b/docs/src/content/docs/customization/rules.md @@ -50,7 +50,7 @@ Key requirements: ### Session Search (`session-search.md`) -Configures the `ccms` session history search tool. Mandates project-scoped searches to prevent cross-project information leakage, and requires CLI mode (no interactive TUI) for automation compatibility. +Configures the `ccms` session history search tool. Mandates project-scoped searches to prevent cross-project information leakage, and requires CLI mode (no interactive TUI) for automation compatibility. _(Note: `ccms` is currently disabled in the default container build. This rule remains deployed so it takes effect if ccms is re-enabled.)_ Key requirements: - Always pass `--project ` to scope results diff --git a/docs/src/content/docs/features/index.md b/docs/src/content/docs/features/index.md index c80ee18..4ae61ef 100644 --- a/docs/src/content/docs/features/index.md +++ b/docs/src/content/docs/features/index.md @@ -64,7 +64,7 @@ CodeForge pre-installs **22 tools and utilities** covering session management, c Highlights include: - **`cc`** — Launch Claude Code with full CodeForge configuration (plugins, system prompt, agents) -- **`ccms`** — Search your Claude Code session history with boolean queries, role filtering, and time scoping +- **`ccms`** — Search your Claude Code session history with boolean queries, role filtering, and time scoping _(currently disabled — replacement pending)_ - **`ccusage`** / **`ccburn`** — Track your Claude API token usage and burn rate - **`ruff`**, **`biome`**, **`shellcheck`** — Code quality tools for Python, JS/TS, and Shell - **`sg`** (ast-grep), **`tree-sitter`** — Structural code search and syntax tree operations diff --git a/docs/src/content/docs/features/tools.md b/docs/src/content/docs/features/tools.md index a17fedc..8cf13b4 100644 --- a/docs/src/content/docs/features/tools.md +++ b/docs/src/content/docs/features/tools.md @@ -45,6 +45,10 @@ ccw ### ccms — Session History Search +:::caution[Currently Disabled] +The `ccms` feature is currently commented out in `devcontainer.json`. A replacement tool is pending. The documentation below is preserved for reference. +::: + Search through your Claude Code session history (JSONL files) with boolean queries, role filtering, and time scoping. Built in Rust for fast searching across large session archives. ```bash @@ -180,7 +184,7 @@ CodeForge includes modern language runtimes and fast package managers so you can |------|---------|---------|---------| | **Node.js** | via nvm | JavaScript runtime | `node --version` | | **Python** | 3.14 via uv | Python runtime | `python --version` | -| **Rust** | via rustup | Rust toolchain | `cargo --version` | +| **Rust** | via rustup | Rust toolchain _(opt-in — commented out by default)_ | `cargo --version` | | **Bun** | latest | Fast JS runtime and package manager | `bun install` | | **uv** | latest | Fast Python package manager | `uv pip install requests` | | **Go** | via feature | Go toolchain | `go version` | @@ -207,7 +211,7 @@ CodeForge uses `uv` as the default Python package manager. It is significantly f | 1 | `cc` / `claude` | Session | Claude Code with CodeForge config | | 2 | `ccraw` | Session | Vanilla Claude Code | | 3 | `ccw` | Session | Claude Code in writing mode | -| 4 | `ccms` | Session | Session history search | +| 4 | `ccms` | Session | Session history search _(currently disabled)_ | | 5 | `ccusage` | Session | API usage statistics | | 6 | `ccburn` | Session | Token burn analysis | | 7 | `ccstatusline` | Session | Terminal statusline | diff --git a/docs/src/content/docs/getting-started/first-session.md b/docs/src/content/docs/getting-started/first-session.md index c3a3043..21da7fd 100644 --- a/docs/src/content/docs/getting-started/first-session.md +++ b/docs/src/content/docs/getting-started/first-session.md @@ -84,8 +84,8 @@ From the terminal (not inside a Claude session), you can verify what's available # List all installed tools and their versions cc-tools -# Search past session history -ccms "what did we work on" +# Search past session history (ccms is currently disabled — replacement pending) +# ccms "what did we work on" # Check API token usage ccusage diff --git a/docs/src/content/docs/getting-started/index.md b/docs/src/content/docs/getting-started/index.md index 40d3b9e..faa34c6 100644 --- a/docs/src/content/docs/getting-started/index.md +++ b/docs/src/content/docs/getting-started/index.md @@ -56,11 +56,11 @@ See the [Plugins Overview](../plugins/) for the full list and detailed documenta CodeForge installs a comprehensive toolchain so you never have to stop and install something mid-session: -- **Language Runtimes** — Python 3.14, Node.js LTS, Rust, Bun, with Go available as an opt-in +- **Language Runtimes** — Python 3.14, Node.js LTS, Bun, with Rust and Go available as opt-ins - **Package Managers** — uv (Python), npm, Bun, pip/pipx - **Code Intelligence** — tree-sitter, ast-grep, Pyright, TypeScript LSP - **Linters and Formatters** — Ruff, Biome, shfmt, ShellCheck, hadolint, dprint -- **CLI Utilities** — GitHub CLI, Docker, jq, tmux, and CodeForge-specific tools like ccms, ccusage, and ccburn +- **CLI Utilities** — GitHub CLI, Docker, jq, tmux, and CodeForge-specific tools like ccusage and ccburn (ccms currently disabled — replacement pending) See the [Features Overview](../features/) for the complete reference. diff --git a/docs/src/content/docs/getting-started/installation.md b/docs/src/content/docs/getting-started/installation.md index 9320203..c38101b 100644 --- a/docs/src/content/docs/getting-started/installation.md +++ b/docs/src/content/docs/getting-started/installation.md @@ -123,7 +123,7 @@ No local Docker installation required. Port forwarding is handled automatically The first container build takes several minutes (typically 3-8 minutes depending on your internet speed and hardware). Here's what's happening behind the scenes: 1. **Base image pull** — downloads the Python 3.14 DevContainer image from Microsoft's registry -2. **Feature installation** — installs 21 DevContainer features in dependency order: Node.js and uv first (other tools depend on them), then Rust, Bun, Claude Code, and all custom features +2. **Feature installation** — installs DevContainer features in dependency order: Node.js and uv first (other tools depend on them), then Bun, Claude Code, and all custom features 3. **Post-start setup** — deploys configuration files, sets up shell aliases, and configures plugins :::caution[Don't interrupt the first build] @@ -157,8 +157,8 @@ A healthy installation shows all of these as available: | Category | Tools | |----------|-------| | Claude Code | `claude`, `cc`, `ccw`, `ccraw` | -| Session tools | `ccms`, `ccusage`, `ccburn`, `claude-monitor` | -| Languages | `node`, `python`, `rustc`, `bun` | +| Session tools | `ccusage`, `ccburn`, `claude-monitor` (`ccms` currently disabled) | +| Languages | `node`, `python`, `bun` (`rustc` opt-in) | | Code intelligence | `ast-grep`, `tree-sitter`, `pyright`, `typescript-language-server` | | Linters/Formatters | `ruff`, `biome` | | Utilities | `gh`, `docker`, `git`, `jq`, `tmux` | @@ -173,7 +173,7 @@ A few features ship with `"version": "none"` by default (shfmt, dprint, shellche - **Python 3.14** — the container's base image, with `uv` as the package manager - **Node.js LTS** — installed via nvm, with npm included -- **Rust** — latest stable via rustup +- **Rust** — latest stable via rustup _(opt-in — uncomment in `devcontainer.json`)_ - **Bun** — fast JavaScript/TypeScript runtime and package manager - **Go** — available as an opt-in (uncomment in `devcontainer.json`) @@ -182,7 +182,7 @@ A few features ship with `"version": "none"` by default (shfmt, dprint, shellche - **GitHub CLI** (`gh`) — repository management, PR creation, issue tracking - **Docker** (Docker-outside-of-Docker) — container operations from inside the DevContainer - **tmux** — terminal multiplexing for parallel Claude Code sessions -- **ccms** — search your Claude Code session history +- **ccms** — search your Claude Code session history _(currently disabled — replacement pending)_ - **ccusage** / **ccburn** — token usage analysis and burn rate tracking - **ccstatusline** — session status in your terminal prompt - **claude-monitor** — real-time session monitoring @@ -237,7 +237,7 @@ Use `git diff .devcontainer/` after updating to review what changed before commi ### Tools not found after build -**Symptoms:** Commands like `cc` or `ccms` return "command not found." +**Symptoms:** Commands like `cc` return "command not found." (Note: `ccms` is currently disabled by default.) - Run `check-setup` to identify which tools are missing - Check that the post-start script completed successfully (look for errors in the terminal output) diff --git a/docs/src/content/docs/getting-started/requirements.md b/docs/src/content/docs/getting-started/requirements.md index b68623a..63d29ac 100644 --- a/docs/src/content/docs/getting-started/requirements.md +++ b/docs/src/content/docs/getting-started/requirements.md @@ -95,7 +95,7 @@ On macOS and Windows, Docker Desktop runs inside a VM with its own resource limi **During initial setup**, internet access is required to: - Pull the base container image (`mcr.microsoft.com/devcontainers/python:3.14`) -- Install DevContainer features (Node.js, Rust, Bun, uv, and 20+ custom features) +- Install DevContainer features (Node.js, Bun, uv, and 20+ custom features; Rust is opt-in) - Download CLI tools and language servers The first build downloads roughly 2-4 GB depending on what's cached. Subsequent container starts are much faster because Docker caches the built layers. diff --git a/docs/src/content/docs/reference/architecture.md b/docs/src/content/docs/reference/architecture.md index ac114cf..08acb43 100644 --- a/docs/src/content/docs/reference/architecture.md +++ b/docs/src/content/docs/reference/architecture.md @@ -31,7 +31,7 @@ CodeForge operates in three layers. Each layer builds on the one below it: +------------------------------------------------+ ``` -**DevContainer layer** provides the foundation: a Python 3.14 container image with Node.js, Rust, and Bun runtimes (Go available as opt-in), plus CLI tools (ruff, biome, ast-grep, tree-sitter, and others). +**DevContainer layer** provides the foundation: a Python 3.14 container image with Node.js and Bun runtimes (Rust and Go available as opt-in), plus CLI tools (ruff, biome, ast-grep, tree-sitter, and others). **CodeForge layer** adds intelligence: plugins register hooks that validate commands, inject context, and run quality checks. Agents provide specialized personas for different tasks. Skills offer on-demand reference material. Rules enforce hard constraints. System prompts shape behavior. @@ -120,7 +120,7 @@ CodeForge ships 38 skills across the skill-engine, spec-workflow, ticket-workflo +-- devcontainer.json # Container definition (image, features, mounts) +-- .env # Setup flags (SETUP_CONFIG, SETUP_ALIASES, etc.) +-- features/ # DevContainer features (tool installers) -| +-- ccms/ # Session history search (Rust) +| +-- ccms/ # Session history search (commented out — replacement pending) | +-- ccstatusline/ # Terminal status line | +-- ccusage/ # API usage stats | +-- ccburn/ # Token burn rate diff --git a/docs/src/content/docs/reference/commands.md b/docs/src/content/docs/reference/commands.md index 10e35e2..b3e8210 100644 --- a/docs/src/content/docs/reference/commands.md +++ b/docs/src/content/docs/reference/commands.md @@ -35,7 +35,7 @@ Commands for session analysis, usage tracking, and system monitoring. | Command | Description | Example | |---------|-------------|---------| -| `ccms` | Search Claude Code session history. Supports boolean queries, role filtering, time scoping, and project isolation. | `ccms --project "$(pwd)" "auth approach"` | +| `ccms` | Search Claude Code session history. Supports boolean queries, role filtering, time scoping, and project isolation. _(currently disabled — replacement pending)_ | `ccms --project "$(pwd)" "auth approach"` | | `ccusage` | View Claude API usage statistics | `ccusage` | | `ccburn` | Analyze token burn rate and consumption patterns with pace indicators | `ccburn` | | `ccstatusline` | Terminal status line displaying session metrics, git state, token usage, and burn rate | (runs automatically) | @@ -48,6 +48,10 @@ Commands for session analysis, usage tracking, and system monitoring. ### ccms Usage +:::caution[Currently Disabled] +The `ccms` feature is currently commented out in `devcontainer.json`. A replacement tool is pending. The documentation below is preserved for reference. +::: + `ccms` is the most feature-rich analysis command. Key flags: ```bash @@ -195,7 +199,7 @@ These additional commands are available in the container environment: | `jq` | JSON processing and filtering | | `tmux` | Terminal multiplexer for Agent Teams split-pane sessions | | `bun` | Fast JavaScript runtime and package manager | -| `cargo` | Rust package manager (used by ccms) | +| `cargo` | Rust package manager _(opt-in — Rust toolchain is commented out by default)_ | | `uv` | Fast Python package installer | ## Command Sources @@ -206,9 +210,9 @@ Commands come from different sources in the CodeForge setup: |--------|----------|-------------| | Shell aliases | `cc`, `claude`, `ccw`, `ccraw`, `cc-orc`, `check-setup` | `setup-aliases.sh` writes to `.bashrc`/`.zshrc` | | Shell functions | `cc-tools` | `setup-aliases.sh` writes to `.bashrc`/`.zshrc` | -| DevContainer features | `ccms`, `ccusage`, `ccburn`, `ruff`, `biome`, `sg`, `dbr`, etc. | `install.sh` in each feature directory | +| DevContainer features | `ccusage`, `ccburn`, `ruff`, `biome`, `sg`, `dbr`, etc. | `install.sh` in each feature directory | | Slash commands | `/spec-new`, `/ticket:new`, `/ship`, `/pr:review`, `/ps`, etc. | Skill SKILL.md files in plugin directories | -| External features | `gh`, `docker`, `node`, `bun`, `cargo` | Installed via `devcontainer.json` features | +| External features | `gh`, `docker`, `node`, `bun` | Installed via `devcontainer.json` features | :::tip[Listing All Tools] Run `cc-tools` to see every installed tool and its version. This is the quickest way to verify what is available in your container. diff --git a/docs/src/content/docs/reference/environment.md b/docs/src/content/docs/reference/environment.md index 0f82aa2..e76a662 100644 --- a/docs/src/content/docs/reference/environment.md +++ b/docs/src/content/docs/reference/environment.md @@ -82,8 +82,8 @@ Variables that configure individual tools within the container. | Variable | Tool | Description | |----------|------|-------------| -| `CCMS_PROJECT` | ccms | Default project scope for session search | -| `CCMS_FORMAT` | ccms | Default output format (`text`, `json`) | +| `CCMS_PROJECT` | ccms | Default project scope for session search _(only when ccms is enabled)_ | +| `CCMS_FORMAT` | ccms | Default output format (`text`, `json`) _(only when ccms is enabled)_ | | `RUFF_CONFIG` | ruff | Path to ruff configuration file | | `BIOME_CONFIG_PATH` | biome | Path to biome configuration file | diff --git a/docs/src/content/docs/reference/index.md b/docs/src/content/docs/reference/index.md index 3eb1858..009d0fc 100644 --- a/docs/src/content/docs/reference/index.md +++ b/docs/src/content/docs/reference/index.md @@ -25,7 +25,7 @@ This section is a lookup resource for CodeForge internals. Use it when you need | `cc` | Start Claude Code with full CodeForge configuration | | `ccw` | Start Claude Code in writing mode | | `ccraw` | Start vanilla Claude Code (no plugins or custom prompt) | -| `ccms "query"` | Search session history | +| `ccms "query"` | Search session history _(currently disabled — replacement pending)_ | | `check-setup` | Verify your installation is healthy | ### Key Paths