extension-troubleshoot

Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.

インストール方法

デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。

Codex または Claude でインストールこの Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。

直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。

npx skills add https://github.com/rcarmo/piclaw --skill extension-troubleshoot

コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。

ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。

インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。

SKILL.md

ソースの指示 · 読み取り専用プレビュー

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

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

Check extension errors:

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

Inspect the current extension file:

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 source.
- In the container layout, use packaged sources under /usr/local/lib/bun/install/global/node_modules/piclaw/runtime/....
- Avoid imports from /workspace/piclaw or workspace-local node_modules; those paths can drift after reloads.
Harden the extension.
- Remove startup cleanup that touches the DB before init.
- Wrap tool executes in try/catch.
- Guard saveToolOutput with try/catch.

Update the matching skel extension:

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 only with explicit user permission.

For an agent-driven restart, run session_status first. If another session is active, report it and wait. Otherwise send the final response, then call exit_process as the last tool action.

For a manual shell restart, identify the host's active service manager and use it directly:
```
# Supervisor-managed container
supervisorctl restart piclaw

# systemd user unit, including LXC or host-native installs
systemctl --user restart piclaw.service
```

Verify:

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