Skip to content

CLI Quick Start

All Drydock tools work directly from the command line. No setup beyond cloning the repo.

The One-Shot Command

# Compile full project context (runs ALL analyzers)
python Tools/analyzers/context_compiler.py /path/to/project -o context.json

# Human-readable version
python Tools/analyzers/context_compiler.py /path/to/project --markdown -o context.md

Individual Tools

Boundary Detector (the killer feature)

python Tools/analyzers/boundary_detector.py /path/to/project -o boundaries.json

Tells you exactly which clusters of files can be safely extracted, which files are bridges between components, and rates extraction risk.

Code Map

python Tools/analyzers/codemap.py /path/to/project -o codemap.json

# Markdown for humans
python Tools/analyzers/codemap.py /path/to/project --markdown

Interface Extractor

python Tools/analyzers/interface_extractor.py /path/to/project -o interfaces.json

Dependency Analyzer

python Tools/analyzers/dependency_analyzer.py /path/to/project --json -o deps.json

Structure Analyzer

python Tools/analyzers/structure_analyzer.py /path/to/project -o structure.md

Platform Detector

python Tools/analyzers/platform_detector.py /path/to/project --json -o platforms.json

Git Analyzer

# Requires a full clone (not --depth 1)
python Tools/analyzers/git_analyzer.py /path/to/project --days 180 -o git.md

Full Workflow

# 1. Bring a project in
python Tools/intake/git_intake.py https://github.com/org/repo --shallow --analyze

# 2. Analyze it
python Tools/analyzers/context_compiler.py Ship_Yard/_intake/repo -o context.json

# 3. Find extraction points
python Tools/analyzers/boundary_detector.py Ship_Yard/_intake/repo -o boundaries.json

# 4. Scaffold a new project
python Tools/scaffolders/project_scaffolder.py --name my-new-project

# 5. Build and ship
python Tools/builders/oryx_builder.py release Projects/my-new-project --version v1.0.0

Output Formats

All analyzers support two output modes:

Flag Format Best for
(default) JSON AI agents, programmatic consumption
--markdown Markdown Human review, documentation

Use -o filename to write to a file, or omit to print to stdout.