craft-cli: agent-first controls
craft-cli now has clearer source control, health checks, agent introspection, capability lookup, JSON field projection, and broader dry-run previews.
1 min read
craft-cli got a small agent-focused upgrade.
The main change is craft source: auto reads from Craft Desktop’s local database when available and falls back to the API, api skips local reads for Linux or headless machines, and local fails clearly if the local store is unavailable.
There are also a few new agent ergonomics:
craft doctor --jsonfor auth, API, source, and local-store health.craft agent-contextfor a stable machine-readable command manifest.craft which <capability>to map intent to the right command.--selectto trim JSON output to the fields an agent actually needs.- Broader
--dry-runpreviews across write commands.
Nothing changes about the core architecture: local-first reads when possible, API writes, mutation journal for diff, log, and undo.