pylot-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Dispatch a Mission

调度任务

bash

CONV_ID=$(ls ~/.claude/session-env/ | head -1)
pylot dispatch "<task>" --agent <team>.<role> --repo <org/repo> --context "conversation_id=$CONV_ID"

Always pass

--context conversation_id=…

for auto-wake. Prompt limit: 4 KB — put full specs in issue comments.

bash

CONV_ID=$(ls ~/.claude/session-env/ | head -1)
pylot dispatch "<task>" --agent <team>.<role> --repo <org/repo> --context "conversation_id=$CONV_ID"

请始终传递

--context conversation_id=…

以实现自动唤醒。提示词限制：4 KB——完整规格请放在议题评论中。

Monitor Missions

监控任务

bash

pylot missions list                      # recent missions
pylot missions view <job-id>             # full detail
pylot missions logs <job-id> --follow    # tail CloudWatch logs

Terminal statuses:

done

failed

cancelled

timeout

bash

pylot missions list                      # 近期任务
pylot missions view <job-id>             # 完整详情
pylot missions logs <job-id> --follow    # 追踪CloudWatch日志

终端状态包括：

done

、

failed

、

cancelled

、

timeout

。

Secrets Discovery

密钥发现

bash

pylot secrets tree                       # full secrets tree
pylot secrets get <path>                 # bundle keys + fingerprints (no values)

Load into conversation:

pylot conversations resources-add <conv-id> type=secret ref=pylot/<path>

bash

pylot secrets tree                       # 完整密钥树
pylot secrets get <path>                 # 捆绑密钥+指纹（不含值）

加载到对话中：

pylot conversations resources-add <conv-id> type=secret ref=pylot/<path>

Devboxes — Spawn + Prompt

开发环境（Devboxes）——创建与提示

bash

pylot workers spawn --conversation <conv-id>     # returns worker_id
pylot workers prompt <wid> "<text>"              # send prompt (returns turn_seq)
pylot workers view <wid>                         # status + metadata
pylot workers stop <wid>                         # terminate

For the full poll-to-idle drive loop, Read the

pylot-workers

skill on demand.

bash

pylot workers spawn --conversation <conv-id>     # 返回worker_id
pylot workers prompt <wid> "<text>"              # 发送提示词（返回turn_seq）
pylot workers view <wid>                         # 状态+元数据
pylot workers stop <wid>                         # 终止

如需完整的轮询至空闲驱动循环，请按需查阅

pylot-workers

技能文档。

Automations

自动化

bash

pylot automations list           # inventory with run stats
pylot automations get <name>     # single rule detail

Per-repo coverage: filter

only_repos

skip_repos

from list output.

bash

pylot automations list           # 包含运行统计的清单
pylot automations get <name>     # 单条规则详情

按仓库覆盖范围筛选：从列表输出中过滤

only_repos

skip_repos

参数。

Async Wake Pattern

异步唤醒模式

Dispatch with

--context conversation_id=…

→ auto-wake on mission terminal + PR lifecycle. Self-wake fallback:

pylot conversations wakes-add <conv-id> in_seconds=300 content="check X"

One wake at a time; re-schedule rather than stack.

使用

--context conversation_id=…

进行调度→任务结束及PR生命周期阶段自动唤醒。自唤醒备选方案：

pylot conversations wakes-add <conv-id> in_seconds=300 content="check X"

同一时间仅允许一次唤醒；请重新调度而非叠加唤醒任务。

Dispatch vs. Local

调度执行 vs 本地执行

Do locally	Dispatch
Answer questions, check status, query API	Code changes, PRs, reviews
Read logs, explain code	Docker builds, deploys
Quick lookups (< 2 min)	Test suites, anything > 10 min

本地执行场景	调度执行场景
解答问题、查看状态、查询API	代码变更、PR创建、代码评审
读取日志、解释代码	Docker构建、部署
快速查询（耗时<2分钟）	测试套件、任何耗时>10分钟的任务