session-librarian

session-librarian is a skill for Claude Code, Codex from aivrar/portable-hermes-agent. It costs 19 tokens per session (1,127 once invoked), scanned A, original, MIT.

A tool for organizing a library of past coding-agent sessions. It can find sessions by topic, summarize decisions, rename them, split work into separate sessions, and suggest old sessions for archiving or deletion.

In plain words
What is it for?
Searching past sessions, reviewing their metadata, renaming them, creating follow-up sessions, separating work by ticket, and cleaning up stale duplicates.
Why use it?
It helps you recover decisions and reduce clutter when many conversations or workstreams have accumulated.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents.

Good fit Searching past sessions, reviewing their metadata, renaming them, creating follow-up sessions, separating work by ticket, and cleaning up stale duplicates.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/aivrar/portable-hermes-agent/session-librarian
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add aivrar/portable-hermes-agent --skill session-librarian
Clone the repo
git clone --depth 1 https://github.com/aivrar/portable-hermes-agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for session-librarian

README.md
[![agentmods](https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/session-librarian/github.svg)](https://agentmods.dev/skills/aivrar/portable-hermes-agent/session-librarian)
Your own site
<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/session-librarian"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/session-librarian/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for session-librarian

Your own site · 80×15
<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/session-librarian"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/session-librarian.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,127 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00019 $0.01127
Opus 5 $0.00010 $0.00563
Sonnet 5 $0.00004 $0.00225
Haiku 4.5 $0.00002 $0.00113

Measured 6d ago against content hash 9da2d0ba82b7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

session-librarian scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/productivity/session-librarian/SKILL.md · 106 lines

How it starts

The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Session Librarian

Manage the user's session library conversationally: find past sessions about a topic, summarize what they decided, rename them meaningfully, split work into parallel sessions, and propose stale ones for archive or deletion — all from a plain-language request like "find my sessions about Q3 pricing, keep the useful ones, and clean up the duplicates."

Inspired by Perplexity Computer's prompt-driven session management (Aug 2026): the agent starts, organizes, and cleans up the user's own session library, and always shows the plan before touching anything.

When to Use

  • "What sessions do I have about X?" / "What did we decide about X?"
  • "Rename these sessions to something meaningful."
  • "Clean up my session library" / "archive the stale ones."
  • "Fork that session into a follow-up focused on Y."
  • "Split this into one session per ticket" (see Parallel workstreams below).

The Two Surfaces

Task Surface
Find sessions by topic, read content, summarize decisions session_search tool (FTS5 over the message store)
List/filter by metadata (age, source, cost, tokens, workspace) hermes sessions list / stats via terminal
Rename hermes sessions rename <session_id> <title...>
Bulk soft-hide (reversible) hermes sessions archive <filters>
Delete (destructive) hermes sessions delete / hermes sessions prune <filters>
Export before deleting anything valuable hermes sessions export --session-id <id> --format md
Continue work in a new place /branch (fork current session) or start a fresh session and cite the summary

Procedure

Discover. Use session_search(query=..., limit=5-10) with topic keywords; vary phrasing (feature name, symptom, project name). For metadata sweeps ("sessions older than 60 days from telegram"), use hermes sessions list --source telegram --limit 50 instead.

Summarize per session. The discovery result's bookend_start (goal), match window, and bookend_end (resolution) usually suffice — only dump a full session (session_search(session_id=...)) when the user asks for decisions in depth. Report each as: link (@session: form) — one-line goal — one-line outcome.

Read the full file on GitHub · 106 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 106 lines · 19 tokens per session scan A 9da2d0ba82b7

Subscribe to this mod's changes

session-librarian is a skill published in the GitHub repository aivrar/portable-hermes-agent (217 stars, last pushed yesterday), licensed MIT. It adds 19 tokens to every session and 1,127 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

feishu-calendar

A Feishu calendar and scheduling skill. It manages calendars and events and can check when people are available or busy.

op7418/CodePilot · 33 tokens

automation-architect

Workflow automation design using Zapier, Make, and n8n covering trigger-action architecture, multi-step automation workflows, error handling strategies, personal versus business automation patterns, ROI calculation, and a library of common automation recipes. Use when the user asks about automation architect, related…

FerroxLabs/wayland · 90 tokens

vault-setup

Set up a machine to work with a workhub vault - check/install required software (git, Node.js, Claude Code, OpenCode), initialize the vault if needed, wire up Claude plugins, and run the OpenCode sync scripts. Use when onboarding a new machine, after a fresh vault-init, or when the harness feels half-configured.

atman-33/workhub · 73 tokens

钉钉企业 IM 操作

A command reference for using DingTalk, a workplace messaging and collaboration platform, through its command-line tool. It covers messages, calendars, documents, cloud files, contacts, tasks, and attendance data.

CavinHuang/lume · 46 tokens

wecomcli-todo

A tool for managing to-do items in WeCom, the workplace messaging and collaboration app used by many Chinese companies. It handles existing WeCom tasks and their titles, descriptions, people, status, and deadlines.

Pinvou/pinvou-agent · 83 tokens

things-mac

Manage Things 3 via the things CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks Otto to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

elizaOS/eliza · 67 tokens