Skip to content

rolecraft watch

Watch installed skills for file changes and auto-sync to agent directories.

Usage

bash
rolecraft watch [<slug>]

Description

Monitors skill source directories using node:fs FSWatcher. When a file changes, the skill is automatically re-installed to all its configured agent targets and the lockfile is updated with new content hashes.

Only local source skills can be watched. Remote (GitHub, npm, git) sources are skipped.

Examples

bash
# Watch all local skills
rolecraft watch

# Watch a specific skill
rolecraft watch my-skill

Output

👀 Watching 2 skill(s) for changes...

   ✓ my-skill → watching /Users/me/projects/my-skill
   ✓ team-rules → watching /Users/me/projects/team-rules

📌 Press Ctrl+C to stop watching

On file change:

  [2:30:15 PM] my-skill: SKILL.md changed, syncing...
  [2:30:15 PM] my-skill: synced successfully