Swob

A git graph for your AI conversations

Recover lost context. Trace forks and compactions. Debug how your agents actually worked.

Swob parses local histories through 6 native-format adapters and 1 Claude-compatible format. It can also detect files from 4 experimental sources without reading their message bodies. Where a source exposes the evidence, Swob adds lineage, incremental SQLite FTS5 search, execution inspection, provenance-aware audit, and optional AI Insights.

Website · Verified releases · Changelog

English · 中文 · 日本語

[!IMPORTANT]
The public v1.3.1 release matches the product shown here. The feature images below are English demo reconstructions based on the released source; identifying text and sample data were localized and privacy-sanitized for publication. They show implemented layouts and workflows, not untouched production-data captures. Counts inside the images are illustrative and separate from the audited corpora below.

_{Current main · English demo reconstruction · privacy-sanitized illustrative data}

Why Swob exists

AI coding sessions are not isolated chat files. A resume creates another file. A fork splits a task. A compaction replaces earlier context with a summary. Different agents store the same kind of work in incompatible locations. A normal viewer can show one transcript; it cannot explain where that transcript came from or why the agent lost the plot.

Swob treats session history as evidence:

• Trace lineage — navigate verified fork and continuation relationships in an interactive, force-directed Session Galaxy.
• Recover context — expand compacted Claude Code turns and preserve local backups after the source has disappeared.
• Debug execution — inspect tool/agent calls, token pressure, compaction boundaries, latency, framework overhead, errors, and anti-patterns.
• Search parsed histories — SQLite FTS5 indexes normalized messages incrementally. Detection-only sources are excluded, and source-specific search gaps stay visible.
• Resume safely — return to a supported CLI with its session ID and working directory, with source-aware validation.

Evidence, not vanity metrics

Session Galaxy

The current graph is a real Canvas-based, force-directed view. It distinguishes verified lineage edges from softer project/source/time grouping and lets you pan, zoom, inspect, and open a session. A prior PixiJS prototype was deliberately reverted for further work; Swob does not claim WebGL rendering today.

Session Debugger

Swob goes beyond transcript rendering:

• Execution Tree — reconstructs turns, tool calls, sub-agent spawns, errors, durations, and cumulative token use.
• Context Inspector — breaks context into user, assistant, tool input/output, system injection, thinking, image, and compact slices; marks compact boundaries and pressure warnings.
• Session Audit — a 12-dimension workflow audit covering research/edit balance, thinking evidence, latency, estimated cost, framework overhead, session type, model use, tool efficiency, interruptions, goal length, anti-patterns, and frustration signals.
• Provenance labels — metrics are labeled reported, estimated, or unavailable; missing evidence is not presented as fact.

Session Audit	Execution Tree + Context Inspector

Insights across all sessions

The local dashboard includes token and cost totals, a 365-day heatmap, source/model/project breakdowns, hourly and turn distributions, tool usage, code-change counts, and an audit report.

AI Insights is optional and off until configured. When explicitly invoked, it sends aggregate metrics plus a bounded sample of real user messages to the provider you configure. Read PRIVACY.md before enabling it.

Sources in current main

Native-format adapters (6) — transcript parsing is available; other capabilities vary

Compatible format (1)

Experimental detection (4) — file discovery only, content reading not yet implemented

Accuracy note: “Native-format adapter” means transcript parsing is implemented, not that every capability is available. Search, usage, lineage, live watch, archive, and resume vary by source. “Experimental detection” means Swob can find files and show metadata-only placeholders, but cannot read or index their message bodies. The canonical matrix is src/shared/provider-capabilities.ts.

How Swob compares

Public README claims checked on 2026-07-21. ✅ = explicitly documented; ◐ = adjacent or partial capability; — = not documented as a current feature. This is a capability map, not a quality score.

Install

Public installers

GitHub Releases is the truth source for the current version, supported architectures, signatures, and immutable asset names. This README deliberately does not synthesize or permanently fall back to an installer URL.

As of 2026-07-24, the public baseline is the Developer ID signed and notarized v1.3.1 release for Apple Silicon and Intel Mac.

System requirement: macOS on Apple Silicon or Intel.

[!IMPORTANT]
One manual migration is required for v1.2.0 users. Because v1.2.0 predates the Developer ID trust root, it cannot safely auto-update into the signed release line. Download the matching v1.3.1 DMG from this repository and overwrite Swob once. Existing v1.3.0 users can update through the isolated, E2E-gated signed channel.

Current main

git clone https://github.com/IvyYang1999/swob.git
cd swob
npm ci
npm run dev

To build local DMGs:

npm run build:mac

CLI

swob search "auth regression"    # local cross-session search
swob list --source codex         # filter by source
swob resume <session-id>         # print the source-aware resume command
swob insights                    # aggregate local usage
swob active                      # inspect running sessions
swob install                     # install CLI + Agent Skill

CLI commands return JSON so other agents can query Swob without scraping the UI.

Privacy and security

• Core browsing, indexing, lineage, audit, and Quick Report computation run locally.
• Swob does not include product analytics or session-upload telemetry in the reviewed current source.
• Startup update checks contact the release service but do not send session content.
• Optional AI Insights sends bounded real session samples only after an explicit confirmation.
• API credentials are stored in the local Swob Library configuration and are not encrypted by Swob in current main.
• SSH resume and terminal resume contact only destinations/actions the user explicitly configures.

Read the complete boundaries in PRIVACY.md. Report vulnerabilities through SECURITY.md, never through a public issue containing transcripts or credentials.

Stable vs. next

Tech stack

Electron 40 · React 19 · TypeScript · Zustand · Tailwind CSS 4 · SQLite FTS5 · Recharts · electron-vite

Contributing

Issues and pull requests are welcome. Contributions require a DCO Signed-off-by trailer; see CONTRIBUTING.md. Before sharing a fixture or screenshot, remove transcript content, absolute paths, credentials, cookies, and device identifiers. Security reports follow SECURITY.md.

License

Starting with v1.3.0, Swob is licensed under the Apache License 2.0. Releases v1.2.0 and earlier remain AGPL-3.0-only; this change is not retroactive. See NOTICE for copyright and trademark notices.