Stats
Actions
Available In
Tags
Paradigm
One command to make your codebase AI-ready.
Install
npm install -g @a-company/paradigm
Run it
cd your-project
paradigm shift
That's it. paradigm shift scaffolds everything your AI assistant needs to understand your codebase — a project map, access rules, IDE instruction files, and enforcement hooks — in one command. Safe to re-run. Works with TypeScript, Python, Rust, Go, Swift, and more.
What you'll see
┌─────────────────────────────────────────────────┐
│ paradigm shift │
│ Full project setup in one command │
└─────────────────────────────────────────────────┘
📁 Project: your-project
📍 Status: New project
✓ Step 1/6: Initializing Paradigm...
✓ Step 2/6: Initializing team configuration...
✓ Step 3/6: Scanning and indexing symbols...
✓ Step 4/6: Syncing IDE configurations...
✓ Step 5/6: Installing hooks...
✓ Step 6/6: Skipped verify (use --verify to check health)
┌─────────────────────────────────────────────────┐
│ ✨ Paradigm shift complete! │
└─────────────────────────────────────────────────┘
Created/Updated:
─────────────────────────────────────────────────
✓ .paradigm/config.yaml Project configuration
✓ .paradigm/navigator.yaml Symbol navigation map
✓ .paradigm/agents.yaml Team agent configuration
✓ .purpose Root feature definitions
✓ portal.yaml Authorization gates
✓ CLAUDE.md Claude Code AI instructions
✓ AGENTS.md Universal AI agent instructions
✓ .cursor/rules/ Cursor AI instructions
✓ .claude/hooks/ Claude Code enforcement hooks
Skip to what you just got → · Skip to the why →
Other ways to install
Install script (one-liner)
curl -fsSL https://a-company.org/paradigm/install.sh | bash
Or download and inspect first:
curl -fsSL https://a-company.org/paradigm/install.sh -o install.sh
chmod +x install.sh
./install.sh
This clones the repo to ~/.paradigm-cli/, builds both paradigm and paradigm-mcp, and installs them globally. Re-running updates to the latest version.
Note: The source directory at
~/.paradigm-cli/must be kept — the global CLIs symlink to it. To uninstall:npm uninstall -g @a-company/paradigm @a-company/paradigm-mcp && rm -rf ~/.paradigm-cli
Manual install from source
# 1. Clone and build (keep this directory — CLIs symlink to it)
git clone https://github.com/ascend42/a-paradigm.git ~/.paradigm-cli
cd ~/.paradigm-cli
npm install && npm run build
# 2. Install CLI globally
cd packages/paradigm && npm install -g . && cd ../..
# 3. Install MCP server globally
cd packages/paradigm-mcp && npm install -g . && cd ../..
# 4. Verify
paradigm --version
Claude Code plugin (one-step setup for Claude Code users)
If you use Claude Code, the plugin bundles enforcement hooks and MCP configuration in a single install:
/plugin marketplace add ascend42/a-paradigm
You still run paradigm shift inside each project to create the per-project files (.paradigm/, .purpose, portal.yaml, etc.) — the plugin handles the global pieces so you don't need to run paradigm mcp setup separately.
paradigm shift — the one command
What it does
Run it on a fresh project or an existing one. It detects which case it's in and does the right thing. In plain English:
- Creates
.paradigm/with project config, agent team, and IDE detection - Scaffolds
.purpose(what your code does) andportal.yaml(who can access what) as empty skeletons you fill in - Scans your code to seed the symbol graph (or skips with
--quick) - Generates IDE instruction files (
CLAUDE.md,AGENTS.md,.cursor/rules/, Windsurf, Copilot) - Installs enforcement hooks (git + Claude Code + Cursor) so compliance is automatic
- Optionally runs
paradigm doctorto verify everything is healthy (--verify)
Re-running is safe. 36 core files and directories are guaranteed to exist after completion, and existing content is never overwritten.
