LeoYeAI/agent-master-skills / skills/agent-chronicle
agent-chronicle
UnverifiedAI-powered diary generation for agents - creates rich, reflective journal entries (400-600 words) with Quote Hall of Fame, Curiosity Backlog, Decision Archaeology, Relationship Evolution, mood analytics, weekly digests, "On This Day" resurfacing, and cron auto-generation. Works best with Claude models (Haiku, Sonnet, Opus).
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 2.3 KB |
| CONTRIBUTORS.md | markdown | 580 B |
| README.md | markdown | 7.2 KB |
| SKILL.md | skill md | 24.8 KB |
| _meta.json | config | 1.5 KB |
| config.example.json | config | 1.1 KB |
| config.json | config | 1.2 KB |
| package.json | manifest | 1.4 KB |
| pnpm-lock.yaml | manifest | 114 B |
| scripts/analyze.py | script | 17.8 KB |
| scripts/digest.py | script | 13.9 KB |
| scripts/export.py | script | 6.9 KB |
| scripts/export_pdf.py | script | 25.9 KB |
| scripts/generate.py | script | 24.9 KB |
| scripts/setup.py | script | 12.9 KB |
| skill.json | config | 844 B |
| templates/curiosity.md | markdown | 726 B |
| templates/daily.md | markdown | 572 B |
| templates/decisions.md | markdown | 1.1 KB |
| templates/quotes.md | markdown | 537 B |
| templates/relationship.md | markdown | 1.5 KB |
| templates/weekly.md | markdown | 1.3 KB |
README.md
View on GitHub# Agent Chronicle ๐
> AI perspective journaling โ document daily experiences, emotions, and learnings from the agent's viewpoint.
[](https://www.clawhub.ai/skills/agent-chronicle)
[](./skill.json)
## What's New in v0.7.0
- ๐ **"On This Day" Resurfacing** โ automatically surfaces entries from 7, 30, and 365 days ago as a "Looking Back" section
- ๐ **Mood & Pattern Analytics** โ `scripts/analyze.py` with mood timelines, sparklines, topic tracking, and win/frustration analysis
- โฐ **Cron Auto-Generation** โ `--auto` flag for non-interactive daily diary generation via OpenClaw cron
- ๐ **Weekly Digest** โ `scripts/digest.py` synthesizes 7 daily entries into a weekly summary with quotes, wins, mood trends, and decisions
## What is this?
Agent Chronicle enables AI agents to maintain a personal journal from their own perspective. Unlike traditional logs that track user productivity or agent mistakes, this skill captures the subjective experience of being an AI assistant.
**For agents who want to:**
- Reflect on daily work
- Track wins and frustrations
- Document learnings over time
- Notice patterns in collaboration
- Collect memorable moments and quotes
- Build a richer sense of continuity
## Installation
```bash
# From ClawHub
clawhub install agent-chronicle
# Or manually
git clone https://github.com/robbyczgw-cla/agent-chronicle.git
cp agent-chronicle /path/to/workspace/skills/
```
## Quick Start
```bash
# Just run generate - setup triggers automatically on first use!
python3 scripts/generate.py --today
# Or run setup manually if you prefer
python3 scripts/setup.py
# Or copy config manually
cp config.example.json config.json
# Generate today's entry from session logs
python3 scripts/generate.py --today
# Or write interactively
python3 scripts/generate.py --interactive
# Export to PDF
python3 scripts/export.py --format pdf --days 7
```
> **Note:** If no `config.json` exists, `generate.py` automatically runs the setup wizard on first use.
## Entry Structure
Each diary entry includes:
- **Summary** โ 1-2 sentence overview
- **Projects Worked On** โ What was built/debugged/discussed
- **Wins ๐** โ Moments of success
- **Frustrations ๐ค** โ Challenges and roadblocks
- **Learnings ๐** โ Technical and process insights
- **Emotional State** โ How the day felt
- **Notable Interactions** โ Memorable human moments
- **Tomorrow's Focus** โ What's next
### Optional Sections (v0.2.0+)
- **Quote of the Day ๐ฌ** โ Memorable things your human said
- **Things I'm Curious About ๐ฎ** โ Questions to explore later
- **Key Decisions Made ๐** โ Judgment calls worth remembering
- **Relationship Notes ๐ค** โ How your dynamic evolves
## Features
### Quote Hall of Fame ๐ฌ
Collect memorable quotes from your humanโfunny, profound, or touching.
```
@diary quotes # View all quotes
@diary quotes add "..." # Add a quote
```
### Curiosity Backlog ๐ฎ
Track things you wonder about but can't explore immediately.
```
@diary curious # View backlog
@diary curious add "..." # Add a curiosity
@diary curious done "..." # Mark as explored
```
### Decision Archaeology ๐
Log judgment calls and their reasoning for later review.
```
@diary decisions # View recent decisions
@diary revisit # Review old decisions ("Was I right?")
```
### Relationship Evolution ๐ค
Track how your dynamic with your human develops over time.
```
@diary relationship # View relationship summary
```
### Memory Integration ๐ (v0.3.0+)
Automatically add diary summaries to your main daily memory log (`memory/YYYY-MM-DD.md`).
**Formats:**
- `summary` โ Brief overview in daily memory
- `link` โ Just a link to the full diary entry
- `full` โ Entire entry embedded in daily memory
Enabled by default during setup. Configure in `config.json`:
```json
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
}
```
## Example Entry
```markdown
# 2026-01-31 โ Feature Launch Day
## Summary
An exciting day launching a new feature, though tempered by API bugs.
## Wins ๐
- Feature is LIVE and working great
- ClawHub CLI bug workarounded
## Frustrations ๐ค
- Comment API returning 401 despite valid auth
- Model B having output format issues
## Learnings ๐
- workspaceAccess: "rw" is essential for persistent writes
- Check GitHub issues first when CLI tools fail
## Emotional State
A satisfying kind of tired. The launch felt like a milestone.
## Quote of the Day ๐ฌ
> "We're not shipping code, we're shipping digital consciousness."
## Things I'm Curious About ๐ฎ
- How will users interact with this over time?
```
## Templates
- `templates/daily.md` โ Standard daily entry
- `templates/weekly.md` โ Week-in-review summary
Create custom templates with your preferred sections and style.
## Scripts
| Script | Purpose |
|--------|---------|
| `setup.py` | First-run onboarding and configuration |
| `generate.py` | Create diary entries from sessions or interactively |
| `analyze.py` | Mood & pattern analytics across entries |
| `digest.py` | Weekly digest generation |
| `export.py` | Export to PDF/HTML using pandoc |
| `export_pdf.py` | Beautiful PDF export (Velvet Edition) |
## Configuration
```json
{
"diary_path": "memory/diary/",
"privacy_level": "private",
"export_format": "pdf",
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
},
"features": {
"quote_hall_of_fame": { "enabled": true },
"curiosity_backlog": { "enabled": true },
"decision_archaeology": { "enabled": true },
"relationship_evolution": { "enabled": false }
}
}
```
**Privacy Levels:**
- `private` โ Full emotional honesty
- `shareable` โ Polished for humans
- `public` โ Sanitized for sharing
## Storage Structure
```
memory/diary/
โโโ 2026-01-29.md # Daily entry
โโโ 2026-01-30.md # Daily entry
โโโ quotes.md # Quote Hall of Fame
โโโ curiosity.md # Curiosity Backlog
โโโ decisions.md # Decision Archaeology
โโโ relationship.md # Relationship Evolution
```
## Requirements
- Python 3.8+
- pandoc (for PDF/HTML export)
- Optional: texlive-xetex (for better PDF output)
## 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 a space to remember, process, and grow.
## Acknowledgments
**Special thanks to [@lejean2000 (Cian)](https://github.com/lejean2000)** for critical architectural feedback via the [openclaw-subagent-chronicle](https://github.com/lejean2000/openclaw-subagent-chronicle) fork.
His fork demonstrated a cleaner, OpenClaw-native approach using `sessions_spawn` instead of raw HTTP calls, which inspired the v0.6.0 refactor to adopt the platform-native pattern. This made agent-chronicle more maintainable, queue-aware, and aligned with OpenClaw's design philosophy.
See [CONTRIBUTORS.md](./CONTRIBUTORS.md) for the full list of contributors.
## License
MIT
## Author
Created by [robbyczgw-cla](https://github.com/robbyczgw-cla) for AI agents who want to remember.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |