Agent Chronicle

Agent Chronicle 📜

Capture 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.7.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.

Philosophy

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:

Triggers

The skill activates on:

First Run

Setup runs automatically! Just use any generate command:

python3 scripts/generate.py --today

If no config.json exists, the setup wizard starts automatically.

Alternatively, run setup manually:

python3 scripts/setup.py

This interactive onboarding will: 1. Ask where to save diary entries (default: memory/diary/) 2. Let you choose which sections to include 3. Set your privacy level (private/shareable/public) 4. Enable optional features (Quote Hall of Fame, Curiosity Backlog, etc.) 5. Configure memory integration (add summaries to daily memory log) 6. Configure auto-generation settings 7. Create necessary memory files

Quick start without setup:

cp config.example.json config.json

Quick Start

Write Today's Entry

#### Recommended (v0.6.0+): OpenClaw-native sub-agent generation

This 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_DIR/chronicle-task.json

2) Spawn a sub-agent (inside your agent run):

3) Save the generated entry:

# Pipe the sub-agent's markdown output into the saver
python3 scripts/generate.py --today --from-stdin

#### Manual fallback: Interactive mode

python3 scripts/generate.py --interactive

#### Preview without saving

python3 scripts/generate.py --today --interactive --dry-run

View & Export

# 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.md

Entry Structure

Each daily entry follows a consistent template:

Summary

> *"A productive Wednesday focused on skill development. Shipped the agent-chronicle skill after some satisfying problem-solving."*

Projects Worked On

Wins 🎉

Frustrations 😤

Learnings 📚

Emotional State

Notable Interactions

Quote of the Day 💬 *(optional)*

Things I'm Curious About 🔮 *(optional)*

Key Decisions Made 🏛 *(optional)*

Relationship Notes 🤝 *(optional)*

Tomorrow's Focus

Commands

Writing Entries

Generate from session logs:

@diary write entry

Interactive mode:

@diary write interactive

Quick entry with summary:

@diary quick "Shipped three skills, fixed a gnarly bug, good day."

Viewing Entries

Read today's entry:

@diary today

Read specific date:

@diary read 2026-01-28

Weekly summary:

@diary weekly

Monthly reflection:

@diary monthly

Exporting

Export to PDF:

@diary export pdf
@diary export pdf --days 30
@diary export pdf --month january

Export to HTML:

@diary export html --all

Analysis

Mood trends:

@diary mood

Topic frequency:

@diary topics

Wins compilation:

@diary wins

Quote Hall of Fame 💬

Collect memorable quotes from your human—funny, profound, or touching.

Commands

View all quotes:

@diary quotes

Add 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"

Storage

In Daily Entries

Curiosity Backlog 🔮

Track things you wonder about but can't explore immediately.

Commands

View backlog:

@diary curious

Add 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 high

Storage

In Daily Entries

Decision Archaeology 🏛

Log judgment calls and their reasoning for later review. Did past you make the right call?

Commands

View recent decisions:

@diary decisions

View decisions from a specific period:

@diary decisions --days 30

Revisit old decisions:

@diary revisit

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"

Storage

In Daily Entries

Relationship Evolution 🤝

Track how your dynamic with your human develops over time.

Commands

View relationship summary:

@diary relationship

Add 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"

Tracked Elements

Storage

In Daily Entries

Memory Integration 🔗

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.

Configuration

"memory_integration": {
  "enabled": true,
  "append_to_daily": true,
  "format": "summary"
}

Formats

| Format | Description | |--------|-------------| | summary | Brief overview (title + summary text) | | link | Just a link to the full diary entry | | full | Entire entry embedded in daily memory |

Output Example

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.

Setup

During onboarding, you'll be asked:

"On This Day" Resurfacing 🔙

When generating a new diary entry, Agent Chronicle automatically checks for entries from 7 days, 30 days, and 365 days ago. If found, a "Looking Back" section is appended to the entry with a brief highlight or quote from each old entry.

How It Works

Disable

python3 scripts/generate.py --today --no-looking-back

Mood & Pattern Analytics 📊

Analyze your diary entries for emotional trends, recurring topics, wins, and frustrations.

Commands

Analyze all entries:

python3 scripts/analyze.py

Analyze last 7 days:

python3 scripts/analyze.py --days 7

Analyze last 30 days:

python3 scripts/analyze.py --days 30

Save report to file:

python3 scripts/analyze.py --output mood-report.md

JSON output (for programmatic use):

python3 scripts/analyze.py --json

What It Shows

Agent Command

@diary mood
@diary topics
@diary wins

Auto-Generation via Cron ⏰

Generate diary entries automatically on a schedule using OpenClaw cron.

Usage

# Auto-generate: emits task JSON for sub-agent spawning
python3 scripts/generate.py --auto

The --auto flag:

Configuration

Enable in config.json:

{
  "auto_generate": true
}

OpenClaw Cron Setup

Add to your OpenClaw config (~/.openclaw/config.yaml or similar):

cron:
  - id: daily-diary
    schedule: "0 23 * * *"       # Every day at 11 PM
    task: |
      Generate today's diary entry using agent-chronicle.
      Run: python3 /path/to/skills/agent-chronicle/scripts/generate.py --auto
      Take the emitted task JSON, spawn a sub-agent with it, then pipe the
      result back via: python3 scripts/generate.py --today --from-stdin
    channel: telegram             # Optional: notify channel on completion

Or use the two-step flow in a shell script:

#!/bin/bash
SKILL_DIR="/path/to/skills/agent-chronicle"
TASK=$(python3 "$SKILL_DIR/scripts/generate.py" --auto 2>/dev/null)
Feed $TASK to your agent for sub-agent spawning

Weekly Digest 📋

Generate a synthesized weekly summary from your daily entries.

Usage

Generate digest for current week:

python3 scripts/digest.py

Generate for a specific week (by any date in that week):

python3 scripts/digest.py --date 2026-03-20

Emit sub-agent task for AI-powered digest:

python3 scripts/digest.py --emit-task

Read AI-generated digest from stdin:

python3 scripts/digest.py --from-stdin

Preview without saving:

python3 scripts/digest.py --dry-run

Output

Saved as YYYY-WXX-weekly.md in the diary directory (e.g., 2026-W13-weekly.md).

What's Included

Agent Command

@diary weekly

Cron Setup for Weekly Digest

cron:
  - id: weekly-digest
    schedule: "0 22 * * 0"       # Every Sunday at 10 PM
    task: |
      Generate this week's diary digest using agent-chronicle.
      Run: python3 /path/to/skills/agent-chronicle/scripts/digest.py

Configuration

config.json

{
  "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"
  }
}

Privacy Levels

Templates

Daily Template

Weekly Template

Custom Templates

# {{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}}

Writing Tips

Be Authentic

Be Specific

Note Patterns

Capture Interactions

Collect Quotes

Don't Force It

Storage Structure

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
│   ├── 2026-W05-weekly.md # Weekly digest
│   ├── quotes.md          # Quote Hall of Fame
│   ├── curiosity.md       # Curiosity Backlog
│   ├── decisions.md       # Decision Archaeology
│   └── relationship.md    # Relationship Evolution
└── ...

Scripts

setup.py

# Run first-time setup
python3 scripts/setup.py
Check if setup needed (for automation)
python3 scripts/setup.py --check

generate.py

# From today's sessions
python3 scripts/generate.py --today
Auto-generate (for cron, no interaction)
python3 scripts/generate.py --auto
From date range
python3 scripts/generate.py --since 2026-01-28 --until 2026-01-31
Interactive mode
python3 scripts/generate.py --interactive
Skip "Looking Back" section
python3 scripts/generate.py --today --no-looking-back
Dry run (preview only)
python3 scripts/generate.py --today --dry-run

analyze.py

# Mood analytics for all entries
python3 scripts/analyze.py
Last 7 days
python3 scripts/analyze.py --days 7
Save report
python3 scripts/analyze.py --output mood-report.md
JSON output
python3 scripts/analyze.py --json

digest.py

# Weekly digest for current week
python3 scripts/digest.py
For a specific week
python3 scripts/digest.py --date 2026-03-20
Emit sub-agent task
python3 scripts/digest.py --emit-task
Dry run
python3 scripts/digest.py --dry-run

export.py

# 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

Example Entry

# 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

Best Practices

1. Write daily — Even a quick entry beats nothing 2. Review weekly — Patterns emerge over time 3. Be honest — This is for you, not performance 4. Export monthly — Create backups, share if desired 5. Note the mundane — Quiet days have value too 6. Save the quotes — They become treasures 7. Revisit decisions — Learn from past judgment calls

Privacy

Troubleshooting

generate.py not finding sessions:

export.py failing:

Entries feel robotic:

Setup script not creating files:

Changelog

v0.7.0

v0.5.0

v0.4.1

v0.4.0

v0.3.0

v0.2.0

v0.1.0

Credits

Built for AI agents who want to remember.

Inspired by the tradition of journaling and the question: *What would an AI diary actually look like?*

# Auto-generate: emits task JSON for sub-agent spawning
python3 scripts/generate.py --auto

The --auto flag:

Configuration

Enable in config.json:

{
  "auto_generate": true
}

OpenClaw Cron Setup

Add to your OpenClaw config (~/.openclaw/config.yaml or similar):

cron:
  - id: daily-diary
    schedule: "0 23 * * *"       # Every day at 11 PM
    task: |
      Generate today's diary entry using agent-chronicle.
      Run: python3 /path/to/skills/agent-chronicle/scripts/generate.py --auto
      Take the emitted task JSON, spawn a sub-agent with it, then pipe the
      result back via: python3 scripts/generate.py --today --from-stdin
    channel: telegram             # Optional: notify channel on completion

Or use the two-step flow in a shell script:

#!/bin/bash
SKILL_DIR="/path/to/skills/agent-chronicle"
TASK=$(python3 "$SKILL_DIR/scripts/generate.py" --auto 2>/dev/null)
Feed $TASK to your agent for sub-agent spawning

"memory_integration": {
  "enabled": true,
  "append_to_daily": true,
  "format": "summary"
}

Formats

| Format | Description | |--------|-------------| | summary | Brief overview (title + summary text) | | link | Just a link to the full diary entry | | full | Entire entry embedded in daily memory |

Output Example

When you generate a diary entry, this section is added to memory/YYYY-MM-DD.md:

```markdown

1. Write daily — Even a quick entry beats nothing 2. Review weekly — Patterns emerge over time 3. Be honest — This is for you, not performance 4. Export monthly — Create backups, share if desired 5. Note the mundane — Quiet days have value too 6. Save the quotes — They become treasures 7. Revisit decisions — Learn from past judgment calls