remote-collection — Claude Code skill: pull history over SSH
A skill that walks the agent through CCAM remote data sources: connect machines over SSH and pull Claude and Codex history. Useful when sessions live beyond your laptop.
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a claude-codeWhat remote-collection does
The skill covers the whole lifecycle of a CCAM remote source: listing, adding, testing, syncing, editing and removing. Start with ccam remote-sources to see what is already configured. Host validation runs through your existing SSH setup, since CCAM keeps no passwords and no private keys.
Set remote_home and remote_codex_home only when those paths differ from the provider defaults. Test a source before syncing it: ccam remote-sources test <id>. Then ccam remote-sources sync [id] pulls one source or every source at once, and edits go through ccam remote-sources update <id> --file patch.json --yes.
Removing a source keeps imported sessions unless you ask otherwise. Purging needs the extra flag: ccam remote-sources rm <id> --purge --confirm PURGE_REMOTE_SOURCE_DATA. Miss the confirmation token and nothing gets wiped, so a stray command will not take your history with it. The skill also insists you say out loud whether imported data survives the removal.
What it helps with
- attach a remote machine and pull its Claude history
- test a source before syncing so you do not import an empty set
- fix a non-default Codex path on a server
- sync every configured source in one go
- drop a source while keeping the sessions already imported
Example prompts for the agent
- List the current CCAM remote sources
- Add a source for a machine where Codex history sits in a different directory
- Remove a source and tell me whether imported sessions are kept
How to install remote-collection
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a claude-code2Manually: put the files in place
~/.claude/skills/remote-collection/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/remote-collection/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a codex2Manually: put the files in place
.agents/skills/remote-collection/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a cursor2Manually: put the files in place
.cursor/skills/remote-collection/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor remote-collection2Manually: put the files in place
.github/skills/remote-collection/SKILL.md1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path plugins/ccam-integrations/skills/remote-collectionManually: put the files in place
.devin/skills/remote-collection/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about remote-collection
How do I install remote-collection in Claude Code?
Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill remote-collection -a claude-code. The skill file lands at ~/.claude/skills/remote-collection/SKILL.md.
What does remote-collection do?
It guides the agent through every step of managing CCAM remote sources: listing, adding, testing, syncing, editing and removing. It also makes sure you state whether imported sessions are kept before a removal goes ahead.
Does it need passwords or SSH keys stored somewhere?
No. The host check uses the SSH configuration you already have, and CCAM stores neither passwords nor private keys.
Source text
SKILL.md · MIT
--- name: remote-collection description: > Configure and troubleshoot CCAM Remote Data Sources that collect Claude Code and Codex history over SSH. Use when adding, editing, testing, syncing, or removing a remote machine, verifying provider paths, or deciding whether to retain or purge imported sessions. --- # Remote Collection 1. List current sources with `ccam remote-sources`. 2. Validate the host through the user's existing SSH configuration. CCAM stores no passwords or private keys. 3. Add a source with `remote_home` and `remote_codex_home` only when they differ from the provider defaults. 4. Test before syncing: `ccam remote-sources test <id>`. 5. Sync one source or all sources with `ccam remote-sources sync [id]`. 6. Use `ccam remote-sources update <id> --file patch.json --yes` for edits. 7. Removal retains imported sessions by default. Purging them requires: ```bash ccam remote-sources rm <id> --purge \ --confirm PURGE_REMOTE_SOURCE_DATA ``` Always state whether imported data will be kept or deleted before removal.
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor