Agent Session Kit

agent-session-kit

A Swift package that reads the session stores AI coding agents leave on your Mac, and serves them over MCP.

Every coding agent keeps a local record of what you asked it — Codex writes rollout JSONL, Claude Code writes transcript JSONL, Cursor and AntiGravity write SQLite databases another process holds open. Each one has its own layout, its own idea of a "session id", and its own way of spelling a timestamp. This package hides all of that behind one adapter protocol, a searchable index, and a local MCP transport.

No third-party dependencies. Foundation, Darwin, and the system SQLite.

.package(url: "https://github.com/AstroQore/agent-session-kit", exact: "0.3.0")

`exact:` while the package is `0.x` — see [Versioning and releases](#versioning-and-releases).

Targets

Target	What it is
AgentSessionKit	Discovery, parsing, deletion planning, the FTS5 session index, and the MCP Unix-socket / stdio transport.
AgentSessionLive	Live views over the same stores — the unified event model, the state reducer, and the tailing protocols.

Requires macOS 26 and Swift 6.2.

Architecture

Two targets, one boundary. `AgentSessionKit` answers "what is on disk right now" — one pass, one snapshot, no observers: discovery, parsing, the FTS5 index, deletion planning, and the MCP transport. `AgentSessionLive` is everything that *watches*: FSEvents, incremental tailing, the unified event model, and the state reducer. It depends on the Kit; the Kit knows nothing about it. If a type debounces, polls, or holds a cursor, it belongs in Live.

The package knows about the **usage axis** — the harness that produced a session — and deliberately nothing about the **billing axis** (quotas, plans, prices, companies). A host that models both writes that mapping in its own module.

There are **no third-party dependencies**: Foundation, Darwin, Dispatch, `os.log`, `CryptoKit`, and the system SQLite. That is a deliberat