Agent Skills › rcarmo/piclaw › reload

reload

GitHub

在代码变更后重新安装 piclaw 并优雅重启服务。包含 Agent 工作流与手动命令，强调构建验证、会话检查及安全重启机制。

skel/.pi/skills/reload/SKILL.md rcarmo/piclaw

Trigger Scenarios

用户修改了 piclaw 源码后需要更新服务需要重新部署本地构建的 piclaw 版本

Install

npx skills add rcarmo/piclaw --skill reload -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/reload -g -y

Use without installing

npx skills use rcarmo/piclaw@reload

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill reload -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "reload",
    "description": "Reinstall piclaw from workspace source, then gracefully restart the managed process. Use after making code changes to piclaw.",
    "distribution": "public"
}

Reload Piclaw

Install the workspace build, then let the active service manager start a new process after graceful shutdown.

⚠️ In the container runtime, install to /usr/local/lib/bun/install/global/node_modules/piclaw. Do not deploy to /home/agent/.bun/...; the service may keep running another installation.

Agent-driven workflow

Build, pack, and install without restarting:
```
cd /workspace/piclaw && make local-install
```
A non-zero exit stops the workflow. Report the install failure and do not restart. Verify the installed source artifact under /usr/local/lib/bun/install/global/node_modules/piclaw; piclaw --version alone is insufficient because a release and local build can share a version.
Use session_status to check for other active sessions.
If another session is working, report it and wait for approval. A restart interrupts that work.
Finish all build, verification, and reporting work.
Call exit_process with a concise, non-empty reason as the last tool action. It posts a visible restart notice to the active chat, then schedules graceful shutdown. Optionally include resume_message to show a labelled agent self-resume after startup and start a new inbound turn from it. Supervisor restarts supervised containers; other installs need their service manager to start the process again.

make restart is an intentional no-op guard. It prevents an active agent turn from killing its own response.

Manual shell workflow

Outside an agent turn, install and restart as separate commands:

cd /workspace/piclaw && make local-install
systemctl --user restart piclaw.service

Use the service manager configured for that host. Container installs commonly use Supervisor; host-native installs commonly use systemd --user.

Build commands

Build Piclaw without installing:

cd /workspace/piclaw && make build-piclaw

Build only the vendor bundle:

cd /workspace/piclaw && make vendor

Notes

make local-install is install-only and ignores an ambient portable-runtime BUN_INSTALL.
A failed local install must never be followed by exit_process.
Compare an installed source-file checksum or resolved entrypoint with the workspace before restart.
exit_process requires a non-empty reason; optional resume_message must also be non-empty when supplied. It has no delay parameter.
Bun and Piclaw are installed globally under /usr/local/lib/bun in the container layout.