Skip to content

README.md

Latest commit

 

History

History
152 lines (115 loc) · 3.81 KB

README.md

File metadata and controls

152 lines (115 loc) · 3.81 KB

CLDPM - Claude Project Manager

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

Python Version License

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

pip install cldpm

Or with pipx for isolated installation:

pipx install cldpm

Quick Start

# 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

Architecture

flowchart LR
    subgraph "CLDPM CLI"
        INIT[cldpm init]
        CREATE[cldpm create]
        ADD[cldpm add]
        GET[cldpm get]
        SYNC[cldpm sync]
    end

    subgraph "Core SDK"
        CONFIG[Config Manager]
        RESOLVER[Dependency Resolver]
        LINKER[Symlink Manager]
    end

    subgraph "Storage"
        CLDPMJSON[(cldpm.json)]
        PROJSON[(project.json)]
        SHARED[(shared/)]
    end

    INIT --> CONFIG
    CREATE --> CONFIG
    ADD --> LINKER
    GET --> RESOLVER
    SYNC --> LINKER

    CONFIG --> CLDPMJSON
    CONFIG --> PROJSON
    RESOLVER --> SHARED
    LINKER --> SHARED
Loading

Directory Structure

my-monorepo/
├── cldpm.json                    # Root configuration
├── CLAUDE.md                   # Root instructions
├── shared/                     # Shared components
│   ├── skills/
│   │   ├── logging/            # Directory-based component
│   │   │   ├── SKILL.md
│   │   │   └── skill.json
│   │   └── quick-tip.md        # File-based component
│   ├── agents/
│   ├── hooks/
│   └── rules/
└── projects/
    └── web-app/
        ├── project.json        # Dependencies defined here
        ├── CLAUDE.md
        └── .claude/
            ├── skills/         # Symlinks to shared/ + local components
            │   ├── logging/ -> symlink
            │   └── local-note.md   # File component
            └── agents/

Component Dependencies

Shared components can depend on other shared components:

graph TD
    A[advanced-review] --> B[code-review]
    A --> C[security-check]
    B --> D[base-utils]
    C --> D
Loading 
# Create component with dependencies
cldpm create skill advanced-review --skills code-review,security-check

# Link dependencies to existing component
cldpm link skill:base-utils --to skill:code-review

Documentation

Document Description
CLI Reference Complete CLI command reference
SDK Reference Programmatic API documentation
Full Docs Complete documentation

Contributing

Contributions are welcome! Please read our Contributing Guide and Code of Conduct.

Security

For security concerns, please see our Security Policy.

License

MIT License - see LICENSE for details.

Crafted by Transilience.ai Transilience.ai