cldpm

CLDPM - Claude Project Manager (TypeScript SDK)

An SDK and CLI for managing mono repos with multiple Claude Code projects.

Overview

CLDPM enables sharing skills, agents, hooks, and rules across multiple Claude Code projects without duplication. It uses a hybrid linking strategy where references are stored in config files and symlinks are generated locally.

Installation

npm install cldpm

Or globally:

npm install -g cldpm

CLI Usage

# Initialize a new mono repo
cldpm init my-monorepo
cd my-monorepo

# Create a project
cldpm create project web-app

# Create shared components
cldpm create skill logging
cldpm create agent code-reviewer

# Add components to project
cldpm add skill:logging --to web-app
cldpm add agent:code-reviewer --to web-app

# View project with resolved dependencies
cldpm get web-app

# Download project with all dependencies
cldpm get web-app --download --output ./standalone

# Get from remote repository (optimized sparse checkout)
cldpm get my-project -r owner/repo --download

# Use -b flag when branch name contains slashes
cldpm get my-project -r owner/repo -b feature/auth --download

# After git clone, restore symlinks
cldpm sync --all

SDK Usage

import {
  loadCldpmConfig,
  resolveProject,
  listProjects,
  listSharedComponents,
  syncProjectLinks,
} from "cldpm";

// Load configuration
const config = await loadCldpmConfig("/path/to/monorepo");
console.log(`Repo: ${config.name}`);

// List all projects
const projects = await listProjects("/path/to/monorepo");
for (const project of projects) {
  console.log(`Project: ${project.name}`);
}

// Resolve a project with all dependencies
const project = await resolveProject("my-project", "/path/to/monorepo");
console.log(`Shared skills: ${project.shared.skills.map(s => s.name)}`);

// List all shared components
const components = await listSharedComponents("/path/to/monorepo");
console.log(`Skills: ${components.skills}`);

// Sync symlinks for a project
const result = await syncProjectLinks(projectPath, repoRoot);
console.log(`Created: ${result.created}`);

Commands

Command	Description
cldpm init	Initialize a new mono repo
cldpm create project	Create a new project
cldpm create skill/agent/hook/rule	Create 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

Documentation

Document	Description
CLI Reference	Complete CLI command reference
SDK Reference	Programmatic API documentation
Contributing	Contribution guidelines
Security	Security policy
Code of Conduct	Community guidelines

API Reference

Schemas

import {
  CldpmConfig,
  ProjectConfig,
  ProjectDependencies,
  ComponentMetadata,
  ComponentDependencies,
  ComponentType,
  createCldpmConfig,
  createProjectConfig,
  createComponentMetadata,
  parseComponentRef,
} from "cldpm";

Core Functions

import {
  // Config
  loadCldpmConfig,
  saveCldpmConfig,
  loadProjectConfig,
  saveProjectConfig,
  getProjectPath,
  listProjects,
  loadComponentMetadata,
  saveComponentMetadata,

  // Resolver
  resolveProject,
  resolveComponent,
  resolveLocalComponent,
  listSharedComponents,
  resolveComponentDependencies,
  getAllDependenciesForComponent,

  // Linker
  syncProjectLinks,
  addComponentLink,
  removeComponentLink,
  createSymlink,
  removeProjectLinks,
  getLocalComponents,
  getSharedComponents,
} from "cldpm";

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode
npm run dev

License

MIT License - see LICENSE for details.

Crafted by Transilience.ai