CLI Overview

CLDPM provides a powerful CLI for managing Claude Code mono repos. For programmatic usage, see the Python SDK or TypeScript SDK.

Installation

pip install cldpm

Commands

Command	Description
`cldpm init`	Initialize a new mono repo
`cldpm create`	Create projects or shared components
`cldpm add`	Add a shared component to a project
`cldpm remove`	Remove a shared component from a project
`cldpm link`	Link dependencies between shared components
`cldpm unlink`	Remove dependencies between shared components
`cldpm get`	Get project info, download with dependencies (local/remote)
`cldpm sync`	Regenerate symlinks for shared components
`cldpm info`	Show CLDPM information banner

Global Options

cldpm --help     # Show help
cldpm --version  # Show version

Environment Variables

Variable	Description
`GITHUB_TOKEN`	GitHub personal access token for private repos
`GH_TOKEN`	Alternative to GITHUB_TOKEN (GitHub CLI compatible)

Exit Codes

Code	Description
0	Success
1	Error (invalid arguments, missing files, etc.)

Examples

Create a complete mono repo

# Initialize
cldpm init my-monorepo
cd my-monorepo
 
# Create projects
cldpm create project web-app -d "Web application"
cldpm create project api-server -d "API server"
 
# Create shared skill
mkdir -p shared/skills/logging
echo "# Logging Skill" > shared/skills/logging/SKILL.md
 
# Add to projects
cldpm add skill:logging --to web-app
cldpm add skill:logging --to api-server
 
# Verify
cldpm get web-app
cldpm get api-server

Work with remote repositories

# View remote project
cldpm get my-project -r owner/repo
 
# Download remote project
cldpm get my-project -r owner/repo --download
 
# Download to specific directory
cldpm get my-project -r owner/repo -d -o ./local-copy

Python vs TypeScript CLI

Both the Python and TypeScript SDKs provide the same CLI commands with identical behavior. Choose based on your project's ecosystem:

	Python	TypeScript
Install	`pip install cldpm`	`npm install -g cldpm`
Run without install	`pipx run cldpm`	`npx cldpm`
Best for	Python projects, pipenv/poetry	Node.js projects, monorepos
Package manager	pip, pipx, poetry	npm, pnpm, yarn

💡

All CLI commands work identically between Python and TypeScript versions. The choice depends on your project's runtime environment and tooling preferences.

AI Integration init