@goodyorkye/drift

v0.1.3

Published

5 days ago

Autonomous AI agent task scheduling and execution system

0High
0Medium
0Low

goodyorkye

agent automation cli scheduler task-runner

Drift

Drift 是一个本地 Agent 任务调度工具。你可以把代码审查、资料整理、周期巡检、文档更新等工作定义成任务，Drift 会负责排队、调度，并调用本机已安装的 Claude 或 Codex CLI 去执行这些自定义任务。

它尤其适合把“需要 agent 定期或批量处理”的工作沉淀下来：

手动创建一次性任务，例如让 Codex 根据当前项目材料实现一个功能。
创建定时任务，例如每天调用 Claude 检查某个仓库的 Git 状态并生成审计报告。
让任务拥有独立工作目录、运行日志、重试记录和 artifacts，方便追踪每次 agent 执行结果。

Drift 本身不理解具体业务，也不替 agent 做决策。它只管理任务生命周期：创建任务、排队、定时触发、启动 runner、记录执行结果、处理重试/暂停/恢复。具体任务做什么、怎么做、产出什么，由 Claude、Codex 或其他 runner 根据任务材料自行完成。

当前内置的默认任务类型是 general（显示为“通用任务”）。当需求暂时不想细分到开发、调研、审查等专门类型时，直接用它就行。对于“任务目的本身就是生成某种内容”的任务，系统默认约定执行 agent 将最终有效内容落成工作目录内文件，并通过 artifactRefs 暴露为可下载产物；只有当任务明确要求“不要文件产物”时才例外。

本次版本重点

新增本地 Web UI：可查看任务、队列、定时任务、运行日志，并执行常见管理操作。
新增 Web Task Create Assistant：先在草稿目录中整理 spec/task.md，确认后再创建正式任务。
新增默认任务类型 general（“通用任务”），适合作为未细分场景下的默认入口。
内容型任务默认要求生成文件产物：创建助手会优先把“生成可下载文件”写进任务要求，执行 agent 默认把最终有效内容落成文件并写入 artifactRefs。

安装

不安装，直接运行：

npx @goodyorkye/drift --help
npx @goodyorkye/drift task add

或全局安装：

npm install -g @goodyorkye/drift
drift --help

Drift 需要 Node.js 20 或更新版本。

快速开始

在当前项目中创建任务：

drift task add

启动 orchestrator 和 scheduler：

drift start

查看运行情况：

drift status
drift task list
drift logs
drift web

Drift 首次在某个项目目录运行时，会在当前目录创建本地运行目录：

workspace/
task-types/

workspace/ 保存任务实例、队列 ticket、schedule、日志、run 记录和托管产物。task-types/ 保存任务类型定义。如果当前目录没有 task-types/，Drift 会从 npm 包内置模板复制一份默认任务类型到当前项目。

设计理念

Drift 只管理任务生命周期，不承载具体业务逻辑。
任务以 spec/task.md 为核心；该文件只要求存在且非空。
任务材料目录下的其他文件会作为附加材料保留和传递。
任务如何分解、如何执行，由执行 agent 自己决定。
每个任务实例都有独立的长期执行目录和 run 历史。
Agent 通过 agent-result.json 返回执行结果。

CLI 命令

| 命令 | 说明 | | --------------------------------- | --------------------------------------------------------------- | | drift task add | 交互式创建任务 | | drift task list | 查看任务及最后状态 | | drift task enqueue <id> | 将 not_queued 任务加入队列 | | drift task inspect <id> | 查看任务元数据、queue 状态、latest run、sessionRef 和 artifacts | | drift task resume <id> | 将 paused 任务恢复到 pending | | drift task abandon <id> | 将 paused 任务放弃并转为 blocked | | drift task rerun <id> | 将 done 或 blocked 任务从头重跑 | | drift task remove <id> | 删除任意非运行中任务；运行中任务需先停止 | | drift web | 启动本地 Web UI | | drift start | 启动 orchestrator 和 scheduler | | drift stop | 停止后台进程 | | drift status | 查看进程和队列概览 | | drift logs | 查看运行日志 | | drift schedule add | 交互式创建定时任务 | | drift schedule list | 查看定时任务 | | drift schedule run <id> | 手动触发一次定时任务 | | drift schedule clear-tasks <id> | 清除某个定时任务创建的全部非活动任务实例目录 | | drift schedule enable <id> | 启用定时任务 | | drift schedule disable <id> | 禁用定时任务 | | drift schedule remove <id> | 删除定时任务 |

