Behavior and output
Always prints JSON with schemaVersion:1, kind:setup_plan, goal, mode, readOnly:true, inspection, capabilities, steps, warnings and effects. It writes no files, makes no network requests, connects no accounts and sends no messages. Hosted mode skips workspace inspection. Local and external modes inspect only metadata for nine known standard paths: .git, .linktrail/config.json, .linktrail/links.jsonl, .claude/SITE.md, .agents/SITE.md, SITE.md, operations/seo/backlinks/registry.csv, linktrail.sqlite and .agents/plugins/linktrail. It inspects path components without following observed symlinks. This is a metadata snapshot, not protection against concurrent filesystem changes. It reads no contents, performs no recursive discovery and does not resolve custom paths. Absence at a standard path does not prove there is no existing setup. Step suggestions vary by goal, mode and safely observed metadata; the command does not execute those steps.Arguments
—plan is required as a bare flag; —goal verify-links|prepare-campaign|build-content required; —mode local|hosted|external defaults to local. Unknown, duplicate or malformed options fail. Output is already JSON; no —json option.Exit status
0 when a plan is produced, including plans containing workspace warnings; 2 for unsupported or malformed arguments. Inspect warnings before acting. Read configuration and file ownership before automating this command. Read local file contracts for artifact fields. Browse the local command index for related commands.Reference follows the current development CLI and HTTP contracts. Hosted availability depends on the selected environment. See capability status.