dreaming

name	dreaming
description	Creative exploration during quiet hours. Turns idle heartbeat time into freeform thinking — hypotheticals, future scenarios, reflections, unexpected connections. Use when you want your agent to do something meaningful during low-activity periods instead of just returning HEARTBEAT_OK. Outputs written to files for human review later (like remembering dreams in the morning).

Dreaming

Creative, exploratory thinking during quiet hours. Not task-oriented work — freeform associative exploration that gets captured for later review.

Environment Variables

Variable	Required	Default	Description
WORKSPACE	No	Skill's parent directory (scripts/..)	Root directory where data/ and memory/ live. Optional — defaults to the skill's parent directory, which is correct for standard workspace layouts.

Directories Written

The skill writes to these directories (relative to WORKSPACE):

• data/dream-state.json — Tracks nightly dream count and last dream date
• data/dream-config.json — Optional custom topic configuration (user-created)
• memory/dreams/YYYY-MM-DD.md — Dream output files (written by the agent, not the script)

Setup

1. Configure quiet hours and topics

Edit skills/dreaming/scripts/should-dream.sh to customize:

• QUIET_START / QUIET_END — when dreaming can happen (default: 11 PM - 7 AM)
• TOPICS array — categories of exploration (see defaults for examples)