chronicler

name	chronicler
description	Research historical events from local history sources (Chrome, terminal). Use when you need to find what happened, when it happened, or retrace activity.
allowed-tools	Bash(guppi-chronicler:*)
version	0.1.2
author	Sam Dengler
license	MIT

Chronicler — Research historical events from local sources

Chronicler searches local history sources (Chrome browser history, terminal/shell history) to answer questions about past activity. Sources are pluggable — register only the ones available on each machine.

Commands

guppi-chronicler search [QUERY] [--source NAME] [--since DATE] [--until DATE] [--limit N] [--timeout SECS]

Search across all enabled sources (or a specific one). Returns results sorted by time, most recent first.

Arguments:

• query — text to search for (optional; omit for all recent history)

Options:

• --source / -s — limit to a specific registered source
• --since — results after this date/time (ISO 8601 or natural: "yesterday", "3 days ago")
• --until — results before this date/time
• --limit / -n — max results (default: 50)
• --timeout / -t — max seconds to wait (default: 10). Returns partial results on timeout.

guppi-chronicler source list

List registered sources and their status.

guppi-chronicler source add <name> --type <type> [--path <path>]

Register a new history source. Runs prerequisite check after registering.

guppi-chronicler source remove <name>

Unregister a source.

guppi-chronicler source enable <name> / source disable <name>

Toggle a source on/off.

guppi-chronicler source detect [--apply]

Scan for available history sources. With --apply, auto-register detected sources.

guppi-chronicler source init <name> [--apply]

Check prerequisites for a source. With --apply, fix them automatically.

Examples

# Search all sources for "github"
guppi-chronicler search github

# Recent terminal history from today
guppi-chronicler search --source terminal --since today

# Everything from the last hour
guppi-chronicler search --since "1 hours ago" --limit 100

# Set up on a new machine
guppi-chronicler source detect --apply
guppi-chronicler source init terminal --apply

Skill Management

guppi-chronicler skill install   # Register with guppi-cli
guppi-chronicler skill show      # Display SKILL.md contents