Sleepless Agent

一个在你睡眠时也能为你工作的 24/7 AgentOS

你拥有 Claude Code Pro 但在晚上闲置不用吗？将其转化为一个 AgentOS，在你睡觉时处理你的想法和任务。这是一个由 Claude Code CLI 和 Python Agent SDK 驱动的 24/7 AI 助手守护进程，它可以通过 Slack 处理各种随机想法和严肃任务，并提供隔离的工作区环境。

📰 新闻

• [2025-10-26] 🎉 发布初始版本 v0.1.0 - 具备多智能体工作流支持的完整 AgentOS
• [2025-10-25] 🚀 增加带可配置策略的任务自动生成功能
• [2025-10-24] 🔧 集成 Git 管理，支持自动创建 PR
• [2025-10-23] 📊 实现隔离工作区，支持并行任务执行
• [2025-10-22] 💡 增加 Claude Code Python Agent SDK 集成

🎬 演示

显示任务从 Slack 到工作区执行流程的系统架构

Sleepless Agent CLI 演示 - 管理任务、检查状态并生成报告

快速示例

# 启动守护进程
$ sle daemon
2025-10-26 03:30:12 | INFO | Sleepless Agent starting...
2025-10-26 03:30:12 | INFO | Slack bot connected

# 通过 Slack 提交任务
/think Implement OAuth2 authentication -p backend

# 检查状态
$ sle check
╭─────────────────── System Status ───────────────────╮
│ 🟢 Daemon: Running                                  │
│ 📊 Queue: 3 pending, 1 in_progress                  │
│ 💻 Usage: 45% (Day threshold: 95%)                  │
│ 🔄 Last task: "Implement OAuth2..." (in progress)   │
╰─────────────────────────────────────────────────────╯

# 查看结果
$ sle report 42
Task #42: ✅ Completed
Branch: feature/backend-42
PR: https://github.com/user/repo/pull/123

✨ 功能特点

• 🤖 持续运行：24/7 守护进程，随时准备接收新任务
• 💬 Slack 集成：通过 Slack 命令提交任务
• 💭 交互式聊天模式：在 Slack 线程中与 Claude 进行实时会话
• 🎯 混合自治：自动处理随机想法，严肃任务需人工审核
• ⚡ 智能调度：根据优先级优化任务执行
• 📊 任务队列：基于 SQLite 的持久化任务管理
• 🔌 Claude Code SDK：使用 Python Agent SDK 与 Claude Code CLI 对接
• 🏗️ 隔离工作区：每个任务拥有独立的工作区，实现真正的并行处理
• 📝 结果存储：所有输出及元数据均会保存，以备日后参考

⚙️ 前置要求

• Python 3.11+
• 已安装 Claude Code CLI (npm install -g @anthropic-ai/claude-code)
• Git（用于自动 commit）
• gh CLI（可选，用于 PR 自动化）
• Slack 工作区管理员权限（可选 — sle CLI 无需 Slack 即可运行）

💡 Slack 是可选的。 你可以在不配置 Slack 的情况下运行所有 sle CLI 命令。Slack 集成提供了一个便捷的实时界面来提交任务和检查状态，但每一项功能也都可以通过 CLI 使用。

🚀 快速开始

1. 安装

pip install sleepless-agent

或者进行开发安装：

git clone 
cd sleepless-agent
python -m venv venv
source venv/bin/activate  # 或在 Windows 上执行 venv\Scripts\activate
pip install -e .

⚠️ Windows / WSL 提示： 执行 pip install 后，如果 Python 的 Scripts 目录未包含在 PATH 中，可能会提示找不到 sle 命令。请参考下方的 故障排除: sle 命令找不到。

2. 验证 Claude Code（必需）

# 安装 Claude Code CLI (需要 Node.js)
npm install -g @anthropic-ai/claude-code

# 登录 (会打开浏览器)
claude login

# 验证
claude --version

3. (可选) 不使用 Slack 启动

Slack 集成不是必须的。你可以直接使用 sle CLI：

# 启动守护进程 (无需 Slack)
sle daemon

# 将任务加入队列
sle think "Research async Python patterns"

# 检查状态
sle check

如果你需要 Slack 集成，请继续阅读下方的设置说明。

4. 设置 Slack App

访问 https://api.slack.com/apps 并创建一个新应用：

基本信息 (Basic Information)

• 选择 "From scratch"
• 名称: "Sleepless Agent"
• 选择你的工作区

启用 Socket Mode

• Settings > Socket Mode > 切换至 ON
• 生成 App Token (以 xapp- 开头)

创建斜杠命令 (Slash Commands) Settings > Slash Commands > Create New Command:

• /think - 记录想法或任务（严肃任务请使用 -p project-name）
• /chat - 开启交互式聊天模式