ReddRadar
Agent skill
extension-troubleshoot
Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.
Install this agent skill to your Project
npx add-skill https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/extension-troubleshoot
SKILL.md
Extension Troubleshoot (piclaw)
Use this when piclaw web chats only show thinking or extensions throw errors.
Steps
- Check extension errors
tail -n 80 /var/log/piclaw/piclaw.stderr.log
- Inspect current extension file(s)
readlink -f /workspace/.pi/extensions/context-mode.ts
sed -n '1,120p' /workspace/.pi/extensions/context-mode.ts
- Ensure imports reference installed piclaw (not workspace src)
- Use installed path: /home/agent/.bun/install/global/node_modules/piclaw/dist/...
- Avoid /workspace/piclaw or node_modules symlinked to workspace.
- Harden extension
- Remove/avoid startup cleanup that touches DB before init.
- Wrap tool executes with try/catch to prevent crashes.
- Guard saveToolOutput with try/catch.
- Update skel extension too
cp /workspace/.pi/extensions/context-mode.ts /workspace/piclaw/skel/.pi/extensions/context-mode.ts
- Fix workspace watcher permissions (if fs.watch warns on tailscale)
sudo chown -R agent:agent /workspace/.piclaw/tailscale
- Restart piclaw
supervisorctl restart piclaw
- Verify
tail -n 40 /var/log/piclaw/piclaw.stderr.log
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rcarmo/piclaw
autoresearch-create
Set up and run an autonomous experiment loop for any optimization target. Gathers what to optimize, then starts the loop immediately. Use when asked to "run autoresearch", "optimize X in a loop", "set up autoresearch for X", or "start experiments".
rcarmo/piclaw
portainer-container-compare-chart
Compare two containers using native portainer tool data collection and render SVG/CSV outputs.
rcarmo/piclaw
proxmox-guest-compare-chart
Compare two Proxmox guests using native proxmox tool data collection and render SVG/CSV outputs.
rcarmo/piclaw
schedule
Schedule a task to run later or on a recurring basis. Prefer the schedule_task tool; fallback to IPC only if needed.
rcarmo/piclaw
reload
Reinstall piclaw from workspace source and force-restart the running process. Use after making code changes to piclaw.
rcarmo/piclaw
send-message
Send a message to the chat immediately without waiting for the current task to finish. Useful for acknowledging requests or sending progress updates while working.
Didn't find tool you were looking for?