Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

chronicle

/chronicle

Zarządza pamięcią i kontekstem: pokazuje historię sesji, prowadzi globalny magazyn odniesień (repozytoria, projekty, pomysły), sprawdza zapełnienie kontekstu i zapisuje oraz konsoliduje wnioski z projektu.

Repozytorium
magician ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Zarządza pamięcią i kontekstem: pokazuje historię sesji, prowadzi globalny magazyn odniesień (repozytoria, projekty, pomysły), sprawdza zapełnienie kontekstu i zapisuje oraz konsoliduje wnioski z projektu.

Argumenty

/chronicle [status | learn <fact> [--global] | consolidate | last N | remember <fact> | references | forget <text> | clear N]
Oryginalny opis (EN)

Memory & context steward — view session history, manage the global reference store (repos, projects, ideas), check context size, and record or consolidate project learnings. Use to review past sessions, remember/recall/forget a reference, check how full the context is, or capture/consolidate learnings.

Jak działa

  1. Context size & learnings (ctx)
  2. Session history
  3. Global references (cross-session memory)
  4. Process
  5. Clearing old chronicles (uses the N you were given)
  6. Model note
  7. Obstacles
  8. Completion Signal
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 962 słów
Podgląd SKILL.md
---
name: chronicle
description: Memory & context steward — view session history, manage the global reference store (repos, projects, ideas), check context size, and record or consolidate project learnings. Use to review past sessions, remember/recall/forget a reference, check how full the context is, or capture/consolidate learnings.
allowed-tools: Read, Glob, AskUserQuestion, Bash(ctx pct *), Bash(ctx learn --add *), Bash(ctx consolidate), Edit(~/.claude/plugins/data/magician-*/references.md)
argument-hint: "[status | learn <fact> [--global] | consolidate | last N | remember <fact> | references | forget <text> | clear N]"
---

# /chronicle — Memory, History & Context Steward

> **Bundled command:** if `ctx` is not found, run it as `${CLAUDE_PLUGIN_ROOT}/tools/ctx`. If that is missing too (Claude chat ships no plugin tools), say /chronicle needs Claude Code or Cowork.

Three stores, all global to this machine and kept in the magician plugin data folder `${CLAUDE_PLUGIN_DATA}` (they survive across projects and sessions):

- **Session history** — `${CLAUDE_PLUGIN_DATA}/chronicle/` — one small JSON record per session, written from git by the Stop hook (the newest 50 are kept). Turned off by the plugin's `session_history` option.
- **Global references** — `${CLAUDE_PLUGIN_DATA}/references.md` — repos, projects, and ideas worth remembering. Session start adds it to context.
- **Project learnings** — `${CLAUDE_PLUGIN_DATA}/projects/<project-hash>/learnings.jsonl`, managed by the bundled **`ctx`** CLI. The internals and honest limits are in [references/context-mgmt.md](references/context-mgmt.md).

## Context size & learnings (`ctx`)

| Command | Does |
|---|---|
| `/chronicle status` | `ctx pct --transcript <path>` → current context %, plus the project learnings count (the first line of `ctx consolidate`). The path is this session's transcript: Glob `*/${CLAUDE_SESSION_ID}.jsonl` under `~/.claude/projects/`. `ctx pct` reads only the token numbers from the file's latest `usage` entry and the model id — no message content is stored or printed. |
| `/chronicle learn "<fact>" [--global]` | `ctx learn --add "<fact>"` (this project) or `ctx learn --add "<fact>" --global` (adds it to references.md). **Confirm before `--global`.** |
| `/chronicle consolidate` | `ctx consolidate` → show recurring project learnings; offer to promote high-frequency ones to global references (**confirm each**). |

Honest limits (never overclaim): a plugin can't read a live token count (`ctx pct` uses the latest `usage` numbers in the transcript file it is given — accurate, one turn stale), and **can't force or steer compaction** — only the user (`/compact`) or the auto-threshold compacts. Details: [references/context-mgmt.md](references/context-mgmt.md).

## Session history

Each record is `${CLAUDE_PLUGIN_DATA}/chronicle/<start-time>-<session-id>.json`: `{ timestamp, session_id, session_start, working_dir, branch, commits, changed_files, summary }` — git facts only, no prompt or response text.

To show the last N sessions (default 10): Glob `${CLAUDE_PLUGIN_DATA}/chronicle/*.json`, take the newest N (the file names start with the session start time, so they sort by time), Read each, and print one line per record: date · branch · summary.

## Global references (cross-session memory)

The reference store holds things you want every future session to know: repositories you work in, projects and their goals, and ideas to revisit. Session start adds it to context, so once remembered, a fact is available everywhere.

