chronicle

Inspect, summarize, and clean historical session data from JSON chronicle files.

12|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Alexander-Tyagunov/magician --skill chronicle-alexander-tyagunov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chronicle
Source: https://github.com/Alexander-Tyagunov/magician/tree/main/skills/chronicle
Command: npx skills add https://github.com/Alexander-Tyagunov/magician --skill chronicle-alexander-tyagunov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

View and manage accumulated session learnings recorded by the Stop hook chronicle across Magician sessions.

Core Features & Use Cases

  • Chronicle storage: Each session is saved as a JSON file under ~/.local/share/magician/chronicle/, one file per session.
  • View and read: Quickly view a list of recent sessions with commands like ls -t ~/.local/share/magician/chronicle/*.json | head -10 and read a specific session with Python:
python3 -c "import json; d=json.load(open('<path>')); print(json.dumps(d, indent=2))"
  • Summaries and filtering: Retrieve concise session summaries and filter by date or branch to analyze progress.
  • Maintenance: Clear old chronicles using a safe script to delete entries older than a configurable window.

Quick Start

Ask Magician to show the latest chronicle entries and summaries.

Frequently Asked Questions about chronicle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I view recent session history logs for my development projects?

To view recent session history logs, you can list the most recent JSON files saved in the chronicle directory and read specific session details using Python snippets to parse the data.

Can I filter and summarize session logs by date or branch?

Yes, you can retrieve concise session summaries and filter historical session data by date or branch to analyze development progress across your projects.

How do I clear old session learnings and historical chronicle data?

You can clear old session learnings by running a safe script that deletes chronicle JSON entries older than a configurable time window to maintain storage.

Where are session learnings stored when reviewing session history?

Session learnings are stored as individual JSON files under the local chronicle directory, with each development session saved as one separate file for inspection.

Do I need Python to inspect and manage detailed session history data?

Yes, you need Python to inspect detailed session history data, as it uses Python snippets to load and print the JSON files recorded by the Stop hook chronicle.

What is the best way to aggregate and review accumulated session learnings across runs?

The best way to aggregate and review accumulated session learnings is using a chronicle skill to inspect, summarize, and clean historical session data across development projects.