Migrate NPM packages to @CoreDirective org scope

AnExiledDev · AnExiledDev · commit 7c918adc57e2 · 2026-03-26T16:02:41.000Z
Rename all three packages under the @CoreDirective NPM org: - codeforge-dev → @coredirective/cf-container - codeforge-dev-cli → @coredirective/cf-cli - codeforge-dashboard → @coredirective/cf-dash Add publishConfig with public access for scoped publishing. Update all install commands, badge URLs, npm links, and docs references across 19 files. CLI command names unchanged.
diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -16,7 +16,7 @@ body:
       label: Steps to Reproduce
       description: Steps to reproduce the behavior
       placeholder: |
-        1. Run `npx codeforge-dev`
+        1. Run `npx @coredirective/cf-container`
         2. Open in container
         3. ...
     validations:
@@ -34,7 +34,7 @@ body:
     id: version
     attributes:
       label: CodeForge Version
-      description: "Run `npm view codeforge-dev version` or check package.json"
+      description: "Run `npm view @coredirective/cf-container version` or check package.json"
       placeholder: "1.14.2"
     validations:
       required: true
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@ Monorepo for CodeForge — an AI-powered development environment for Claude Code
 
 | Package | Description | Version |
 |---------|-------------|---------|
-| [`container/`](container/) | CodeForge DevContainer (`codeforge-dev` on npm) | 2.1.0 |
+| [`container/`](container/) | CodeForge DevContainer (`@coredirective/cf-container` on npm) | 2.1.0 |
 | [`cli/`](cli/) | CodeForge CLI (`codeforge-cli`) | 0.1.0 |
 | [`dashboard/`](dashboard/) | Session analytics dashboard (Svelte 5 SPA + Bun backend) | — |
 | [`docs/`](docs/) | Documentation site ([codeforge.core-directive.com](https://codeforge.core-directive.com)) | — |
@@ -15,7 +15,7 @@ Monorepo for CodeForge — an AI-powered development environment for Claude Code
 
 ```bash
 # Install the devcontainer into any project
-npx codeforge-dev
+npx @coredirective/cf-container
 ```
 
 See [`container/README.md`](container/README.md) for full setup instructions, prerequisites, and usage.
@@ -43,7 +43,7 @@ See [`CLAUDE.md`](CLAUDE.md) for branching strategy and development rules.
 ## Links
 
 - [Documentation](https://codeforge.core-directive.com)
-- [npm package](https://www.npmjs.com/package/codeforge-dev)
+- [npm package](https://www.npmjs.com/package/@coredirective/cf-container)
 - [GitHub](https://github.com/AnExiledDev/CodeForge)
 - [Changelog](container/.devcontainer/CHANGELOG.md)
 
diff --git a/cli/CHANGELOG.md b/cli/CHANGELOG.md
@@ -2,6 +2,12 @@
 
 ## v0.1.0 — 2026-03-14 (Experimental)
 
+### Package Rename
+
+- **`codeforge-dev-cli`** has been renamed to **`@coredirective/cf-cli`** on npm
+- Install via: `npm install -g @coredirective/cf-cli`
+- The old `codeforge-dev-cli` package name is deprecated
+
 Initial release. Ships with CodeForge v2.1.1.
 
 ### Command Groups
diff --git a/cli/README.md b/cli/README.md
@@ -7,7 +7,7 @@ CLI for CodeForge development workflows. Manages sessions, plugins, configuratio
 ## Install
 
 ```bash
-npm install -g codeforge-dev-cli
+npm install -g @coredirective/cf-cli
 ```
 
 Requires [Bun](https://bun.sh) runtime.
diff --git a/cli/package.json b/cli/package.json
@@ -1,5 +1,8 @@
 {
-	"name": "codeforge-dev-cli",
+	"name": "@coredirective/cf-cli",
+	"publishConfig": {
+		"access": "public"
+	},
 	"version": "0.1.0",
 	"description": "CLI for CodeForge development workflows",
 	"keywords": [
diff --git a/container/.devcontainer/CHANGELOG.md b/container/.devcontainer/CHANGELOG.md
@@ -2,6 +2,12 @@
 
 ## v2.1.0 — 2026-03-25
 
+### Package Rename
+
+- **`codeforge-dev`** has been renamed to **`@coredirective/cf-container`** on npm
+- Install via: `npx @coredirective/cf-container`
+- The old `codeforge-dev` package name is deprecated
+
 ### CLI
 
 - **`codeforge proxy`** — launch Claude Code through mitmproxy for full API traffic inspection. Starts mitmweb in the background, proxies all Claude API requests through it, and opens a browser UI at `http://localhost:8081` for real-time request/response inspection. Auto-installs mitmproxy via pipx on first use, handles CA certificate generation and system trust store installation. Supports `--no-web` for headless mitmdump output, `--setup` for install-only, and `-- <claude-args>` passthrough. Useful for monitoring token usage, cache behavior, and rate limit utilization — the `anthropic-ratelimit-unified-*` response headers on `/v1/messages` requests show 5-hour and 7-day quota utilization even with long-lived auth tokens.
diff --git a/container/CLAUDE.md b/container/CLAUDE.md
@@ -1,6 +1,6 @@
 # CodeForge Container
 
-The `codeforge-dev` npm package — a complete development container for AI-powered coding with Claude Code.
+The `@coredirective/cf-container` npm package — a complete development container for AI-powered coding with Claude Code.
 
 See `.devcontainer/CLAUDE.md` for full devcontainer documentation.
 See the root `CLAUDE.md` for monorepo-wide development rules (branching strategy, testing).
diff --git a/container/README.md b/container/README.md
@@ -1,10 +1,10 @@
 # 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-dev.svg)](https://www.npmjs.com/package/codeforge-dev)
+[![npm version](https://img.shields.io/npm/v/@coredirective%2Fcf-container.svg)](https://www.npmjs.com/package/@coredirective/cf-container)
 [![Changelog](https://img.shields.io/badge/changelog-view-blue)](.devcontainer/CHANGELOG.md)
 [![GitHub last commit](https://img.shields.io/github/last-commit/AnExiledDev/CodeForge)](https://github.com/AnExiledDev/CodeForge/commits)
-[![npm downloads](https://img.shields.io/npm/dm/codeforge-dev)](https://www.npmjs.com/package/codeforge-dev)
+[![npm downloads](https://img.shields.io/npm/dm/@coredirective%2Fcf-container)](https://www.npmjs.com/package/@coredirective/cf-container)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org/)
 [![GitHub issues](https://img.shields.io/github/issues/AnExiledDev/CodeForge)](https://github.com/AnExiledDev/CodeForge/issues)
 [![CI](https://github.com/AnExiledDev/CodeForge/actions/workflows/ci.yml/badge.svg)](https://github.com/AnExiledDev/CodeForge/actions/workflows/ci.yml)
@@ -22,28 +22,28 @@ Instead of spending hours discovering and configuring advanced features like bui
 Add CodeForge to any project:
 
 ```bash
-npx codeforge-dev
+npx @coredirective/cf-container
 ```
 
 This copies the `.devcontainer/` directory to your project. Then open in VS Code and select "Reopen in Container".
 
 ### Options
 
 ```bash
-npx codeforge-dev --force    # Smart update (preserves your customizations)
-npx codeforge-dev -f         # Short form
-npx codeforge-dev --reset    # Fresh install (wipes .devcontainer, keeps .codeforge)
+npx @coredirective/cf-container --force    # Smart update (preserves your customizations)
+npx @coredirective/cf-container -f         # Short form
+npx @coredirective/cf-container --reset    # Fresh install (wipes .devcontainer, keeps .codeforge)
 ```
 
 ### Alternative Install Methods
 
 ```bash
 # Install globally
-npm install -g codeforge-dev
+npm install -g @coredirective/cf-container
 codeforge-dev
 
 # Run specific version
-npx codeforge-dev@1.2.3
+npx @coredirective/cf-container@1.2.3
 ```
 
 ## Prerequisites
@@ -132,7 +132,7 @@ For the complete configuration guide, see the [documentation site](https://codef
 
 ## Quick Start
 
-1. **Install**: `npx codeforge-dev`
+1. **Install**: `npx @coredirective/cf-container`
 2. **Open in Container**:
    - **VS Code**: "Reopen in Container" from the Command Palette
    - **CLI**: `devcontainer up --workspace-folder .` then `docker exec -it <container> zsh`
diff --git a/container/package.json b/container/package.json
@@ -1,5 +1,8 @@
 {
-	"name": "codeforge-dev",
+	"name": "@coredirective/cf-container",
+	"publishConfig": {
+		"access": "public"
+	},
 	"version": "2.1.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",
diff --git a/dashboard/CHANGELOG.md b/dashboard/CHANGELOG.md
@@ -2,6 +2,11 @@
 
 ## v0.1.0
 
+### Package Rename
+
+- **`codeforge-dashboard`** has been renamed to **`@coredirective/cf-dash`** on npm
+- The old `codeforge-dashboard` package name is deprecated
+
 Initial release of `codeforge-dashboard` — session analytics for Claude Code.
 
 - Svelte 5 SPA with dark mode, TailwindCSS 4, LayerChart
diff --git a/dashboard/package.json b/dashboard/package.json
@@ -1,5 +1,8 @@
 {
-	"name": "codeforge-dashboard",
+	"name": "@coredirective/cf-dash",
+	"publishConfig": {
+		"access": "public"
+	},
 	"version": "0.1.0",
 	"description": "Claude Code session analytics dashboard",
 	"type": "module",
@@ -22,7 +25,7 @@
 		"build": "vite build",
 		"test": "bun test",
 		"preview": "vite preview",
-		"prepublishOnly": "bun run build"
+		"prepublishOnly": "bun run build && bun test"
 	},
 	"devDependencies": {
 		"@sveltejs/adapter-static": "^3.0.10",
@@ -39,5 +42,15 @@
 		"typescript": "^5.7.0",
 		"vite": "^8.0.0"
 	},
-	"license": "GPL-3.0"
+	"license": "GPL-3.0",
+	"author": "AnExiledDev",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/AnExiledDev/CodeForge.git",
+		"directory": "dashboard"
+	},
+	"homepage": "https://github.com/AnExiledDev/CodeForge/tree/main/dashboard#readme",
+	"bugs": {
+		"url": "https://github.com/AnExiledDev/CodeForge/issues"
+	}
 }
diff --git a/docs/scripts/sync-changelog.mjs b/docs/scripts/sync-changelog.mjs
@@ -51,10 +51,10 @@ Breaking changes are rare. Most releases are minor versions that add new plugins
 
 \`\`\`bash
 # Update to latest version
-npx codeforge-dev@latest
+npx @coredirective/cf-container@latest
 
 # Update to a specific version
-npx codeforge-dev@1.14.0
+npx @coredirective/cf-container@2.1.0
 \`\`\`
 
 After updating, rebuild your DevContainer to apply changes:
diff --git a/docs/src/components/Hero.astro b/docs/src/components/Hero.astro
@@ -102,7 +102,7 @@ const _props = Astro.props;
 		<div class="how-it-works__step">
 			<div class="how-it-works__number">1</div>
 			<h3 class="how-it-works__step-title">Install</h3>
-			<p class="how-it-works__step-desc">Run <code>npx codeforge-dev</code> in your project. One command sets up the entire DevContainer.</p>
+			<p class="how-it-works__step-desc">Run <code>npx @coredirective/cf-container</code> in your project. One command sets up the entire DevContainer.</p>
 		</div>
 		<div class="how-it-works__connector" aria-hidden="true">
 			<svg width="32" height="16" viewBox="0 0 32 16" fill="none"><path d="M0 8h28m0 0-6-6m6 6-6 6" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>
diff --git a/docs/src/components/InstallCommand.astro b/docs/src/components/InstallCommand.astro
@@ -10,7 +10,7 @@
 	</div>
 	<div class="terminal-frame__body">
 		<span class="install-terminal__prompt">$</span>
-		<span class="install-terminal__command"> npx codeforge-dev</span><span class="typing-cursor"></span>
+		<span class="install-terminal__command"> npx @coredirective/cf-container</span><span class="typing-cursor"></span>
 	</div>
 </div>
 
diff --git a/docs/src/content/docs/getting-started/index.md b/docs/src/content/docs/getting-started/index.md
@@ -5,7 +5,7 @@ sidebar:
   order: 1
 ---
 
-CodeForge is a DevContainer configuration that transforms your development environment into an AI-powered workspace. It bundles 17 plugins, 22 tools, 19 specialized agents, and 34 skills into a single `npx codeforge-dev` install.
+CodeForge is a DevContainer configuration that transforms your development environment into an AI-powered workspace. It bundles 17 plugins, 22 tools, 19 specialized agents, and 34 skills into a single `npx @coredirective/cf-container` install.
 
 ## What is CodeForge?
 
@@ -16,7 +16,7 @@ Inside the container, Claude Code gains superpowers: specialized agents handle a
 ## Quick Install
 
 ```bash
-npx codeforge-dev
+npx @coredirective/cf-container
 ```
 
 This sets up the `.devcontainer/` configuration in your project. Open the project in VS Code and reopen in the container when prompted. That's it — your AI-powered workspace is ready.
diff --git a/docs/src/content/docs/getting-started/installation.md b/docs/src/content/docs/getting-started/installation.md
@@ -12,7 +12,7 @@ This guide walks you through setting up CodeForge from scratch. The process has
 Navigate to your project root and run:
 
 ```bash
-npx codeforge-dev
+npx @coredirective/cf-container
 ```
 
 This creates a `.devcontainer/` directory containing the full CodeForge configuration — all plugins, features, agents, skills, system prompts, and settings. Your existing project files are not modified.
@@ -21,8 +21,8 @@ This creates a `.devcontainer/` directory containing the full CodeForge configur
 If your project already has a `.devcontainer/` directory, the installer will warn you and exit. Two flags handle this:
 
 ```bash
-npx codeforge-dev --force    # Smart update (preserves your customizations)
-npx codeforge-dev --reset    # Fresh install (wipes .devcontainer, keeps .codeforge)
+npx @coredirective/cf-container --force    # Smart update (preserves your customizations)
+npx @coredirective/cf-container --reset    # Fresh install (wipes .devcontainer, keeps .codeforge)
 ```
 
 **`--force`** uses an intelligent sync — it preserves files you've customized (writing `.default` copies of new defaults in `.codeforge/` for review) rather than blindly overwriting everything. Use this for routine updates.
@@ -34,11 +34,11 @@ npx codeforge-dev --reset    # Fresh install (wipes .devcontainer, keeps .codefo
 
 ```bash
 # Install globally for repeated use
-npm install -g codeforge-dev
-codeforge-dev
+npm install -g @coredirective/cf-container
+@coredirective/cf-container
 
 # Pin a specific version
-npx codeforge-dev@2.1.0
+npx @coredirective/cf-container@2.1.0
 ```
 
 ### What the Installer Creates
@@ -205,7 +205,7 @@ See the [Customization section](../customization/) for full details on each conf
 To update to the latest version:
 
 ```bash
-npx codeforge-dev@latest
+npx @coredirective/cf-container@latest
 ```
 
 This updates the `.devcontainer/` configuration. After updating, rebuild the container:
@@ -222,7 +222,7 @@ Use `git diff .devcontainer/` after updating to review what changed before commi
 Having trouble with the build, authentication, or missing tools? See the [Troubleshooting reference](../reference/troubleshooting/) for solutions to common issues including:
 
 - Container build failures and slow builds
-- `npx codeforge-dev` installation errors
+- `npx @coredirective/cf-container` installation errors
 - VS Code not showing the DevContainer prompt
 - Claude Code authentication problems
 - Docker permissions on Linux and WSL 2 integration on Windows
diff --git a/docs/src/content/docs/getting-started/migrating-to-v2.md b/docs/src/content/docs/getting-started/migrating-to-v2.md
@@ -44,7 +44,7 @@ If you prefer to migrate by hand:
 
 1. **Update CodeForge:**
    ```bash
-   npx codeforge-dev@latest
+   npx @coredirective/cf-container@latest
    ```
 
 2. **Review the new `.codeforge/` directory** created by the installer. It contains default versions of all config files.
@@ -73,7 +73,7 @@ If you prefer to migrate by hand:
 
 CodeForge v2 uses **checksum-based modification detection** to protect your customizations during updates:
 
-- When you run `npx codeforge-dev@latest`, the installer compares each `.codeforge/` file's SHA-256 checksum against the known default.
+- When you run `npx @coredirective/cf-container@latest`, the installer compares each `.codeforge/` file's SHA-256 checksum against the known default.
 - **Unmodified files** are updated in place with the new default.
 - **Modified files** are preserved. The new default is written as a `.default` file (e.g., `settings.json.default`) for you to review and merge manually.
 
diff --git a/docs/src/content/docs/reference/changelog.md b/docs/src/content/docs/reference/changelog.md
@@ -23,10 +23,10 @@ Breaking changes are rare. Most releases are minor versions that add new plugins
 
 ```bash
 # Update to latest version
-npx codeforge-dev@latest
+npx @coredirective/cf-container@latest
 
 # Update to a specific version
-npx codeforge-dev@1.14.0
+npx @coredirective/cf-container@2.1.0
 ```
 
 After updating, rebuild your DevContainer to apply changes:
@@ -49,6 +49,12 @@ For minor and patch updates, you can usually just rebuild the container. Check t
 
 ## v2.1.0 — 2026-03-25
 
+### Package Rename
+
+- **`codeforge-dev`** has been renamed to **`@coredirective/cf-container`** on npm
+- Install via: `npx @coredirective/cf-container`
+- The old `codeforge-dev` package name is deprecated
+
 ### CLI
 
 - **`codeforge proxy`** — launch Claude Code through mitmproxy for full API traffic inspection. Starts mitmweb in the background, proxies all Claude API requests through it, and opens a browser UI at `http://localhost:8081` for real-time request/response inspection. Auto-installs mitmproxy via pipx on first use, handles CA certificate generation and system trust store installation. Supports `--no-web` for headless mitmdump output, `--setup` for install-only, and `-- <claude-args>` passthrough. Useful for monitoring token usage, cache behavior, and rate limit utilization — the `anthropic-ratelimit-unified-*` response headers on `/v1/messages` requests show 5-hour and 7-day quota utilization even with long-lived auth tokens.
diff --git a/docs/src/content/docs/reference/troubleshooting.md b/docs/src/content/docs/reference/troubleshooting.md
@@ -9,11 +9,11 @@ Solutions for common issues with the CodeForge devcontainer. If your problem isn
 
 ## Installation Issues
 
-**Problem: `npx codeforge-dev` fails.**
+**Problem: `npx @coredirective/cf-container` fails.**
 
 - **Node.js not installed** — the installer requires Node.js 18+ and npm. Run `node --version` to check; install from [nodejs.org](https://nodejs.org/) if missing.
 - **Network issues** — npm needs to reach the registry. Check your connection or try `npm config set registry https://registry.npmjs.org/`.
-- **Permission errors** — prefer `npx --yes codeforge-dev` to avoid global install permission issues. If you need global installs, configure your npm prefix or use a Node version manager (e.g., nvm) instead of `sudo`.
+- **Permission errors** — prefer `npx --yes @coredirective/cf-container` to avoid global install permission issues. If you need global installs, configure your npm prefix or use a Node version manager (e.g., nvm) instead of `sudo`.
 
 **Problem: VS Code doesn't show "Reopen in Container".**
 
