paperclip-dev-workspace-run-verify-fix

Featured

Run, verify, reseed, and repair Paperclip isolated dev workspace services. Use when asked to start or fix a managed project/worktree service and prove health, login readiness, cloned data, runtime visibility, and correct port ownership.

AI & Automation 114,742 stars 19046 forks Updated today MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Paperclip Dev Workspace Run / Verify / Fix This skill is for Paperclip-specific development workspaces whose service is started through project execution workspace runtime services, typically a worktree service such as `paperclip-dev`. Success means all of these are true: - the service was started through the normal managed runtime path, not a detached workaround - the worktree database is a full bootstrapped isolated clone of the primary instance database - `/api/health` returns `status: ok` and `bootstrapStatus: ready` - the root page returns `200` and does not show the first-admin setup gate - the board user can log in with their normal dev credentials - the app shows populated cloned data, not only a manually copied auth user - the main control plane shows the service as `running` / `healthy` with the expected URL - the served workspace app also knows about that service and shows it as `running` / `healthy` - the process that owns the service port really belongs to the target workspace: `readlink /proc/<pid>/cwd` resolves inside the target worktree, not a sibling workspace If any item fails, keep fixing. Do not mark the issue done because one probe passed. ## Hard rules - The master checkout `/srv/paperclip/home/paperclipai/paperclip` (the primary repo with the real instance `.env`) is never a workspace repair target. Never point a worktree runtime service at it, never `git worktree add` into it or under `<master>/.paperclip/worktrees/`, and neve...

Details

Author
paperclipai
Repository
paperclipai/paperclip
Created
8 months ago
Last Updated
today
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category