Sleepless Agent
A continuous Claude Code task daemon for using idle Pro capacity on development work.
- Source repo
- context-machine-lab/sleepless-agent
- Stars
- ★ 837
- Last updated
- 7mo ago
- License
- MIT
- Primary language
- Python
- FA score
- 46/100 · Major gaps
At a glance
- How it runs
- Works with
- Platform-specificClaude Code
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- A solo developer with Claude Code Pro wants overnight handling of captured engineering ideas while retaining task outputs.
- Not a fit if
- Teams without a Claude Code Pro subscription or unwilling to use the Claude Code CLI
- Teams that don't want tasks auto-committing code or opening PRs
- Source review
- 46/100 · Major gaps 1 safety controls not found
What does this agent do, and when should you use it?
Sleepless Agent is a 24/7 development-task daemon powered by the Claude Code CLI and Python Agent SDK. It accepts work through Slack commands or the local sle CLI and persists tasks in a SQLite queue. The daemon executes work in isolated workspaces, stores results and metadata, and can make Git commits and pull requests according to task type. Its scheduler checks Claude Code Pro usage with claude /usage and pauses or resumes new task generation using separate day and night thresholds. Slack is optional, and the repository documents deployment through Linux systemd and macOS launchd.
A user submits a thought or project task with /think or sle think; the Slack bot or CLI places it in the SQLite Task Queue. The event loop in daemon.py schedules work, while claude_code_executor.py uses the Python Agent SDK to run the Claude Code CLI in an isolated task workspace; complex work can use configurable Planner, Worker, and Evaluator agents with independent turn limits. results.py stores outputs and metadata, monitor.py exposes health checks and metrics, and claude /usage informs whether generation and scheduling continue. Random thoughts can be committed to thought-ideas; project tasks submitted with -p can create feature/<project>-<task_id> branches and, when gh is installed and configured, pull requests.
- A solo developer with Claude Code Pro wants overnight handling of captured engineering ideas while retaining task outputs.
- A Slack-based engineering team wants to submit a backend task with
/think -p backend ...and review its work through a feature branch and PR. - A command-line-first developer does not want Slack administration and wants to manage tasks locally with
sle think,sle check, andsle report. - A user has independent development jobs to run concurrently and needs each job to receive its own workspace.
- A developer wants to conserve daytime Claude Code Pro capacity while allowing more aggressive overnight task execution through configured thresholds.
How do you install or deploy this agent?
Requires Python 3.11+, Node.js, Git, and an authenticated Claude Code CLI. Install the package with pip install sleepless-agent; install the CLI with npm install -g @anthropic-ai/claude-code; then run claude login and verify with claude --version. For a first run, start sle daemon and submit sle think "Research async Python patterns"; Slack is not required. To enable Slack, create a Socket Mode app, put SLACK_BOT_TOKEN and SLACK_APP_TOKEN in .env, then run sle daemon.
How do you use this agent?
Start sle daemon, then create a project task with sle think "Build onboarding flow" -p backend, or submit a random thought with sle think "Explore async patterns". Use sle check for daemon, queue, and usage status; sle usage for Claude Code Pro usage; and sle report 7 for task details. sle cancel 9 moves a task or project to trash, and sle trash restore <project> restores it. To override storage paths, run sle --db-path ./tmp/tasks.db --results-path ./tmp/results check. With Slack configured, use the matching /think, /check, /usage, /report, /cancel, and /trash commands; /chat <project> starts an interactive session in a dedicated thread.
What are this agent's strengths and limitations?
- Slack commands mirror the
sleCLI, and the CLI works without a Slack configuration. - The SQLite queue, result storage, reports, logs, and metrics are kept in a local workspace for persistent operation and traceability.
- Per-task isolated workspaces are paired with feature branches, automatic commits, and optional PR creation for project tasks.
- Configurable day and night thresholds make Claude Code Pro usage management part of task scheduling.
- Core execution depends on the Claude Code CLI, its authenticated session, and Claude Code Pro usage; no other model or API adapter is documented.
- Slack use requires workspace-admin setup of Socket Mode, OAuth scopes, event subscriptions, and two tokens.
- Automatic PR creation depends on the optional
ghCLI, and remote Git repository settings must be supplied by the user. - Tasks write to local workspaces and perform Git operations, so teams should assess isolation and review practices before enabling auto-commits or task auto-generation.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Sleepless Agent This agent | 46 · Major gaps | CLIFree + model costs | ★ 837 | 7mo ago | Python | Claude Code |
| myc Local Agent Memory | 87 · Good | CLIFree | ★ 14 | 18d ago | TypeScript | Codex · Claude Code |
| Sortie | 71 · Some gaps | CLIFree + model costs | ★ 215 | today | Go | Codex · Claude Code |
| Intent Agent Workbench | 60 · Some gaps | Desktop app | ★ 384 | today | JavaScript | — |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence shows: README describes hybrid autonomy (random thoughts auto-applied, serious tasks require review), but no implementation details for user confirmation; data flow described from Slack to queue to executor, but transparency not explicit; sensitive data handling only mentions env vars for tokens, no encryption or minimization; dependencies listed without version pinning or security audit; external effects include auto Git commits and PR creation, but no user confirmation or rollback mechanism; rollback only via trash soft delete, not full rollback; source attribution via citation and license, not verified. Deductions: lack of concrete implementation evidence for least privilege, user confirmation, data flow transparency, sensitive data handling, dependency security, external effects, rollback, and source attribution.
Evidence shows: version inconsistency between README (0.1.0) and pyproject (0.1.2), but overall description consistent; dependencies listed but no version pinning or mirror; failure messages not detailed in docs. Deductions: version inconsistency, dependency availability unverified, failure message documentation insufficient.
Evidence shows: README details multiple use cases (daily brainstorm, production fix, code audit) and provides both Slack and CLI interfaces; capability boundaries via task types and workspace constraints; trigger precision via commands and parameters; environment fit includes Windows/WSL PATH issues and systemd/launchd deployment. Deductions: capability boundaries and trigger precision based on docs, not code verification.
Evidence shows: README well-structured with install, config, usage, architecture, deployment sections; install notes detailed including pip and dev; naming stable (sle command); examples and FAQ links provided; known limitations not explicitly listed; license MIT; version in pyproject but inconsistent with README; maintenance responsibility not clear. Deductions: missing known limitations, version inconsistency, unclear maintenance responsibility.
Evidence shows: output usability via CLI and Slack commands including status checks and reports; marginal value in utilizing unused Claude quota at night; cost-benefit not backed by data, only claims of maximized usage. Deductions: cost-benefit lacks data support.
Evidence shows: claims in README (features, architecture) lack code references or test evidence; cross-source verification only via doc links, no independent verification; facts and inferences not clearly separated. Deductions: claims lack traceability, cross-verification insufficient, facts and inferences conflated.
- Not found in source: dependency securityPin versions and run a dependency audit (npm audit, pip-audit) before installing; prefer running it in a container.
- Version inconsistency: README mentions 0.1.0, pyproject 0.1.2, may cause confusion.
- Dependencies not pinned, supply chain risk.
- Auto Git commits and PR creation may have unintended external effects, configure carefully.
- Sensitive info like Slack tokens stored via env vars, no encryption mentioned.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.1.2 Sleepless Agent v0.1.2 - Dependency Update
Release notes excerpt
What's Changed 📦 Dependencies - Added requests to project dependencies for improved HTTP handling 🔧 Installation ```bash pip install sleepless-agent==0.1.2 ``` 📄 Full Changelog https://github.com/context-machine-lab/sleepless-agent/compare/v0.1.1...v0.1.2 --- *This is a patch release ensuring all required dependencies are properly declared.*View on GitHub ↗ -
v0.1.1 Sleepless Agent v0.1.1 - Architecture Overhaul & Documentation
Release notes excerpt
🚀 Sleepless Agent v0.1.1 This release represents a major architectural overhaul with comprehensive documentation, improved stability, and enhanced features for maximizing Claude Code Pro usage. 📊 Release Statistics - 38 commits since v0.1.0 - 87 files changed: 18,473 insertions(+), 4,282 deletions(-) - Complete restructuring with modular architecture ✨ What's New 🏗️ Major Improvements Architecture & Structure - Complete project restructuring with clean separation of concerns …View on GitHub ↗ -
v0.1.0 Sleepless Agent 0.1.0
Release notes excerpt
Sleepless Agent 0.1.0 Highlights: - Published the project as the sleepless_agent package on PyPI - Updated CLI, docs, and system scripts to use the new module path - Added MIT licensing and refreshed metadata for distribution PyPI: https://pypi.org/project/sleepless-agent/0.1.0/View on GitHub ↗
FAQ
Is Slack required?
sle CLI runs without Slack; Slack is an optional real-time interface for task submission and status checks.Does it require a Claude API key?
claude login, and states that a Claude API key is no longer needed.