cli/docs/cmd/docs/index.md

core docs

Documentation management across repositories.

Usage

core docs <command> [flags]

Commands

Command	Description
list	List documentation across repos
sync	Sync documentation to output directory

docs list

Show documentation coverage across all repos.

core docs list [flags]

Flags

Flag	Description
--registry	Path to repos.yaml

Output

Repo                  README    CLAUDE    CHANGELOG   docs/
──────────────────────────────────────────────────────────────────────
core                  ✓         ✓         —           12 files
core-php              ✓         ✓         ✓           8 files
core-images           ✓         —         —           —

Coverage: 3 with docs, 0 without

docs sync

Sync documentation from all repos to an output directory.

core docs sync [flags]

Flags

Flag	Description
--registry	Path to repos.yaml
--output	Output directory (default: ./docs-build)
--dry-run	Show what would be synced

Output Structure

docs-build/
└── packages/
    ├── core/
    │   ├── index.md      # from README.md
    │   ├── claude.md     # from CLAUDE.md
    │   ├── changelog.md  # from CHANGELOG.md
    │   ├── build.md      # from docs/build.md
    │   └── ...
    └── core-php/
        ├── index.md
        └── ...

Example

# Preview what will be synced
core docs sync --dry-run

# Sync to default output
core docs sync

# Sync to custom directory
core docs sync --output ./site/content

What Gets Synced

For each repo, the following files are collected:

Source	Destination
README.md	index.md
CLAUDE.md	claude.md
CHANGELOG.md	changelog.md
docs/*.md	*.md

Integration with core.help

The synced docs are used to build https://core.help:

1. Run core docs sync --output ../core-php/docs/packages
2. VitePress builds the combined documentation
3. Deploy to core.help

See Also

• Configuration - Project configuration