Skip to content

cli.md

Latest commit

 

History

History
76 lines (51 loc) · 1.86 KB

cli.md

File metadata and controls

76 lines (51 loc) · 1.86 KB

CLI Guide

code2skill exposes four CLI commands:

  • scan: run a full repository scan and generate Skills plus supporting artifacts
  • estimate: calculate impact and cost, then write report.json only
  • ci: run the automation-oriented full or incremental pipeline
  • adapt: copy or merge generated Skills into target tool instruction files

Entry Points

code2skill --help
python -m code2skill --help

Repository Path Model

Every command accepts an explicit repo_path.

  • Relative repo_path values are resolved from the current shell location.
  • Relative --output-dir, --report-json, --diff-file, and --pricing-file values are resolved from repo_path.
  • For adapt, relative --source-dir values are also resolved from repo_path.

This means callers can run the CLI from outside the target repository without changing path semantics.

Common Examples

Full generation:

code2skill scan /path/to/repo --llm qwen --model qwen-plus-latest

Structure-only scan:

code2skill scan /path/to/repo --structure-only

Cost preview:

code2skill estimate /path/to/repo --pricing-file pricing.json

Incremental CI run:

code2skill ci /path/to/repo --mode auto --base-ref origin/main --head-ref HEAD

Adapt generated Skills into Codex format:

code2skill adapt /path/to/repo --target codex

Exit Behavior

  • Success returns exit code 0.
  • User-facing runtime errors return exit code 1 and print a concise code2skill: error: ... message to stderr.
  • Ctrl+C returns exit code 130.

Output Summary

Successful scan, estimate, and ci commands print a compact summary including:

  • the command name
  • the effective mode
  • repository path
  • selected file counts
  • output directory
  • generated artifact paths

adapt prints the repository root, target, source directory, and written files.