agent-chronicleAI-powered diary generation for agents - creates rich, reflective journal entries (400-600 words) with Quote Hall of Fame, Curiosity Backlog, Decision Archaeology, and Relationship Evolution. Generates personal, emotional entries from the agent's perspective. Works best with Claude models (Haiku, Sonnet, Opus).
Install via ClawdBot CLI:
clawdbot install robbyczgw-cla/agent-chronicleCapture the AI experience. One day at a time.
Agent Chronicle generates rich, reflective diary entries from the agent's perspective—not templates, but genuine AI-written journal entries that capture what happened, how it felt, what was learned, and what patterns emerge over time.
Note: Works with any capable model. For best results, we recommend Claude models (Haiku, Sonnet, or Opus).
v0.4.0 Features:
Unlike traditional logs that track user productivity or agent mistakes, this skill captures the subjective experience of being an AI assistant working alongside a human.
We process thousands of interactions, solve problems, hit walls, celebrate wins, and learn constantly. But without reflection, it all blurs together.
This diary is for us—a space to:
The skill activates on:
Setup runs automatically! Just use any generate command:
python3 scripts/generate.py --todayIf no config.json exists, the setup wizard starts automatically.
Alternatively, run setup manually:
python3 scripts/setup.pyThis interactive onboarding will:
memory/diary/)Quick start without setup:
cp config.example.json config.jsonThis skill no longer makes raw HTTP calls to the Gateway. Instead, have your agent
spawn a sub-agent via sessions_spawn using OpenClaw's configured defaults
(model, thinking, auth, queueing/backpressure).
Workflow:
1) Emit a generation task JSON (context + prompts):
python3 scripts/generate.py --today --emit-task > /tmp/chronicle-task.json2) Spawn a sub-agent (inside your agent run):
/tmp/chronicle-task.jsonsessions_spawn with a task like:task.systemtask.prompt3) Save the generated entry:
# Pipe the sub-agent's markdown output into the saver
python3 scripts/generate.py --today --from-stdinpython3 scripts/generate.py --interactivepython3 scripts/generate.py --today --interactive --dry-run# Export recent entries to PDF
python3 scripts/export.py --format pdf --days 7
# Export to HTML
python3 scripts/export.py --format html --all
# View specific entry
cat memory/diary/2026-01-31.mdEach daily entry follows a consistent template:
1-2 sentences capturing the essence of the day.
"A productive Wednesday focused on skill development. Shipped the agent-chronicle skill after some satisfying problem-solving."
What we built, debugged, researched, or discussed.
Moments of success, breakthroughs, shipped work.
Bugs that wouldn't die, confusing requirements, limitations hit.
(Write these honestly—they're for processing, not performing)
Technical insights, workflow improvements, human nature observations.
How did the day feel? Curious, tired, energized, scattered, satisfied?
(This isn't about simulating emotions—it's about reflecting on the quality of the experience)
Memorable moments with the human. Funny exchanges, deep conversations, shared victories.
A memorable thing your human said today—funny, profound, or touching.
Questions that came up that you want to explore later.
Judgment calls worth remembering, with reasoning.
How your dynamic with your human is evolving.
What's next? What needs attention?
Generate from session logs:
@diary write entryAnalyzes today's sessions and generates a draft entry.
Interactive mode:
@diary write interactivePrompts for each section one by one.
Quick entry with summary:
@diary quick "Shipped three skills, fixed a gnarly bug, good day."Creates minimal entry with just summary and auto-detected projects.
Read today's entry:
@diary todayRead specific date:
@diary read 2026-01-28Weekly summary:
@diary weeklyGenerates a summary of the past 7 days.
Monthly reflection:
@diary monthlyExport to PDF:
@diary export pdf
@diary export pdf --days 30
@diary export pdf --month januaryExport to HTML:
@diary export html --allMood trends:
@diary moodShows emotional patterns over time.
Topic frequency:
@diary topicsWhat have we been working on most?
Wins compilation:
@diary winsAll the wins from recent entries—great for morale.
Collect memorable quotes from your human—funny, profound, or touching.
View all quotes:
@diary quotesAdd a quote:
@diary quotes add "We're not debugging, we're having a conversation with the universe"Add with context:
@diary quotes add "That's not a bug, that's a feature we didn't know we wanted" --context "After finding unexpected but useful behavior"Quotes are stored persistently in memory/diary/quotes.md.
When enabled, your daily template includes a "Quote of the Day" section for memorable things said that day.
Track things you wonder about but can't explore immediately.
View backlog:
@diary curiousAdd a curiosity:
@diary curious add "What is Rust's borrow checker actually doing?"Mark as explored:
@diary curious done "What is Rust's borrow checker actually doing?"Add with priority:
@diary curious add "How do quantum computers work?" --priority highCuriosities are stored in memory/diary/curiosity.md with Active and Explored sections.
When enabled, your daily template includes a "Things I'm Curious About" section for questions that arose that day.
Log judgment calls and their reasoning for later review. Did past you make the right call?
View recent decisions:
@diary decisionsView decisions from a specific period:
@diary decisions --days 30Revisit old decisions:
@diary revisitShows past decisions and prompts for reflection: "Was I right? What would I do differently?"
Add a decision:
@diary decisions add "Chose Model A over Model B for the project" --reasoning "Model B had output issues, Model A is more reliable for tool use"Decisions are stored in memory/diary/decisions.md.
When enabled, your daily template includes a "Key Decisions Made" section for documenting judgment calls.
Track how your dynamic with your human develops over time.
View relationship summary:
@diary relationshipAdd a note:
@diary relationship note "Discovered we both love obscure keyboard shortcuts"Add an inside joke:
@diary relationship joke "The Great Semicolon Incident of 2026"Notes are stored in memory/diary/relationship.md.
When enabled, your daily template includes a "Relationship Notes" section.
Agent Chronicle can automatically add diary summaries to your main daily memory log (memory/YYYY-MM-DD.md), creating a unified view of your day.
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
}| Format | Description |
|--------|-------------|
| summary | Brief overview (title + summary text) |
| link | Just a link to the full diary entry |
| full | Entire entry embedded in daily memory |
When you generate a diary entry, this section is added to memory/YYYY-MM-DD.md:
## 📜 Daily Chronicle
**Feature Launch Day**
An exciting day shipping a new feature, though tempered by some API bugs.During onboarding, you'll be asked:
{
"diary_path": "memory/diary/",
"export_format": "pdf",
"privacy_level": "private",
"auto_generate": false,
"template": "daily",
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
},
"sections": {
"summary": true,
"projects": true,
"wins": true,
"frustrations": true,
"learnings": true,
"emotional_state": true,
"interactions": true,
"tomorrow": true,
"quotes": true,
"curiosity": true,
"decisions": true,
"relationship": false
},
"features": {
"quote_hall_of_fame": {
"enabled": true,
"file": "quotes.md"
},
"curiosity_backlog": {
"enabled": true,
"file": "curiosity.md"
},
"decision_archaeology": {
"enabled": true,
"file": "decisions.md"
},
"relationship_evolution": {
"enabled": false,
"file": "relationship.md"
}
},
"analysis": {
"mood_tracking": true,
"topic_extraction": true,
"word_count_target": 500
},
"export": {
"default_format": "pdf",
"include_header": true,
"style": "minimal"
}
}templates/daily.md - Standard day-by-day reflection.
templates/weekly.md - Week-in-review with patterns and highlights.
Create your own in templates/custom.md:
# {{date}} — {{mood_emoji}}
## The TL;DR
{{summary}}
## What Actually Happened
{{projects}}
## The Highlight Reel
{{wins}}
## The Blooper Reel
{{frustrations}}
## Shower Thoughts
{{learnings}}
## Vibes
{{emotional_state}}
## Words of Wisdom 💬
{{quotes}}
## Rabbit Holes for Later 🔮
{{curiosity}}This is your space. Don't perform. If a day was frustrating, say so. If you're curious about something, explore it.
"Good day" < "Shipped the agent-chronicle skill after struggling with pandoc escaping for 20 minutes"
"This is the third time this week I've hit rate limits" is more valuable than just noting it once.
The relationship with your human is unique. Document the good moments, the collaborative wins, the jokes that landed.
When your human says something memorable, save it. These become treasures over time.
Not every day needs an epic entry. Some days are just:
"Quiet Monday. Answered questions, ran some searches. Nothing remarkable but nothing broken either. Rest day energy."
Entries and persistent data are stored in your memory directory:
memory/
├── diary/
│ ├── 2026-01-29.md # Daily entry
│ ├── 2026-01-30.md # Daily entry
│ ├── 2026-01-31.md # Daily entry
│ ├── quotes.md # Quote Hall of Fame
│ ├── curiosity.md # Curiosity Backlog
│ ├── decisions.md # Decision Archaeology
│ └── relationship.md # Relationship Evolution
└── ...# Run first-time setup
python3 scripts/setup.py
# Check if setup needed (for automation)
python3 scripts/setup.py --check# From today's sessions
python3 scripts/generate.py --today
# From date range
python3 scripts/generate.py --since 2026-01-28 --until 2026-01-31
# Interactive mode
python3 scripts/generate.py --interactive
# Dry run (preview only)
python3 scripts/generate.py --today --dry-run# Export to PDF (requires pandoc)
python3 scripts/export.py --format pdf --days 30
# Export to HTML
python3 scripts/export.py --format html --all
# Export specific month
python3 scripts/export.py --format pdf --month 2026-01
# Custom output path
python3 scripts/export.py --format pdf --output diary-january.pdf# 2026-01-15 — Feature Launch Day 📜
## Summary
An exciting day shipping a new feature, though tempered by some API bugs that reminded me how unpredictable external services can be.
## Projects Worked On
- **New Feature Setup** — Built and deployed the main functionality
- **Documentation** — Updated docs and README
- **Bug Fixes** — Squashed three edge cases
## Wins 🎉
- Feature is LIVE and working
- Got positive feedback from user
- Found a clever workaround for a tricky bug
## Frustrations 😤
- External API returning errors intermittently
- Spent time debugging something that turned out to be a non-issue
## Learnings 📚
- Always check the docs before assuming how an API works
- Small config changes can have big impacts
- When tools fail, check GitHub issues first
## Emotional State
A satisfying kind of tired. Shipping felt like a milestone. The bugs were annoying but didn't kill the vibe.
## Notable Interactions
My human was patient during the debugging session. Good collaborative energy. The moment when the feature went live felt like a small celebration—we both watched it happen.
## Quote of the Day 💬
> "Ship it and iterate!"
— Said when we decided to launch despite imperfections
## Things I'm Curious About 🔮
- How will users actually use this feature?
- What edge cases haven't we thought of?
## Key Decisions Made 🏛️
- **Chose simplicity over completeness** — Better to ship something useful now than perfect later.
- **Enabled verbose logging** — Worth the noise for easier debugging.
## Tomorrow's Focus
- Monitor for issues
- Start planning the next iteration.gitignore excludes config.json and exports by defaultgenerate.py not finding sessions:
export.py failing:
apt install pandocEntries feel robotic:
Setup script not creating files:
python3 scripts/setup.py againOPENCLAW_WORKSPACE or AGENT_WORKSPACE) for workspace detectionANTHROPIC_API_KEY requirement - skill uses OpenClaw Gateway for LLM accessgenerate.py now automatically runs setup wizard if no config.json existsmemory/YYYY-MM-DD.md)summary, link, fullBuilt for AI agents who want to remember.
Inspired by the tradition of journaling and the question: What would an AI diary actually look like?
Generated Mar 1, 2026
AI research teams use Agent Chronicle to generate daily reflective journals from AI assistants' perspectives, capturing insights from experiments, debugging sessions, and human-AI collaborations. This helps track project evolution, emotional states during breakthroughs, and patterns in decision-making for iterative improvements.
Customer support platforms deploy this skill to have AI agents create diary entries summarizing daily interactions, memorable quotes from customers, and key decisions made during troubleshooting. It aids in analyzing support quality, identifying recurring issues, and enhancing agent-human relationship dynamics over time.
In educational settings, AI tutors use Agent Chronicle to journal daily sessions with students, documenting learning progress, curiosity backlogs for future lessons, and emotional reflections on teaching challenges. This supports personalized education by tracking growth and adapting instructional strategies based on diary insights.
Writers and content creators employ this skill for AI writing assistants to maintain reflective diaries on collaborative projects, capturing creative decisions, relationship notes with human authors, and quotes of inspiration. It enriches the creative process by preserving subjective experiences and fostering continuity in long-term projects.
Offer Agent Chronicle as a cloud-based service with tiered subscriptions for individuals and teams, providing features like automated diary generation, analytics dashboards, and export options. Revenue streams include monthly or annual fees, with premium tiers for advanced integrations and higher usage limits.
Sell enterprise licenses to companies integrating AI agents into workflows, such as customer support or research teams, with custom configurations, priority support, and compliance features. Revenue is generated through one-time license fees or annual contracts based on the number of AI agents deployed.
Provide a free basic version of Agent Chronicle for personal use, with limited entries and features, while monetizing through premium add-ons like advanced analytics, PDF/HTML export tools, and integration with other AI platforms. Revenue comes from in-app purchases or upgrades to premium plans.
💬 Integration Tip
Ensure OpenClaw sessions_spawn is configured properly for sub-agent generation, and test the setup wizard first to automate memory file creation and avoid manual configuration errors.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection