用途：tfctl 是操作 HCP Terraform / Terraform Cloud / Terraform Enterprise 的命令行工具，单二进制、覆盖完整 v2 API，且已认证。
主要能力：通过 tfctl api PATH 调用任意 API；用 --jq '<expr>' 在响应信封上运行 gojq（隐含 --json）；用 -p workspace=NAME 等把名称解析为 ID；支持 --json、--markdown、--dry-run、--no-redact 等输出标志；分页用 --all（上限 2000）或 --page-size/--page-number；计数用 --page-size 1 --jq '.meta.pagination.["total-count"]'。
使用方式：常见任务如 tfctl run status NAME_OR_ID、tfctl run start NAME_OR_ID；变量路径为 /workspaces/{workspace}/vars -p workspace=NAME，而非 org 嵌套路径；策略检查在 /runs/{run-id}/policy-checks。删除用 tfctl api PATH -X DELETE，由 tfctl 自身门控：仅当人类通过 tfctl harness exec --allow-delete=<class> 授权会话时才放行，否则拒绝并打印可回传的授权命令，不应自行运行 harness exec 自我授权。
限制与约定：响应为 JSON:API 信封，data: [] 或 null 即最终答案，不要换端点重查；退出码 0 成功、1 信息/用法、2 未找到或认证无效、3 令牌过期、4 网络、5 限流或 5xx、6 资源错误态。默认会脱敏敏感值（含 --json/--jq），需要时用 --no-redact。不要用外部 jq 管道，应使用内置 --jq。批量变量更新需逐条调用。
适用场景：查询组织/工作区/运行/变量集/状态版本、启动运行、管理远程状态消费者与变量集关系、审计变更等。缺失信息：安装方式、具体版本与收费情况暂未提供。