mattwynne/holocron

Latest recorded source activity: September 29, 2026 at 23:02

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 0
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/mattwynne/holocron.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Holocron Holocron is a local search index for AI coding-agent sessions. It solves the "I know I talked about this with an agent, but where?" problem by indexing session files from Pi, Claude Code, Codex, and Gemini CLI, then letting you search and reopen the original conversation. Holocron is local-first: it reads session files from disk and stores its index in SQLite at: ```text ~/.local/share/holocron/index.sqlite ``` ## Platform support Holocron currently supports macOS only. The background indexer uses `launchd`, and support for Linux or Windows has not been added yet. ## Install Requires Go and macOS. ```sh git clone https://github.com/mattwynne/holocron.git cd holocron go install ./cmd/holocron ``` Start the background indexer: ```sh holocron service install ``` This installs and starts a per-user launch agent. If `~/.pi` exists, Holocron also installs a Pi extension at: ```text ~/.pi/agent/extensions/holocron.ts ``` That extension registers project-local Pi sessions that are not stored under the normal `~/.pi/agent/sessions` tree. The Pi skill for finding prior sessions lives at `.pi/skills/holocron/`. To make it available from every project, link it globally: ```sh ln -s ~/git/mattwynne/holocron/.pi/skills/holocron ~/.pi/agent/skills/holocron ``` ## Use Search sessions from the current folder tree: ```sh holocron search "auth redirect" ``` Search across all indexed folders: ```sh holocron search "auth redirect" --all ``` Search as JSON: ```sh holocron search "auth redirect" --json ``` List sessions updated in the last 24 hours across all indexed agents: ```sh holocron today holocron today --json ``` Pick and reopen a session in the TUI, scoped to the current folder tree by default: ```sh holocron pick holocron pick "auth redirect" holocron pick --all "auth redirect" ``` Open a result by ID in its native tool: ```sh holocron open pi:019e31be ``` Ask one question about an indexed session without modifying it: ```sh holocron ask pi:019e31be "What did we decide?" echo "What files changed?" | holocron ask cx:abcdef12 ``` Press Ctrl-C to stop an in-flight `ask` request. View or continue a normalized Claude session in Pi: ```sh holocron view cd:019e31be holocron continue cd:019e31be --model anthropic/claude-sonnet-4-5 holocron export-pi cd:019e31be ``` Generate Holocron-native titles and summaries: ```sh holocron summarize pi:019e31be holocron summarize --today --limit 20 holocron summarize --missing --limit 20 holocron summarize --recent --limit 20 --jobs 4 --dry-run --json ``` Summaries are stored only in Holocron's SQLite index. Holocron never writes generated metadata back to provider session files. Configure the shared Pi/LLM runner in `~/.config/holocron/config.toml`; Pi receives a prompt on stdin and summaries must return strict JSON on stdout: ```toml [pi] executable = "/absolute/path/to/pi" [llm] timeout_seconds = 300 max_input_tokens = 200000 [summarizer] chunk_tokens = 6000 max_chunks = 20 # Queue-style background summarization in the daemon. Indexing stays fast; # missing titles populate gradually for UIs that poll search/today results. background = true background_interval_seconds = 30 background_jobs = 1 ``` Background summaries use recoverable leases. If the daemon restarts while a summary is running, Holocron resets stale running jobs and retries them later. Failed summaries can be retried with `holocron summarize ID --force`. `holocron service status` shows summary queue counts. Manually register a Pi session outside the default session tree: ```sh holocron register-session pi /path/to/session.jsonl ``` Manage the service: ```sh holocron service status holocron service start holocron service stop holocron service restart holocron service uninstall ``` ## Development ```sh direnv allow just build # writes ./holocron just test # runs go test ./... just install # installs holocron on your Go bin path ``` Without `just`: ```sh go build -o holocron ./cmd/holocron ./holocron help ```

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

holocron

unclassified

Find prior AI coding-agent/Pi sessions, recover context, locate artifacts created in earlier sessions, or reopen old sessions using the holocron CLI. Use when Matt mentions holocron, prior sessions, previous agent work, missing Google Docs/files/URLs, or asks…

2026-09-29

Showing 1 of 1 collected skill.