construct-up

Starts the CONSTRUCT views server on a free localhost port with PID tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires serve.

What problem does it solve? Manually launching the CONSTRUCT views server involves checking for stale processes, finding a free port, and verifying the server actually started. This Skill automates that entire startup sequence with fail-fast pre-flight checks and clear error messages. ## Core Features & Use Cases - Pre-flight validation: Verifies the views build exists, detects already-running servers via the PID file, and cleans up stale PID files before starting. - Automatic port selection: Scans ports 3001–3009 and binds the first free one, failing clearly if all are occupied. - Verified detached startup: Launches the serve binary directly (no npm wrapper) so the recorded PID is the real server process, then confirms the process is alive and the port is bound. - Use Case: You say "Start CONSTRUCT" and the Skill brings up the views SPA at http://localhost:3001/, records the PID in views/server.pid, and reports the URL, PID, and log location. ## Quick Start Ask the agent to start CONSTRUCT or show the views, and it will launch the views server and report the local URL.

Frequently Asked Questions about construct-up

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

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

Say "Start CONSTRUCT" or "Show me the views" and the Skill launches the views server on the first free port between 3001 and 3009. It verifies the build exists, starts the serve binary detached, and reports the URL, PID, and log path.

Why does the server start fail with 'views/build not found'?▼

The views/build directory with index.html must exist before the server can start. Run views-build first, or views-scaffold plus views-build on a fresh install, then retry construct-up.

What happens if a CONSTRUCT server is already running?▼

The Skill checks views/server.pid and fails with a message showing the running server's URL and PID. Stop it with construct-down first, then re-run construct-up.

Which port does the CONSTRUCT views server use?▼

It scans ports 3001 through 3009 in order and binds the first free one. If all nine ports are occupied, startup fails and you must stop another instance or process using those ports.

Does construct-up work on Windows?▼

No, the procedure assumes a POSIX shell such as macOS or Linux, using lsof, nohup, and ps. Windows behavior is untested in v0.2.