construct-down

Stops the running CONSTRUCT views server and removes its PID file.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mabstruct/construct --skill construct-down-mabstruct
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: construct-down
Source: https://github.com/mabstruct/construct/tree/main/CONSTRUCT-CLAUDE-impl/claude/skills/construct-down
Command: npx skills add https://github.com/mabstruct/construct --skill construct-down-mabstruct

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you are done working with the CONSTRUCT knowledge system, the local views server keeps running in the background. This Skill cleanly shuts it down so no orphaned processes or stale PID files are left behind. ## Core Features & Use Cases - Graceful Shutdown: Sends SIGTERM to the recorded server process, waits up to 5 seconds, and escalates to SIGKILL only if needed. - Stale PID Cleanup: Detects when the PID file references a dead process and removes it without error. - Safe Failure Handling: Reports clear states (no server running, stale PID, unkillable process) and preserves the PID file when shutdown fails for diagnosis. - Use Case: After finishing a knowledge curation session, say "stop CONSTRUCT" to terminate the views server for this install without affecting other CONSTRUCT instances or running Claude workflows. ## Quick Start Tell the agent to stop CONSTRUCT or shut down the views server for this installation.

Frequently Asked Questions about construct-down

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stop the CONSTRUCT views server?▼

Say "stop CONSTRUCT", "shut down views", or "end session" to trigger the shutdown. The skill reads views/server.pid, sends SIGTERM, waits up to 5 seconds, and escalates to SIGKILL if the process does not exit.

What happens if no CONSTRUCT server is running?▼

If views/server.pid is missing or empty, the skill reports that no server is running and exits cleanly. This is treated as a normal state, not an error.

Does stopping the views server affect other CONSTRUCT instances?▼

No. The skill only stops the server whose PID is recorded in this install root's views/server.pid file. Other CONSTRUCT instances running on different ports are unaffected.

Why does the server survive shutdown sometimes?▼

If the process survives both SIGTERM and SIGKILL, the skill reports the failure and keeps the PID file for manual diagnosis with ps -p <pid>. Check views/server.log if SIGKILL escalation becomes a pattern.

Does construct-down work on Windows?▼

No. The skill is POSIX-only for v0.2 because Windows process kill semantics differ and have not been tested. It relies on ps, kill, and shell polling loops.