It is deliberately an **explicit, legible artifact** — a plain markdown file the user can read and edit directly (an "idea file" / personal knowledge base), not opaque implicit memory. Keep entries terse and durable, and prune stale ones with `forget`: an overgrown store distracts the model more than it helps.

**Always confirm before writing to or deleting from the global store** — it persists across all projects. State exactly what you'll save or remove, then gate with **AskUserQuestion** (Approve / Cancel); end your turn at the call and act only on Approve.

To **view** the store: Read `${CLAUDE_PLUGIN_DATA}/references.md` (if it does not exist, say "no references yet").

To **remember** a fact (after the user confirms): classify it as `Repositories`, `Projects` or `Ideas`, then edit `${CLAUDE_PLUGIN_DATA}/references.md` — add a `- <entry>` line directly under the `## <Section>` heading. If the file does not exist, create it starting with:

```markdown
# Magician — Global References
<!-- Remembered across all sessions. Managed by /chronicle. -->
```

and add the `## <Section>` heading if it is missing.

To **forget**, show the matching lines, confirm, then remove them with an Edit.

## Process

1. Parse the request from `$ARGUMENTS` (or ask): `status`, `learn <fact> [--global]`, `consolidate`, `last N`, `branch X`, `since DATE`, `clear N`, `remember <fact>`, `references`, `forget <text>`. **If you must ask, end your turn and wait.**
2. For reads (history view, `references`, `status`): read or run, then present the results.
3. For `remember` / `learn --global`: classify the fact, state what you'll save, then gate with **AskUserQuestion** (Save / Cancel) — end your turn at the call — and write only on Save (the global store persists across all projects). Project-scoped `learn` (no `--global`) needs no confirmation question — it's local and cheap.
4. For `forget` / `clear` / `consolidate` pruning: show what will be removed, then gate with **AskUserQuestion** (Delete / Cancel) before removing anything (this is permanent); end your turn at the call and delete only on Delete.

## Clearing old chronicles (uses the N you were given)

List the records older than N days:

```bash
find "${CLAUDE_PLUGIN_DATA}/chronicle" -name '*.json' -mtime +N
```

Show the list, confirm with **AskUserQuestion** (Delete / Cancel), and only on Delete remove exactly those files with `rm`. Claude Code asks for permission before the `rm` — that prompt is expected for a permanent delete. The Stop hook already keeps only the newest 50 records, so this is only needed to drop older history sooner.

## Model note

If a remembered project would benefit from a more capable model than the current session (see [lore/models.md](../../lore/models.md)), mention it when the reference surfaces — don't switch silently.

## Obstacles

/chronicle is the persistence target for the plugin's obstacle-memory: consumer skills (/orchestrate, /weave, /scrutinize, /divine, /transmute, /manifest) route a confirmed recurring obstacle pattern here to be memorized — via `ctx learn --add "<fact>" [--global]` (which this skill wraps), so a future run reads it up front and pre-empts the obstacle. As the confirm-before-global gate, it redacts secrets/credentials/PII and persists a distilled, self-authored signature — never verbatim untrusted worker text — so a poisoned or sensitive obstacle cannot ride into memory a later run will act on. It is not itself dispatched as a work unit, so it emits no upward Obstacles block. See [lore/obstacles.md](../../lore/obstacles.md).

## Completion Signal

"Chronicle done. <N sessions recorded> · <M references stored>."
Pliki w paczce (2)
  • SKILL.md 7 KB
  • references/context-mgmt.md 5 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · alexander-tyagunov/magician100MIT
microsoft/vscode100MIT
nrdxp/predicate100MIT
carlheath/ogmios100MIT

Migawka bazy z 13.11.2026 · wersja paczki 1cc070a37a70 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100mine-history
    Wydobywa i podsumowuje wnioski z transkryptów dawnych sesji Claude Code do dokumentacji projektu, wskazując powtarzające się wzorce.
  • 100memory-and-context
    Zapisuje, wyszukuje i usuwa trwałe wpisy pamięci między sesjami oraz zarządza nimi.
  • 100graphiti
    Zarządza pamięcią w postaci czasowego grafu wiedzy: ładuje kontekst na starcie sesji, sprawdza znane rozwiązania i zapisuje wnioski oraz kontekst infrastruktury na koniec.
  • 100consolidate-learnings
    Łączy zduplikowane i nakładające się wpisy wiedzy w .ckit/agent-memory/ w jeden kanoniczny wpis na regułę i odbudowuje indeks.
  • 100shodh-memory
    Przechowuje i przywołuje kontekst dla agentów AI między rozmowami, zapisując decyzje, wnioski i błędy.
  • 84memory
    Zapisuje i odczytuje trwałą pamięć agenta: decyzje, preferencje i wyniki sesji, przed działaniem i przy wznowieniu projektu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.