Skip to content

refactor!: rename to @codemcp/knowledge with ade-knowledge binary - #32

Merged
mrsimpson merged 5 commits into
mainfrom
ade-consistent-naming
Mar 12, 2026
Merged

refactor!: rename to @codemcp/knowledge with ade-knowledge binary#32
mrsimpson merged 5 commits into
mainfrom
ade-consistent-naming

Conversation

@mrsimpson

Copy link
Copy Markdown
Collaborator

Summary

  • Rename package to @codemcp/knowledge (CLI) and @codemcp/knowledge-server (MCP)
  • Binary names: ade-knowledge and ade-knowledge-server
  • Use tsup bundler for self-contained packages
  • Mark internal packages as private
  • CommonJS deps (commander, adm-zip) must be external due to require() of Node built-ins
  • Update pnpm to 10.32.1

Breaking Change

Package renamed from agentic-knowledge-mcp to @codemcp/knowledge. Users should update their MCP configuration:

{
  "mcpServers": {
    "knowledge": {
      "command": "npx",
      "args": ["@codemcp/knowledge-server"]
    }
  }
}

Part of ADE Naming Convention

This is part of harmonizing naming across all @codemcp/* packages for the Agentic Development Environment.

…nary

Harmonize naming across the @codemcp/* ecosystem so developers have a consistent,
predictable experience. Previously, package names and binary names varied wildly
across different tools, forcing users to look up documentation for each one.

- Root package renamed from `agentic-knowledge-mcp` to `@codemcp/knowledge`
- Binary renamed from `agentic-knowledge` to `ade-knowledge`
- MCP server sub-package `bin` field removed (dead weight, binary belongs on root)
- All documentation updated to use `npx @codemcp/knowledge` invocation
- CLI program name updated to `ade-knowledge` in help output
- The routing behavior is unchanged: no args starts MCP server, with args runs CLI

- Breaking change for users with MCP configs using the old binary name
- Users invoking via `npx @codemcp/knowledge` are unaffected (npm resolves the binary)
- Stub package `agentic-knowledge-mcp` should be published pointing to the new name
BREAKING CHANGE: Package renamed from agentic-knowledge-mcp to @codemcp/knowledge

- Rename package to @codemcp/knowledge (CLI) and @codemcp/knowledge-server (MCP)
- Binary names: ade-knowledge and ade-knowledge-server
- Use tsup bundler for self-contained packages
- Mark internal packages as private
- CommonJS deps (commander, adm-zip) must be external due to require() of Node built-ins
- Update pnpm to 10.32.1
@mrsimpson
mrsimpson force-pushed the ade-consistent-naming branch from 89f93fb to 5877789 Compare March 12, 2026 08:14
- Changed CLI .name() from 'ade-knowledge' to 'npx @codemcp/knowledge'
- Changed server name from 'agentic-knowledge' to 'knowledge'
- Updated USER_GUIDE.md npm install command
- Updated requirements.md CLI command references
@mrsimpson
mrsimpson merged commit df358c1 into main Mar 12, 2026
1 check passed
@mrsimpson
mrsimpson deleted the ade-consistent-naming branch March 12, 2026 14:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant