| name | chronicle |
| description | Activity and accomplishment logging - track what was done and when. Use when the user completes something significant, wants to log an activity, or asks what they did recently. |
chronicle - Activity Log
Timestamped activity logging with tags and full-text search. Track accomplishments, decisions, and work history.
When to use chronicle
- User just completed something significant
- User asks what they did recently
- User wants to log an accomplishment or decision
- User needs to recall when something happened
Available MCP tools
| Tool | Purpose |
|---|
mcp__chronicle__add_entry | Log a new entry |
mcp__chronicle__list_entries | Get recent entries |
mcp__chronicle__search_entries | Search by text or tags |
mcp__chronicle__find_when_i | Find when something happened |
mcp__chronicle__what_was_i_doing | Recall recent context |
mcp__chronicle__remember_this | Quick log with auto-tags |
Common patterns
Log an accomplishment
mcp__chronicle__add_entry(message="Deployed v2.0 to production", tags=["deployment", "milestone"])
What have I been doing recently?
mcp__chronicle__what_was_i_doing()
Find when something happened
mcp__chronicle__find_when_i(what="deploy the authentication service")
Search with filters
mcp__chronicle__search_entries(text="refactor", tags=["backend"])
Quick remember
mcp__chronicle__remember_this(activity="Fixed the memory leak in the worker pool", context="Part of performance optimization sprint")
Current query limitations
search_entries accepts since and until for compatibility, but currently ignores them. Text, tags, and limit are applied.what_was_i_doing accepts timeframe for compatibility, but currently ignores it and returns up to 20 recent entries.- The CLI
search --since/--until flags apply absolute dates such as 2026-01-01 or ISO timestamps. Relative phrases such as yesterday are not supported.
Proactive usage
Log automatically when the user:
- Deploys code
- Fixes a bug
- Makes a decision
- Completes a significant task
- Solves a problem
CLI commands (if MCP unavailable)
chronicle add "Did the thing"
chronicle add "Entry" --tag deploy
chronicle list
chronicle search "query"
chronicle export --format markdown
Data location
~/.local/share/chronicle/ (respects XDG_DATA_HOME). Backend-dependent:
- SQLite:
chronicle.db in data directory
- Markdown: date-organized files in
YYYY/MM/DD/ subdirectories
