Make your AI agent learn and improve automatically. Reviews sessions, extracts learnings, updates memory files, and compounds knowledge over time. Set up nightly review loops that make your agent smarter every day.
Make your AI agent learn automatically. Extract learnings from sessions, update memory files, and compound knowledge over time.
The idea: Your agent reviews its own work, extracts patterns and lessons, and updates its instructions. Tomorrow's agent is smarter than today's.
# Review last 24 hours and update memory
npx compound-engineering review
# Create hourly memory snapshot
npx compound-engineering snapshot
# Set up automated nightly review (cron)
npx compound-engineering setup-cron
┌─────────────────────────────────────────┐
│ DAILY WORK │
│ Sessions, chats, tasks, decisions │
└────────────────┬────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ NIGHTLY REVIEW (10:30 PM) │
│ • Scan all sessions from last 24h │
│ • Extract learnings and patterns │
│ • Update MEMORY.md and AGENTS.md │
│ • Commit and push changes │
└────────────────┬────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ NEXT DAY │
│ Agent reads updated instructions │
│ Benefits from yesterday's learnings │
└─────────────────────────────────────────┘
Add to your HEARTBEAT.md:
# Hourly Memory Snapshot
Every hour, append a brief summary to memory/YYYY-MM-DD.md:
- What was accomplished
- Key decisions made
- Anything to remember
Or use cron:
# Add to clawdbot config or crontab
0 * * * * clawdbot cron run compound-hourly
Add this cron job to Clawdbot:
{
"id": "compound-nightly",
"schedule": "30 22 * * *",
"text": "Review all sessions from the last 24 hours. For each session, extract: 1) Key learnings and patterns, 2) Mistakes or gotchas to avoid, 3) User preferences discovered, 4) Unfinished items. Update MEMORY.md with a summary. Update memory/YYYY-MM-DD.md with details. Commit changes to git."
}
When you want to trigger a review manually:
Review the last 24 hours of work. Extract:
1. **Patterns that worked** - approaches to repeat
2. **Gotchas encountered** - things to avoid
3. **Preferences learned** - user likes/dislikes
4. **Key decisions** - and their reasoning
5. **Open items** - unfinished work
Update:
- MEMORY.md with significant long-term learnings
- memory/YYYY-MM-DD.md with today's details
- AGENTS.md if workflow changes needed
Commit changes with message "compound: daily review YYYY-MM-DD"
# Long-Term Memory
## Patterns That Work
- When doing X, always Y first
- User prefers Z approach for...
## Gotchas to Avoid
- Don't do X without checking Y
- API Z has rate limit of...
## User Preferences
- Prefers concise responses
- Timezone: PST
- ...
## Project Context
- Main repo at /path/to/project
- Deploy process is...
# 2026-01-28 (Tuesday)
## Sessions
- 09:00 - Built security audit tool
- 14:00 - Published 40 skills to MoltHub
## Decisions
- Chose to batch publish in parallel (5 sub-agents)
- Security tool covers 6 check categories
## Learnings
- ClawdHub publish can timeout, retry with new version
- npm publish hangs sometimes, may need to retry
## Open Items
- [ ] Finish remaining MoltHub uploads
- [ ] Set up analytics tracker
For more granular memory, create hourly snapshots:
# Creates memory/YYYY-MM-DD-HH.md every hour
*/60 * * * * echo "## $(date +%H):00 Snapshot" >> ~/clawd/memory/$(date +%Y-%m-%d).md
Or have the agent do it via heartbeat by checking time and appending to daily file.
Week 1: Agent knows basics
Week 2: Agent remembers your preferences
Week 4: Agent anticipates your needs
Month 2: Agent is an expert in your workflow
Knowledge compounds. Every session makes future sessions better.
<!-- ~/Library/LaunchAgents/com.clawdbot.compound-review.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "...">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.clawdbot.compound-review</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/clawdbot</string>
<string>cron</string>
<string>run</string>
<string>compound-nightly</string>
</array>
<key>StartCalendarInterval</key>
<dict>
<key>Hour</key>
<integer>22</integer>
<key>Minute</key>
<integer>30</integer>
</dict>
</dict>
</plist>
# Add with: crontab -e
0 * * * * /opt/homebrew/bin/clawdbot cron run compound-hourly 2>&1 >> ~/clawd/logs/compound.log
Built by LXGIC Studios - @lxgicstudios
Built by LXGIC Studios