运行目录

workspace/tasks/<taskId>/
  task.json
  spec/
    task.md
  workdir/
    agent-result.json
  runs/
    <runId>/
      run-meta.json
      agent-result.json
      stdout.log
      stderr.log
  managed-artifacts/

workspace/schedules/<scheduleId>/
  schedule.json
  schedule-state.json
  spec/
    task.md
  shared-state/

workspace/queue/
  pending/
  running/
  paused/
  done/
  blocked/

队列状态由 workspace/queue/<status>/ 下的轻量 ticket 文件表示。

AgentResult 协议

执行 agent 在当前 workdir/ 根目录写入 agent-result.json：

{
    "status": "success",
    "reason": "optional reason",
    "artifactRefs": ["relative/path/from/workdir.md"]
}

合法状态：

success | paused | blocked

artifactRefs 必须是相对 workdir/ 的路径。若进程异常退出、结果缺失或结果非法，runner 会记录系统兜底错误结果。

Runner

Drift 当前提供 Claude 和 Codex runner 适配层。没有检测到可用 runner 时，也可以先创建任务；任务会保留为 not_queued，之后再入队：

drift task enqueue <taskId>

第一版默认使用自动执行策略：

Claude runner 使用非交互执行，并启用权限绕过。
Codex runner 使用 exec --full-auto。

这些是当前 runner 的默认实现策略，不是所有 runner 都必须遵守的通用协议。

Web UI

启动本地 Web UI：

drift web

默认地址：

http://127.0.0.1:8787

常用选项：

drift web --allow-lan
drift web --read-only
drift web --port 9000

说明：

默认只监听本机地址。
--allow-lan 会监听局域网地址，但当前 没有认证；同一网络里能访问该地址的人都可以操作这个 workspace。
--read-only 会禁用所有写操作，适合只看状态或演示界面。
drift web 只启动 Web UI，不会替代 drift start 去拉起 orchestrator / scheduler。

当前 Web UI 已支持：

任务、队列、定时任务与日志查看
常用任务/定时任务管理动作
查看任务详情、历史 runs、stdout/stderr、spec/、workdir/ 和 managed artifacts
下载 managed artifacts 文件
Task Create Assistant：先创建草稿，再由创建助手整理 spec/task.md，最后确认 runner 与入队方式
在草稿工作台中手工编辑 task.md、新建空文件、上传附加文件

第一阶段 Web 创建器当前只覆盖 Task 创建；Schedule Create Assistant 仍按后续阶段推进。当用户选择手工创建时，Web 工作台不会显示创建助手会话区，而是直接进入草稿文件编辑流程。

创建任务

CLI 与 Web 的创建边界都遵循同一原则：

spec/task.md 仍是任务定义中心
创建助手只在当前草稿 spec/ 目录内工作
创建助手不执行任务本身，也不修改 queue / scheduler / shared-state
对内容型任务，创建助手默认应把“生成文件产物”写进任务要求；只有用户明确说不要文件时才例外

当前能力：

drift task add：完整 CLI 创建流程
Web Task Create Assistant：草稿目录 + 创建助手轮次调用 + 最终确认系统字段
drift schedule add：CLI 仍是当前 Schedule 创建入口

开发

npm install
npm run typecheck
npm test -- --run
npm run build

许可证

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme