English | 한국어
Discovers, classifies, and safely cleans up agent coding sessions across Claude Code, Codex, Gemini CLI, OpenCode, and Aider — a KEEP / ARCHIVE / JUNK heuristic classifier, ranked search, duplicate/superseded detection, and a day-grouped cross-agent timeline, all backed by one local SQLite database instead of five different tools' scattered storage formats.
Not Paseo-only. packages/cli (sessionforge) is the standalone engine
— zero Paseo/React dependency, usable as a CLI or a library in any Node project. The repo root is a Paseo
plugin that depends on it like any other npm package. Use either one, or both — they share the same local
database.
git clone https://github.com/4mGLn/sessionforge.git
cd sessionforge
npm install # sets up the workspace (both packages)
npm run cli -- discover # scans Claude Code/Codex/Gemini CLI/OpenCode session storage
npm run cli -- list # table view; add --json for machine-readable output
npm run cli -- search "postgresql" # FTS5-ranked searchNo Paseo required for any of that. See docs/MANUAL.md for the full CLI reference,
Aider's opt-in setup, and installing the Paseo plugin.
Standalone binary, no Node.js required (Linux, macOS, Windows):
curl -fsSL https://raw.githubusercontent.com/4mGLn/sessionforge/main/install.sh | shirm https://raw.githubusercontent.com/4mGLn/sessionforge/main/install.ps1 | iexDownloads a prebuilt sessionforge binary for your platform from the latest
GitHub Release and puts it on your PATH. See
docs/MANUAL.md for supported targets and override options.
Also available as a Paseo plugin — once you have the binary above, wire it up with:
sessionforge wire-paseoSee docs/MANUAL.md for details, a known environment quirk,
and the manual paseo plugin install /path/to/sessionforge alternative (only needed for plugin
development — it requires cloning the repo and Node.js 22.16+, unlike wire-paseo).
sessionforge checks for new releases automatically and tells you when one's available; run
sessionforge update to install it. See docs/MANUAL.md.
Not published to npm — the standalone binary and the Paseo plugin are the only distribution channels.
docs/MANUAL.md— full CLI reference, Aider setup, Paseo plugin install, the safety model, and per-platform behavior.docs/REFERENCE.md— architecture, repo layout, why it's two packages, spec tracking againstGOAL.md, and adapter implementation notes.packages/cli/README.md— the standalone package's own quick reference (CLI + library usage).CONTRIBUTING.md— dev setup, testing, and CI.
MIT © aMgLn