extension-troubleshoot

name	extension-troubleshoot
description	Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.
distribution	public

Extension Troubleshoot (piclaw)

Use this when piclaw web chats only show thinking or extensions throw errors.

Steps

1. Check extension errors

tail -n 80 /var/log/piclaw/piclaw.stderr.log

2. Inspect current extension file(s)

readlink -f /workspace/.pi/extensions/context-mode.ts
sed -n '1,120p' /workspace/.pi/extensions/context-mode.ts

3. 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.

4. 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.

5. Update skel extension too

cp /workspace/.pi/extensions/context-mode.ts /workspace/piclaw/skel/.pi/extensions/context-mode.ts

6. Fix workspace watcher permissions (if fs.watch warns on tailscale)

sudo chown -R agent:agent /workspace/.piclaw/tailscale

7. Restart piclaw

supervisorctl restart piclaw

8. Verify

tail -n 40 /var/log/piclaw/piclaw.stderr.log