save-session
Save, list, and resume AI coding-agent sessions by project title — one ledger per harness: Pi, Claude Code, Codex, Antigravity, OpenCode.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jemshit--save-session)HTML
<a href="/listings/jemshit--save-session"><img src="/api/listings/jemshit--save-session/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
For Agent Skills-compatible harnesses, including Codex and OpenCode:
npx skills add jemshit/save-session -g
Omit `-g` to install only for the current project.
For Claude Code as a plugin:
claude plugin marketplace add jemshit/save-session claude plugin install save-session@save-session
For Pi:
pi install git:github.com/jemshit/save-session
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 24 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "save-session",
- "description": "Save, list, and resume AI coding-agent sessions by project title \u2014 one ledger per harness: Pi, Claude Code, Codex, Antigravity, OpenCode.",
- "owner": {
- "name": "Jemshit Iskanderov"
- },
- "plugins": [
- {
- "name": "save-session",
- "source": "./",
- "description": "Save, list, and resume AI coding-agent sessions by project title \u2014 one ledger per harness: Pi, Claude Code, Codex, Antigravity, OpenCode.",
- "version": "0.2.0",
- "license": "MIT",
- "homepage": "https://github.com/jemshit/save-session",
- "repository": "https://github.com/jemshit/save-session",
- "keywords": [
- "sessions",
- "resume",
- "bookmarks"
- ],
- "category": "productivity"
- }
- ]
- }
README.md · README · 87 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # save-session
- **Stop losing track of your AI coding sessions.**
- You are deep in one coding-agent session, switch tools for another task, and a week later cannot
- remember which session had the useful context—or how to get back into it. Session ids are opaque,
- each harness resumes differently, and using the wrong directory can open another project's history.
- `save-session` gives every supported coding agent the same simple workflow: bookmark the session
- you are in under a name you will remember, then find and resume it later with the exact command and
- working directory handed back to you.
- ```text
- save this session — project is "heap benchmark" → one bookmark written
- show me my saved sessions → saved work listed
- resume the heap benchmark session → exact command + working directory
- ```
- ## Why install it?
- - **One skill, five harnesses.** Use the same requests in Pi, Claude Code, Codex, Antigravity CLI,
- and OpenCode.
- - **It never guesses.** If detection is uncertain, it asks before saving or presenting a session
- as the right one.
- - **No ids or flags to memorize.** Ask by project name and get the harness's native resume command.
- - **Plain text on your machine.** Bookmarks are small, human-readable Markdown files. The skill
- adds no server, account, or hosted database.
- ## Install
- For Agent Skills-compatible harnesses, including Codex and OpenCode:
- ```bash
- npx skills add jemshit/save-session -g
- ```
- Omit `-g` to install only for the current project.
- For Claude Code as a plugin:
- ```bash
- claude plugin marketplace add jemshit/save-session
- claude plugin install save-session@save-session
- ```
- For Pi:
- ```bash
- pi install git:github.com/jemshit/save-session
- ```
- ## How it works
- **Save** detects the current session id, model, and working directory, then stores one bookmark
- under the project title you provide. If the same session already has another title, it asks whether
- to keep or replace it. If another session uses the same title, it safely adds `- 2`, `- 3`, and so
- on. Similar-looking titles are shown for confirmation instead of being merged automatically.
- **Find and resume** searches by project title or lists the current harness's bookmarks, then returns
- the exact native resume command and the directory to run it from. Finding is read-only.
- Records live in one Markdown file per harness under `~/.agents/memories/sessions/` because session
- ids do not translate across harnesses. Set `AGENTS_MEMORIES_DIR` to use another location.
- ```markdown
- # Sessions — Pi
- ## heap benchmark
- - saved: 2026-10-16T23:40:00Z
- - session_id: 11111111-2222-3333-4444-555555555555
- - model: provider/model-name
- - dir: <absolute path to the project>
- ```
- ## Supported harnesses
- | Harness | Session detection | Resume command |
- |---|---|---|
- | Pi | Current `PI_SESSION_ID` | `pi --session <id>` |
- | Claude Code | Environment hint validated against the project transcript when available | `claude --resume <id>` |
- | Codex | Local rollout matched to the current working directory | `codex resume <id>` |
- | Antigravity CLI | Older conversation cache; newer installs currently require an explicit id | `agy --conversation <id>` |
- | OpenCode | `opencode session list` or the local session store | `opencode --session <id>` |
- ## License
- MIT — see [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.