Reload
npx machina-cli add skill Speedy0000007/claude-tandem/reload --openclawReload Tandem Plugin Cache
Sync the local Tandem source directory into Claude Code's plugin cache so that script, skill, and rule changes take effect immediately.
Steps
- Read
~/.claude/plugins/known_marketplaces.jsonto find thetandem-marketplaceentry. The source directory is atsource.path(orinstallLocation). - Read
~/.claude/plugins/installed_plugins.jsonto find thetandem@tandem-marketplaceentry and itsinstallPath(the cache path). - Run
readlink <cache_path>to check if it's already a symlink.- If it resolves to
<source_dir>/plugins/tandem: report "Already synced. Cache is a symlink to source." - Otherwise: run
rm -rf <cache_path> && ln -s <source_dir>/plugins/tandem <cache_path>and report what changed. No confirmation needed, this is a safe, reversible operation.
- If it resolves to
Note: Script, skill, and rule changes are live immediately after sync. Changes to hooks/hooks.json require a session restart (hooks are snapshotted at startup).
If the marketplace or plugin entries aren't found, explain that this skill requires a local directory marketplace setup (see CONFIGURATION.md).
Source
git clone https://github.com/Speedy0000007/claude-tandem/blob/main/plugins/tandem/skills/reload/SKILL.mdView on GitHub Overview
Reload syncs the local Tandem source into Claude Code’s plugin cache so script, skill, and rule changes take effect immediately. It discovers the source and cache paths from known_marketplaces.json and installed_plugins.json, then creates or updates a symlink from the cache to the source. Note that changes to hooks/hooks.json require a session restart.
How This Skill Works
The skill reads ~/.claude/plugins/known_marketplaces.json to locate the tandem-marketplace source.path (or installLocation) and ~/.claude/plugins/installed_plugins.json to locate the tandem@tandem-marketplace installPath (the cache path). It uses readlink to verify whether the cache already points to <source_dir>/plugins/tandem; if not, it removes the cache path and creates a new symlink to the source. Changes are live immediately after the sync; this operation is designed to be safe and reversible.
When to Use It
- You have updated the local Tandem source or plugins and want them available immediately.
- Changes aren’t taking effect mid-session and you want to refresh the cache.
- You’ve moved or renamed the Tandem source directory and need to re-link.
- The cache path is out of sync or corrupted and you need to re-link.
- You’re setting up a local directory marketplace and need the cache to point to the source.
Quick Start
- Step 1: Locate the source directory from ~/.claude/plugins/known_marketplaces.json (tandem-marketplace; use source.path or installLocation).
- Step 2: Locate the cache path from ~/.claude/plugins/installed_plugins.json (tandem@tandem-marketplace; use installPath).
- Step 3: Run readlink <cache_path>; if it does not point to <source_dir>/plugins/tandem, run rm -rf <cache_path> && ln -s <source_dir>/plugins/tandem <cache_path>; changes are live immediately (hooks.json restart may be required).
Best Practices
- Verify that known_marketplaces.json contains the tandem-marketplace entry and that source.path or installLocation is correct.
- Check with readlink before changing the cache symlink to avoid breaking dependencies.
- Keep a backup of the existing cache path in case you want to revert.
- Remember: script, skill, and rule changes go live immediately after sync; hooks.json changes require a session restart.
- Use this only when you have a local directory marketplace correctly configured (see CONFIGURATION.md).
Example Use Cases
- Developer updates a skill in source/plugins/tandem and runs Reload to apply instantly.
- After pulling new commits from the tandem-marketplace, Reload makes them live.
- Cache was pointing to a stale location; Reload re-links to the new source.
- First-time setup after installing the Tandem marketplace on a dev machine.
- Moved the source directory; Reload re-creates the correct symlink.
