Skip to content
Back to search

save-session

MarketplaceWorks with Claude CodeGitHub

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.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jemshit--save-session/badge.svg)](/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)

  1. {
  2. "name": "save-session",
  3. "description": "Save, list, and resume AI coding-agent sessions by project title \u2014 one ledger per harness: Pi, Claude Code, Codex, Antigravity, OpenCode.",
  4. "owner": {
  5. "name": "Jemshit Iskanderov"
  6. },
  7. "plugins": [
  8. {
  9. "name": "save-session",
  10. "source": "./",
  11. "description": "Save, list, and resume AI coding-agent sessions by project title \u2014 one ledger per harness: Pi, Claude Code, Codex, Antigravity, OpenCode.",
  12. "version": "0.2.0",
  13. "license": "MIT",
  14. "homepage": "https://github.com/jemshit/save-session",
  15. "repository": "https://github.com/jemshit/save-session",
  16. "keywords": [
  17. "sessions",
  18. "resume",
  19. "bookmarks"
  20. ],
  21. "category": "productivity"
  22. }
  23. ]
  24. }
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)

  1. # save-session
  2. **Stop losing track of your AI coding sessions.**
  3. You are deep in one coding-agent session, switch tools for another task, and a week later cannot
  4. remember which session had the useful context—or how to get back into it. Session ids are opaque,
  5. each harness resumes differently, and using the wrong directory can open another project's history.
  6. `save-session` gives every supported coding agent the same simple workflow: bookmark the session
  7. you are in under a name you will remember, then find and resume it later with the exact command and
  8. working directory handed back to you.
  9. ```text
  10. save this session — project is "heap benchmark" → one bookmark written
  11. show me my saved sessions → saved work listed
  12. resume the heap benchmark session → exact command + working directory
  13. ```
  14. ## Why install it?
  15. - **One skill, five harnesses.** Use the same requests in Pi, Claude Code, Codex, Antigravity CLI,
  16. and OpenCode.
  17. - **It never guesses.** If detection is uncertain, it asks before saving or presenting a session
  18. as the right one.
  19. - **No ids or flags to memorize.** Ask by project name and get the harness's native resume command.
  20. - **Plain text on your machine.** Bookmarks are small, human-readable Markdown files. The skill
  21. adds no server, account, or hosted database.
  22. ## Install
  23. For Agent Skills-compatible harnesses, including Codex and OpenCode:
  24. ```bash
  25. npx skills add jemshit/save-session -g
  26. ```
  27. Omit `-g` to install only for the current project.
  28. For Claude Code as a plugin:
  29. ```bash
  30. claude plugin marketplace add jemshit/save-session
  31. claude plugin install save-session@save-session
  32. ```
  33. For Pi:
  34. ```bash
  35. pi install git:github.com/jemshit/save-session
  36. ```
  37. ## How it works
  38. **Save** detects the current session id, model, and working directory, then stores one bookmark
  39. under the project title you provide. If the same session already has another title, it asks whether
  40. to keep or replace it. If another session uses the same title, it safely adds `- 2`, `- 3`, and so
  41. on. Similar-looking titles are shown for confirmation instead of being merged automatically.
  42. **Find and resume** searches by project title or lists the current harness's bookmarks, then returns
  43. the exact native resume command and the directory to run it from. Finding is read-only.
  44. Records live in one Markdown file per harness under `~/.agents/memories/sessions/` because session
  45. ids do not translate across harnesses. Set `AGENTS_MEMORIES_DIR` to use another location.
  46. ```markdown
  47. # Sessions — Pi
  48. ## heap benchmark
  49. - saved: 2026-10-16T23:40:00Z
  50. - session_id: 11111111-2222-3333-4444-555555555555
  51. - model: provider/model-name
  52. - dir: <absolute path to the project>
  53. ```
  54. ## Supported harnesses
  55. | Harness | Session detection | Resume command |
  56. |---|---|---|
  57. | Pi | Current `PI_SESSION_ID` | `pi --session <id>` |
  58. | Claude Code | Environment hint validated against the project transcript when available | `claude --resume <id>` |
  59. | Codex | Local rollout matched to the current working directory | `codex resume <id>` |
  60. | Antigravity CLI | Older conversation cache; newer installs currently require an explicit id | `agy --conversation <id>` |
  61. | OpenCode | `opencode session list` or the local session store | `opencode --session <id>` |
  62. ## License
  63. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.