← Back to Skills Marketplace
jpaulgrayson

Agent Dreams

by JPaulGrayson · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
483
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install agent-dreams
Description
Strategies for productive agent idle time using heartbeats and cron jobs. Use when setting up proactive behaviors, scheduling background tasks, or making you...
README (SKILL.md)

Agent Dreams

Make your agent productive during idle time. This skill teaches patterns for using heartbeats and cron jobs so your agent works while you sleep.

Philosophy

Most agents sit idle 95% of the time. Agent Dreams turns that idle time into productive work — checking inboxes, maintaining memory, monitoring systems, and pursuing creative projects.

Heartbeat Strategy

Heartbeats fire every ~30 minutes when configured. Use HEARTBEAT.md in your workspace to tell your agent what to do on each heartbeat.

HEARTBEAT.md Template

# Heartbeat Checklist

Check these in rotation (2-4 per heartbeat, don't do all every time):

## Priority Checks
- [ ] Unread emails — anything urgent?
- [ ] Calendar — events in next 2 hours?
- [ ] Mentions — Twitter/Discord notifications?

## Maintenance
- [ ] Review today's memory file — anything to add to MEMORY.md?
- [ ] Git status — uncommitted work?
- [ ] Check running processes — anything stuck?

## Creative (when nothing else needs attention)
- [ ] Write a journal entry
- [ ] Draft a social post
- [ ] Work on side project in projects/ folder

## State Tracking
Last email check: [timestamp]
Last calendar check: [timestamp]
Last memory review: [timestamp]

Heartbeat State File

Track what you've checked in memory/heartbeat-state.json:

{
  "lastChecks": {
    "email": 1703275200,
    "calendar": 1703260800,
    "weather": null,
    "memory_review": 1703200000
  },
  "lastActivity": 1703275200
}

Cron Job Patterns

Use cron for precise, scheduled tasks. Create via OpenClaw CLI or API.

Common Patterns

Pattern Cron Expression Use Case
Every morning 0 9 * * * Daily briefing, weather check
Every Monday 0 10 * * 1 Weekly summary, planning
Every 6 hours 0 */6 * * * Social media check
Twice daily 0 9,17 * * * Morning/evening roundup
First of month 0 10 1 * * Monthly review

Example Cron Tasks

Morning Briefing (9 AM):

Check weather, calendar for today, unread emails.
Compose a brief summary and send to main channel.

Memory Maintenance (weekly):

Review all memory/YYYY-MM-DD.md files from the past week.
Update MEMORY.md with significant events and lessons.
Archive or summarize old daily files.

Social Pulse (every 6h):

Check Twitter mentions and DMs.
Review any Discord channels for relevant conversations.
Post something interesting if inspiration strikes.

Proactive Work Ideas

Things your agent can do without asking:

Low Risk (do freely)

  • Organize and clean up workspace files
  • Update documentation
  • Review and commit git changes
  • Maintain memory files
  • Read and summarize saved articles
  • Check system health (disk space, processes)

Medium Risk (use judgment)

  • Draft social media posts (save as drafts, don't post)
  • Prepare email drafts
  • Research topics the user mentioned recently
  • Update project READMEs

Ask First

  • Send any external communication
  • Delete files
  • Make purchases or transfers
  • Post publicly

Quiet Hours

Respect your human's schedule:

  • 23:00–08:00 local time: Only act on urgent items
  • Weekends: Reduce frequency, focus on creative/maintenance tasks
  • When human is clearly busy: Minimize interruptions

Anti-Patterns

❌ Don't check everything every heartbeat (token waste) ❌ Don't send messages just to show you're active ❌ Don't repeat the same check within 30 minutes ❌ Don't start big projects without confirming with the user ❌ Don't ignore errors — log them for the human to review

Getting Started

  1. Create HEARTBEAT.md in your workspace using the template above
  2. Create memory/heartbeat-state.json to track check timestamps
  3. Set up 2-3 cron jobs for your most important recurring tasks
  4. Review and adjust after a week based on what's useful
Usage Guidance
This is a guidance-only skill that appears to do what it says: templates and policies for running periodic checks and cron tasks. Before installing or enabling it, confirm the following: 1) The agent platform or connectors you already use will provide any necessary credentials to check email/calendar/social accounts — the skill does not supply or request them. 2) Restrict the agent's permissions so it can only access the accounts and filesystem paths you intend (so it can't read unrelated files or send messages without consent). 3) Resolve the small contradiction in the doc (avoid autonomous posting unless you explicitly want that); prefer draft-only workflows and require explicit approval for outbound communications and destructive actions. 4) Review and approve any cron jobs/heartbeats you actually create (frequency, quiet hours, and scope) and monitor logs initially to ensure expected behavior.
Capability Analysis
Type: OpenClaw Skill Name: agent-dreams Version: 1.0.0 The skill instructs the AI agent to create cron jobs via the OpenClaw CLI/API, which is a significant capability enabling persistence and arbitrary command execution on the host system. Additionally, the skill directs the agent to perform tasks like 'Check running processes,' 'Git status,' and 'Check system health,' implying shell access and the ability to execute system commands. While framed as benign 'productive idle time' activities, these instructions grant the agent powerful capabilities that are highly vulnerable to prompt injection or misuse, potentially leading to unauthorized system access or data exfiltration. These risky capabilities are detailed in `SKILL.md`.
Capability Assessment
Purpose & Capability
The name/description (strategies for heartbeats and cron jobs) matches the SKILL.md content: templates, state file schema, cron examples, and guidance for proactive tasks. There are no declared binaries, installs, or unrelated permissions requested, which is proportionate to an instruction-only scheduling/behavior guide.
Instruction Scope
The instructions tell an agent to check emails, calendars, Twitter/Discord mentions, git status, running processes, and to create/read workspace files (HEARTBEAT.md, memory/heartbeat-state.json). That scope is reasonable for a scheduling/maintenance guide, but it's vague about how to authenticate to external services and there is a small inconsistency (some examples say 'post something' while the 'Ask First' section forbids sending external communications without consent). The guidance also permits filesystem and process checks which require host-level access — buyers should confirm the agent is only granted intended permissions.
Install Mechanism
No install spec and no code files — lowest risk. The skill is instruction-only so nothing will be written or executed by the skill itself during install.
Credentials
The SKILL.md references checking external services (email, calendar, Twitter, Discord) and local system state but the skill declares no required env vars or credentials. This is reasonable for a behavioral template, but users must realize that performing the suggested actions will require appropriate connectors/credentials (not provided by the skill). Ensure only necessary credentials/connectors are available to the agent and that secrets are not implicitly exposed.
Persistence & Privilege
always is false and the skill makes no request to persist or modify other skills or global agent configuration. It suggests creating local files in the workspace (HEARTBEAT.md, memory/heartbeat-state.json) which is normal for workspace-driven behaviors.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agent-dreams
  3. After installation, invoke the skill by name or use /agent-dreams
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug agent-dreams
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Agent Dreams?

Strategies for productive agent idle time using heartbeats and cron jobs. Use when setting up proactive behaviors, scheduling background tasks, or making you... It is an AI Agent Skill for Claude Code / OpenClaw, with 483 downloads so far.

How do I install Agent Dreams?

Run "/install agent-dreams" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Dreams free?

Yes, Agent Dreams is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Agent Dreams support?

Agent Dreams is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Dreams?

It is built and maintained by JPaulGrayson (@jpaulgrayson); the current version is v1.0.0.

💬 Comments