Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

CLI reference

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

Content: completeWorkflow: verified

The tcaf command exposes public operations rather than requiring users to select framework files manually.

Project operations

tcaf bootstrap --target <target> [--request <text> | --input <resource>]
tcaf adopt --target <target> [--request <text> | --input <resource>]
tcaf task --target <target> (--request <text> | --input <resource>)
  • bootstrap prepares a new project or target from an idea, analysis, scaffold, roadmap or first task.
  • adopt observes an existing project and establishes canonical evidence.
  • task prepares one bounded development or documentation task. It requires --request or --input.

Direct agent operation

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

Use run only for a public registered agent ID. Normal users should prefer the named operations.

Shared run arguments

  • --target — one project target; defaults to the current directory when permitted.
  • --request — inline task or starting request.
  • --input — one file, directory, archive or supported host resource. It is mutually exclusive with --request.
  • --context <selector> — add one declared optional context module; repeat only within the agent manifest limit.
  • --adapter <id> — override adapter selection. Default: auto.
  • --format markdown|json — output format. Default: markdown.

Unknown context selectors and excessive selections fail explicitly.

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 canonical project documentation.
  • doctor reports framework validity, version, runtime root, selected adapter and installation state.

Versions

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

activate validates the selected installed runtime before changing the active version. It fails when the launcher installation is unavailable or the version is missing or invalid.

Exit behaviour

Operational or validation failures return a non-zero exit code and print a TCAF error or validation issues. Do not treat generated Markdown as evidence that the host agent executed the task; it is the Run Envelope to transport into the selected tool.