Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.4.0 · public preview

CLI reference

Reference for TCAF 0.4.0 public operations, shared arguments, diagnostics and version commands.

The tcaf command exposes named operations so users do not need to select internal framework files manually.

Main project operations

tcaf bootstrap --target <target> [--request <text> | --input <resource>]
tcaf adopt --target <target> [--request <text> | --input <resource>]
tcaf plan --target <target> (--request <text> | --input <resource>)
tcaf task --target <target> (--request <text> | --input <resource>)
tcaf sync --target <target> [--request <text> | --input <resource>]
  • bootstrap — establish the minimum useful state for a new project from available source evidence.
  • adopt — inspect an existing project while preserving application code, history and source material.
  • plan — decompose broader work into a reviewable, dependency-aware plan without implementation.
  • task — prepare one bounded Task Contract for developer review and approved execution.
  • sync — re-read current project evidence and propose bounded reconciliation after out-of-run changes.

Advanced direct agent operation

tcaf run <agent-id> --target <target> [--request <text> | --input <resource>]

Use run only with a registered public agent ID. Normal usage should prefer the five named project operations above.

Shared run arguments

  • --target — one project target; defaults to the current directory when permitted.
  • --request — inline request.
  • --input — one supported source resource; mutually exclusive with --request.
  • --context <selector> — add a declared optional context module within the agent manifest limit.
  • --adapter <id> — override adapter selection. Default: auto.
  • --format markdown|json — output format. Default: markdown.

Discovery and validation

tcaf list [--format text|json]
tcaf validate [--target <project>] [--format text|json]
tcaf doctor [--format text|json]
  • list shows registered public operations and agents.
  • validate checks the active framework and optionally target project documentation.
  • doctor reports framework validity, version, runtime root, adapter and installation state.

Versions

tcaf version [--format text|json]
tcaf versions [--format text|json]
tcaf activate <version>

activate validates the installed runtime before changing the active version.

Exit behavior

Operational or validation failures return a non-zero exit code. A generated Run Envelope is not evidence that the host executed the operation; executed evidence must be reported separately.