Skip to content
SkillModel-led3,477 tokens in use

pi-history-ingest

Reads Pi coding-agent session files, follows the active branch of each tree, and compiles cited, verified knowledge into Obsidian wiki pages.

3,792 stars on the repository MIT LicenseAr9av/obsidian-wiki · skills/pi-history-ingest
pip install obsidian-wiki
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing pi-history-ingest costs

44tokens idle
3,477tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size11/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 96

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

pi-history-ingest mines the JSONL sessions that the Pi coding agent stores under ~/.pi/agent/sessions. Each session is a tree, so the skill finds the current leaf, walks back to the root and reads that active path, giving extra weight to compaction and branch summaries that are already distilled.

Every durable claim is tied to a session entry through an evidence ledger and a source comment, and the draft is checked against that ledger before a page is written. Facts that do not appear in the sessions are left out.

What You Get

  • Topic pages in your vault whose claims each carry a source comment pointing to a session file and entry
  • An evidence ledger step that traces extracted facts back to the session text before anything is saved
  • Provenance markers for inferred and ambiguous claims, plus summary, confidence and lifecycle frontmatter
  • A manifest entry per session with project, source type and the pages it created or updated
  • Append and full ingest modes

Common Use Cases

  • Capturing the decisions and workflows from months of Pi sessions in one project
  • Turning recurring bash commands into documented build, test and deploy playbooks
  • Keeping a wiki current by ingesting only the Pi sessions added since the last run

What Makes It Unique

It treats the session files as the only source of truth: background knowledge from training, docs or the current chat is never added as extracted fact. A source verification gate checks that every claim, proper noun, command and filename appears in the cited entry, and unverifiable content is deleted or marked as inferred or ambiguous. It also understands Pi’s tree layout, so abandoned branches contribute through their branch summaries.

Under The Hood

The skill is instructions for the agent. It lists session files with the find command, reads and parses JSONL from the Pi session folder, and searches them with grep when a claim needs checking. It writes Markdown pages and the manifest into the vault and runs the obsidian-wiki command line tool to update the index, log and hot cache. If a QMD collection is set it runs the qmd command to refresh the search index. It does not fetch web pages or call remote APIs.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers