Metagit bootstrap
Create a valid .metagit.yml with minimal tokens. Prefer code over sampling.
Token rules
- Default to deterministic init. Do not start with MCP sampling or
config example. - Never run
metagit detect repo_map(full directory maps blow the context window). - Never paste full detect YAML/JSON into the conversation. Write it to a file and read only the fields you need.
- Prefer
detect … -o summaryon stdout. Use--output-filefor the full payload.
Default path (deterministic)
export METAGIT_AGENT_MODE=true
# missing manifest:
metagit init --kind application --no-prompt
# or:
SKILL_ROOT="$(python3 -c "import metagit, pathlib; print(pathlib.Path(metagit.__file__).parent / 'data/skills/metagit-bootstrap')")"
"$SKILL_ROOT/scripts/bootstrap-config.sh" .
metagit config validate -c .metagit.yml
bootstrap-config.sh writes a minimal application scaffold when .metagit.yml is missing and prints status=written|exists. Do not overwrite a valid manifest without explicit confirmation.
Existing manifest: metagit config validate -c .metagit.yml. Patch with metagit config patch — do not regenerate from detect dumps.
metagit init writes one file. Split an existing umbrella with metagit config split --by all --dir .metagit.d when concurrent edits collide on .metagit.yml. After a split, edit the fragment, not the root.
Optional enrichment (file-backed)
Only after init, and only if catalog fields are still empty:
mkdir -p .metagit/.detect
metagit detect repository -p . -o summary
metagit detect repository -p . -o json --output-file .metagit/.detect/repository.json
# jq '.language, .kind, .frameworks' .metagit/.detect/repository.json
Stdout of --output-file is a compact line (status=written path=… bytes=… format=json). Do not cat the file unless selecting fields.
detect repo / detect project follow the same rule: --output-file .metagit/.detect/… or -o summary. Skip them if summary already has language/kind.
Incremental patch
metagit config show -c .metagit.yml --json
metagit config patch -c .metagit.yml --op set --path <path> --value <json> --save
metagit prompt repo -p P -n R -k repo-enrich --text-only
MCP sampling (optional, not default)
Use metagit_bootstrap_config only when the host supports sampling/createMessage and the operator asked for a richer draft than init. Discovery context is already a short artifact list — do not attach repo maps. Validate YAML; write .metagit.yml only with confirm_write=true. Plan-only: return the prompt, do not invent repos.
Safety
- Never overwrite
.metagit.ymlsilently. - Never emit secrets. Prefer placeholders for tokens.
- Do not invent repositories or unverifiable dependencies.