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)¶
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¶
Dependency Analyzer¶
Structure Analyzer¶
Platform Detector¶
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.