Menu
Browse session history. Use when referencing past discussions or finding context from previous work.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/ActiveMemory/ctx --skill ctx-historyThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Recall project context and present structured readback. Use when the user asks 'do you remember?', at session start, or when context seems lost.
End-of-session context persistence ceremony. Use when wrapping up a session to capture learnings, decisions, conventions, and tasks.
Recall project context and present structured readback. Use when the user asks 'do you remember?', at session start, or when context seems lost.
Showing SKILL.md
Based on SOC occupation classification
| name | ctx-history |
| description | Browse session history. Use when referencing past discussions or finding context from previous work. |
| allowed-tools | Bash(ctx:*) |
Browse, inspect, and import AI session history.
/ctx-status
or /ctx-agent instead)/ctx-history
/ctx-history list --limit 5
/ctx-history show <slug-or-id>
/ctx-history import --all
ctx journal sourceList recent sessions, newest first.
| Flag | Short | Default | Purpose |
|---|---|---|---|
--limit | -n | 20 | Maximum sessions to show |
--project | -p | "" | Filter by project name |
--tool | -t | "" | Filter by tool (e.g., "claude-code") |
--all-projects | false | Include all projects |
--show | "" | Show details of a specific session |
--latest | false | Show the most recent session |
--full | false | Full conversation (not preview) |
Output per session: slug, short ID, project, branch, time, duration, turn count, token count, first message preview.
Use --show <id> to inspect a specific session. Accepts a
full UUID, partial UUID prefix, or slug name. Use --latest
if no ID is given.
Default output shows metadata and the first 5 user messages.
Use --full for the complete conversation.
ctx journal importImport sessions to the journal directory as Markdown.
| Flag | Default | Purpose |
|---|---|---|
--all | false | Import all sessions (only new files by default) |
--all-projects | false | Include all projects |
--regenerate | false | Re-import existing files (preserves frontmatter) |
--keep-frontmatter | true | Preserve enriched YAML frontmatter during regen |
--yes, -y | false | Skip confirmation prompt |
--dry-run | false | Preview what would be imported |
Accepts a session ID (always writes), or --all to import
everything (safe by default: only new sessions, existing
files skipped). Use --regenerate with --all to re-import
existing files; YAML frontmatter is preserved by default.
Use --keep-frontmatter=false to discard enriched frontmatter.
Locked entries (via ctx journal lock) are always skipped.
Large sessions (>200 messages) are automatically split into parts with navigation links between them.
ctx journal lockProtect journal entries from import regeneration.
ctx journal lock <pattern> # Lock matching entries
ctx journal lock --all # Lock all entries
ctx journal unlockRemove lock protection from journal entries.
ctx journal unlock <pattern> # Unlock matching entries
ctx journal unlock --all # Unlock all entries
ctx journal syncSync lock state from journal frontmatter to .state.json.
ctx journal sync
Scans all journal markdowns and updates .state.json to match
each file's frontmatter. Files with locked: true in frontmatter
are marked locked in state; files without a locked: line have
their lock cleared. This is the inverse of ctx journal lock:
frontmatter drives state instead of state driving frontmatter.
Useful after batch enrichment where you add locked: true to
frontmatter manually.
Sessions are read from ~/.claude/projects/ (Claude Code
JSONL files). The system auto-detects and parses session files;
only the current project's sessions are shown by default.
list, highlight notable sessions;
for show, summarize key points; for import, report what
was written and suggest next steps (normalize, enrich)"What did we work on recently?"
ctx journal source --limit 5
"Show me that session about authentication"
ctx journal source --project auth
# then with the slug or ID from the list:
ctx journal source --show <slug>
"Import everything to the journal"
ctx journal import --all
This only imports new sessions: existing files are skipped.
If the user asks what to do next, mention that /ctx-journal-enrich-all
can enrich the imported journals.
"Re-import sessions after a format improvement"
ctx journal import --all --regenerate -y
Before reporting results, verify:
--all for bulk import (safe: only new sessions)--dry-run when user seems uncertain--regenerate when explicitly needed