Runspool · 本地优先的 CLI 工作流引擎(开源)开源项目Vibe Coding

1、场景：
个人和小团队的自动化往往从一个 Shell 脚本起步,随着任务变多逐渐失控，脚本跑到一半挂掉不知道执行到哪一步、重跑会重复做、没有历史记录、想暂停或重试只能去改代码。这个项目要解决的就是"让本地自动化变得可靠、可追溯、可控制"这一真实痛点,面向开发者、运维、使用 AI Agent和需要把重复流程自动化的技术人群或专业人群。CLI设计和AI 专用参数天然对接 AI Agent。
2、功能：
核心是一个本地优先(local-first)的命令行工作流引擎,主要功能模块包括:
任务队列与状态机(所有任务状态落 SQLite,崩溃重启都不丢进度);
步骤执行器与工作线程池(按每步并发配额调度);
命令行控制(add / run / daemon / status / inspect / logs / pause / resume / retry / terminate 等十多个命令);
插件化步骤系统(用户可自定义步骤类扩展工作流);
面向脚本与 AI Agent 的 JSON 输出(每个读命令支持 --json,返回当前状态、可用操作和下一步建议);
环境自检 doctor。
整套零外部依赖即可离线运行。
3、技术实现
我独立完成全部设计与开发:
Python 3.11+ 构建,基于 Typer 做 CLI、Pydantic 做配置校验、标准库 SQLite 做状态与事件存储;
设计了 queued→running→completed/failed/manual_required 的任务状态机,以及基于心跳超时的任务回收机制;
实现了"协调器 + 有界线程池"的并发模型和可插拔步骤注册表;
配套 CI、单元测试、文档与可运行示例,支持 pipx 一键安装。