Twill Cloud Coding Agent API 使用指南 - 自动化代码任务与工作流管理

twill-cloud-coding-agent by twillai/skills

472 周安装量

GitHub

安装命令

npx skills add https://github.com/twillai/skills --skill twill-cloud-coding-agent

自动化开发运维 API

🇨🇳中文介绍

Twill Cloud Coding Agent

使用此技能通过公共 v1 API 运行 Twill 工作流。

设置

设置 API 密钥和可选的基础 URL：

export TWILL_API_KEY="your_api_key"
export TWILL_BASE_URL="${TWILL_BASE_URL:-https://twill.ai}"

所有 API 调用均使用：

Authorization: Bearer $TWILL_API_KEY

使用此辅助函数减少重复代码：

api() {
  curl -sS "$@" -H "Authorization: Bearer $TWILL_API_KEY" -H "Content-Type: application/json"
}

端点覆盖范围（公共 v1）

GET /api/v1/auth/me
GET /api/v1/repositories
POST /api/v1/tasks

🇺🇸English

Twill Cloud Coding Agent

Use this skill to run Twill workflows through the public v1 API.

Setup

Set API key and optional base URL:

export TWILL_API_KEY="your_api_key"
export TWILL_BASE_URL="${TWILL_BASE_URL:-https://twill.ai}"

All API calls use:

Authorization: Bearer $TWILL_API_KEY

Use this helper to reduce repetition:

api() {
  curl -sS "$@" -H "Authorization: Bearer $TWILL_API_KEY" -H "Content-Type: application/json"
}

Endpoint Coverage (Public v1)

GET /api/v1/auth/me
GET /api/v1/repositories
POST /api/v1/tasks

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

261,300 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

104,600 周安装

GET /api/v1/tasks/:taskIdOrSlug

POST /api/v1/tasks/:taskIdOrSlug/messages

GET /api/v1/tasks/:taskIdOrSlug/jobs

POST /api/v1/tasks/:taskIdOrSlug/approve-plan

POST /api/v1/tasks/:taskIdOrSlug/cancel

POST /api/v1/tasks/:taskIdOrSlug/archive

GET /api/v1/tasks/:taskIdOrSlug/teleport/claude

GET /api/v1/jobs/:jobId/logs/stream

POST /api/v1/jobs/:jobId/cancel

GET /api/v1/scheduled-tasks

POST /api/v1/scheduled-tasks

GET /api/v1/scheduled-tasks/:scheduledTaskId

PATCH /api/v1/scheduled-tasks/:scheduledTaskId

DELETE /api/v1/scheduled-tasks/:scheduledTaskId

POST /api/v1/scheduled-tasks/:scheduledTaskId/pause

POST /api/v1/scheduled-tasks/:scheduledTaskId/resume

验证密钥和工作区上下文：

curl -sS "$TWILL_BASE_URL/api/v1/auth/me" -H "Authorization: Bearer $TWILL_API_KEY"

列出工作区可用的 GitHub 仓库：

curl -sS "$TWILL_BASE_URL/api/v1/repositories" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/tasks" -d '{"command":"Fix flaky tests in CI","repository":"owner/repo","userIntent":"SWE"}'

command
repository (owner/repo 或完整的 GitHub URL)

branch
agent（提供商或提供商/模型，例如 codex 或 codex/gpt-5.2）
userIntent (SWE, PLAN, ASK, DEV_ENVIRONMENT) — 默认为 SWE
title
files（{ filename, mediaType, url } 的数组）

始终将 task.url 报告给用户。

curl -sS "$TWILL_BASE_URL/api/v1/tasks?limit=20&cursor=BASE64_CURSOR" -H "Authorization: Bearer $TWILL_API_KEY"

通过 limit 和 cursor 支持游标分页。

curl -sS "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG" -H "Authorization: Bearer $TWILL_API_KEY"

返回任务元数据以及 latestJob（包括状态、类型、计划内容和计划结果，如果可用）。

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/messages" -d '{"message":"Please prioritize login flow first","userIntent":"PLAN"}'

userIntent 和 files 是可选的。

curl -sS "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/jobs?limit=30&cursor=BASE64_CURSOR" -H "Authorization: Bearer $TWILL_API_KEY"

支持游标分页：

limit 默认为 30（最大 100）
cursor 用于获取更早的页面
响应包含 jobs 和 nextCursor

当最新的计划作业完成并准备批准时使用。

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/approve-plan" -d '{}'

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/cancel" -d '{}'

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/archive" -d '{}'

流式传输作业日志（SSE）

curl -N "$TWILL_BASE_URL/api/v1/jobs/JOB_ID/logs/stream" -H "Authorization: Bearer $TWILL_API_KEY" -H "Accept: text/event-stream"

流在 data: 行中发出 JSON 负载，并以 complete 事件终止。

api -X POST "$TWILL_BASE_URL/api/v1/jobs/JOB_ID/cancel" -d '{}'

curl -sS "$TWILL_BASE_URL/api/v1/scheduled-tasks" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks" -d '{
  "title":"Daily triage",
  "message":"Review urgent issues and open tasks",
  "repositoryUrl":"https://github.com/org/repo",
  "baseBranch":"main",
  "cronExpression":"0 9 * * 1-5",
  "timezone":"America/New_York",
  "agentProviderId":"claude-code/sonnet"
}'

必需：title, message, repositoryUrl, baseBranch, cronExpression。

可选：timezone（默认为 "UTC"），agentProviderId（提供商/模型覆盖）。

读取、更新、删除

curl -sS "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -H "Authorization: Bearer $TWILL_API_KEY"

api -X PATCH "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -d '{
  "message":"Updated instructions",
  "cronExpression":"0 10 * * 1-5",
  "agentProviderId":"codex/gpt-5.2"
}'

curl -sS -X DELETE "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID/pause" -d '{}'
api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID/resume" -d '{}'

直接调用 API 端点时使用 userIntent (SWE, PLAN, ASK, DEV_ENVIRONMENT)。
创建任务，报告 task.url，仅在请求时轮询/流式传输日志。
如果缺少 TWILL_API_KEY，请询问。
不要打印 API 密钥或其他机密信息。

GET /api/v1/tasks/:taskIdOrSlug

POST /api/v1/tasks/:taskIdOrSlug/messages

GET /api/v1/tasks/:taskIdOrSlug/jobs

POST /api/v1/tasks/:taskIdOrSlug/approve-plan

POST /api/v1/tasks/:taskIdOrSlug/cancel

POST /api/v1/tasks/:taskIdOrSlug/archive

GET /api/v1/tasks/:taskIdOrSlug/teleport/claude

GET /api/v1/jobs/:jobId/logs/stream

POST /api/v1/jobs/:jobId/cancel

GET /api/v1/scheduled-tasks

POST /api/v1/scheduled-tasks

GET /api/v1/scheduled-tasks/:scheduledTaskId

PATCH /api/v1/scheduled-tasks/:scheduledTaskId

DELETE /api/v1/scheduled-tasks/:scheduledTaskId

POST /api/v1/scheduled-tasks/:scheduledTaskId/pause

POST /api/v1/scheduled-tasks/:scheduledTaskId/resume

Validate key and workspace context:

curl -sS "$TWILL_BASE_URL/api/v1/auth/me" -H "Authorization: Bearer $TWILL_API_KEY"

List available GitHub repositories for the workspace:

curl -sS "$TWILL_BASE_URL/api/v1/repositories" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/tasks" -d '{"command":"Fix flaky tests in CI","repository":"owner/repo","userIntent":"SWE"}'

command
repository (owner/repo or full GitHub URL)

branch
agent (provider or provider/model, for example codex or codex/gpt-5.2)
userIntent (SWE, PLAN, ASK, DEV_ENVIRONMENT) — defaults to SWE
title
files (array of { filename, mediaType, url })

Always report task.url back to the user.

curl -sS "$TWILL_BASE_URL/api/v1/tasks?limit=20&cursor=BASE64_CURSOR" -H "Authorization: Bearer $TWILL_API_KEY"

Supports cursor pagination via limit and cursor.

curl -sS "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG" -H "Authorization: Bearer $TWILL_API_KEY"

Returns task metadata plus latestJob including status, type, plan content, and plan outcome when available.

Send Follow-Up Message

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/messages" -d '{"message":"Please prioritize login flow first","userIntent":"PLAN"}'

userIntent and files are optional.

curl -sS "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/jobs?limit=30&cursor=BASE64_CURSOR" -H "Authorization: Bearer $TWILL_API_KEY"

Supports cursor pagination:

limit defaults to 30 (max 100)
cursor fetches older pages
response includes jobs and nextCursor

Use when the latest plan job is completed and ready for approval.

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/approve-plan" -d '{}'

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/cancel" -d '{}'

api -X POST "$TWILL_BASE_URL/api/v1/tasks/TASK_ID_OR_SLUG/archive" -d '{}'

Stream Job Logs (SSE)

curl -N "$TWILL_BASE_URL/api/v1/jobs/JOB_ID/logs/stream" -H "Authorization: Bearer $TWILL_API_KEY" -H "Accept: text/event-stream"

Stream emits JSON payloads in data: lines and terminates with a complete event.

api -X POST "$TWILL_BASE_URL/api/v1/jobs/JOB_ID/cancel" -d '{}'

curl -sS "$TWILL_BASE_URL/api/v1/scheduled-tasks" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks" -d '{
  "title":"Daily triage",
  "message":"Review urgent issues and open tasks",
  "repositoryUrl":"https://github.com/org/repo",
  "baseBranch":"main",
  "cronExpression":"0 9 * * 1-5",
  "timezone":"America/New_York",
  "agentProviderId":"claude-code/sonnet"
}'

Required: title, message, repositoryUrl, baseBranch, cronExpression.

Optional: timezone (defaults to "UTC"), agentProviderId (provider/model override).

Read, Update, Delete

curl -sS "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -H "Authorization: Bearer $TWILL_API_KEY"

api -X PATCH "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -d '{
  "message":"Updated instructions",
  "cronExpression":"0 10 * * 1-5",
  "agentProviderId":"codex/gpt-5.2"
}'

curl -sS -X DELETE "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID" -H "Authorization: Bearer $TWILL_API_KEY"

api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID/pause" -d '{}'
api -X POST "$TWILL_BASE_URL/api/v1/scheduled-tasks/SCHEDULED_TASK_ID/resume" -d '{}'

Use userIntent (SWE, PLAN, ASK, DEV_ENVIRONMENT) when calling API endpoints directly.
Create task, report task.url, and only poll/stream logs when requested.
Ask for TWILL_API_KEY if missing.
Do not print API keys or other secrets.

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

102,600 周安装

Twill Cloud Coding Agent API 使用指南 - 自动化代码任务与工作流管理

🇨🇳中文介绍

Twill Cloud Coding Agent

设置

端点覆盖范围（公共 v1）

🇺🇸English

Twill Cloud Coding Agent

Setup

Endpoint Coverage (Public v1)

相关 Skills

认证与发现

任务

创建任务

列出任务

获取任务详情

发送后续消息

列出任务作业

批准计划

取消任务

归档任务

作业

流式传输作业日志（SSE）

取消作业

计划任务

列出和创建

读取、更新、删除

暂停和恢复

行为准则

Auth and Discovery

Tasks

Create Task

List Tasks

Get Task Details

Send Follow-Up Message

List Task Jobs

Approve Plan

Cancel Task

Archive Task

Jobs

Stream Job Logs (SSE)

Cancel Job

Scheduled Tasks

List and Create

Read, Update, Delete

Pause and Resume

Behavior

最新 Skills