{"id":51009909,"url":"https://github.com/superbereza/claude-session-keeper","last_synced_at":"2026-06-21T01:07:36.343Z","repository":{"id":365787241,"uuid":"1271954107","full_name":"superbereza/claude-session-keeper","owner":"superbereza","description":"Persist long-running Claude Code Remote Control / tmux sessions across reboots and crashes — sessions self-register and a systemd timer self-heals them — skill + CLI","archived":false,"fork":false,"pushed_at":"2026-06-18T21:15:43.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T23:12:23.469Z","etag":null,"topics":["ai-tools","claude-code","cli","remote-control","shell","skills","tmux"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superbereza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-17T06:46:15.000Z","updated_at":"2026-06-18T21:15:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/superbereza/claude-session-keeper","commit_stats":null,"previous_names":["superbereza/claude-session-keeper"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/superbereza/claude-session-keeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fclaude-session-keeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fclaude-session-keeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fclaude-session-keeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fclaude-session-keeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superbereza","download_url":"https://codeload.github.com/superbereza/claude-session-keeper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fclaude-session-keeper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34590367,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-code","cli","remote-control","shell","skills","tmux"],"created_at":"2026-06-21T01:07:35.810Z","updated_at":"2026-06-21T01:07:36.333Z","avatar_url":"https://github.com/superbereza.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-session-keeper\n\nPersist long-running Claude Code **Remote Control / tmux** sessions across **reboots, the\nmachine sleeping, and OOM kills**. A session registers itself, the list is a plain TSV, and a\nsystemd timer self-heals anything that died — re-launching it with the same conversation\n(`claude --resume`) and re-enabling Remote Control.\n\nBuilt after one too many \"the box rebooted and I lost 13 sessions\" mornings.\n\n## Why\n\nA reboot (or an OOM, or the laptop you SSHF-mount from going to sleep) kills your tmux server\nand every `claude` process — but the **conversations survive on disk** as resumable JSONLs.\nThis tool keeps a small registry of which sessions matter and brings them back automatically.\n\n## Install\n\n**Claude Code** (also its own marketplace):\n\n```\n/plugin marketplace add superbereza/claude-session-keeper\n/plugin install claude-session-keeper@claude-session-keeper\n```\n\nThe `claude-keep` CLI is auto-added to PATH while the plugin is enabled. Other agents read their own\nmanifests (`.cursor-plugin/`, `.codex-plugin/`, `gemini-extension.json`, `.opencode/`).\n\n## Use\n\n```bash\n# once: turn on the self-heal timer (survives reboot via lingering)\nclaude-keep install-timer --interval 5\n\n# in each session you want to keep — the agent runs this in its own session:\nclaude-keep add\n\n# manage\nclaude-keep ls                 # registry + who's live\nclaude-keep rm trendwatcher    # stop tracking one (bare title or full cc— name)\nclaude-keep restore            # manually bring back everything that's down\n```\n\n`claude-keep add` needs no arguments — it reads the calling session's own environment\n(`$CLAUDE_CODE_SESSION_ID`, the tmux session name, `$PWD`, `$CLAUDE_EFFORT`). Model isn't\nstored; `claude --resume` restores the session's own model.\n\n## How restore works\n\nFor each registered session that isn't live:\n\n- **cwd not reachable** (e.g. a network mount isn't up yet) → **skipped**, retried next tick.\n- otherwise → `tmux new-session … claude --resume \u003cuuid\u003e`, then it answers the\n  \"Resume session?\" dialog with **option 2 (full)** — never a lossy summary — and re-issues\n  `/remote-control` (unless `--no-rc`).\n\nIdempotent: a session already live is left alone, so it's safe on a timer.\n\n## Scope\n\nThis keeps **sessions** alive. It knows nothing about mounts — if your sessions live on a\nnetwork-mounted cwd, give that mount its **own** keeper. The two reconcile independently:\n`restore` simply waits (skips + retries) until the cwd is ready.\n\n## Files\n\n| Path | What |\n|---|---|\n| `bin/claude-keep` | the CLI (self-contained bash) |\n| `skills/claude-session-keeper/SKILL.md` | the skill (agent instructions) |\n| `~/.claude-keep/sessions.tsv` | the registry (override with `$CLAUDE_KEEP_HOME`) |\n\n## Versioning\n\n`scripts/bump.sh \u003cv\u003e` keeps `VERSION` + every manifest in sync. Tag `vX.Y.Z` + a GitHub\nRelease is what propagates a change to installed plugins.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperbereza%2Fclaude-session-keeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperbereza%2Fclaude-session-keeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperbereza%2Fclaude-session-keeper/lists"}