penguin-harness-manual-test

Featured

Use when standing PenguinHarness up to try a change by hand — launching the Web App, the desktop shell, the landing page or the docs site to click through it, screenshot it, or reproduce a report. Covers the four dev entry points and their ports, which data root each writes to, and the four ways a healthy setup looks broken.

Web & Frontend 2,099 stars 222 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 93/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

# Standing PenguinHarness up to test by hand Node >= 24. `dev:*` runs `dev-prebuild.mjs` first (keeps `pnpm install` current, prebuilds workspace deps); `pnpm desktop` runs a full `pnpm -r build`, so it is slow to start. ## Entry points | Command | Open | Data root | | --- | --- | --- | | `pnpm dev` | http://localhost:7365 | `~/.penguin/dev-data` | | `pnpm desktop` | its own window | `~/.penguin/dev-data` | | `pnpm dev:landing` | http://localhost:7366 | none (static) | | `pnpm dev:docs` | http://localhost:7367 | none (static) | Other fixed ports (`packages/core/src/internal/ports.ts`): 7364 installed server, 7368 dev backend, 7369 `pnpm penguin web` (data root `~/.penguin/dev-data-cli` — its own, so it can serve while an Agent it hosts runs `pnpm dev`; the lock is per root). On a shared box, `ss -tln` before assuming one is free; `PORT=` inline moves it. The user's installed app, server and CLI all use `~/.penguin/data` — their real Agents, Sessions and keys. Never point a dev run there. Both surfaces print the root they took (`Data root: …`, `[shell] dev instance … on data root …`); read it rather than assume. ## Four ways a working setup looks broken **7368 shows a stale app.** The dev backend also serves `packages/web/dist` — the last `pnpm -r build`, not what Vite is serving. Screenshot 7365, never 7368. **`curl` returns 502 but the server is fine.** A shell `http_proxy` routes loopback through the proxy. Use `curl --noproxy '*'`. Browsers and the server itself ar...

Details

Author
Prism-Shadow
Repository
Prism-Shadow/penguin-harness
Created
1 months ago
Last Updated
today
Language
TypeScript
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

penguin-harness-dev

Use when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release workflow; writing or auditing changelog entries; writing a blog post or capturing release screenshots; running the test suite here or, when asked, on another machine; deciding what to do about data already on disk; or auditing prose that reads like a leaked authoring session. Covers the two-repo symlink layout, the CI-parity verification chain, the record-and-ship contract, where blog media is hosted, and the seams that are intentional.

2,099 Updated today
Prism-Shadow
Web & Frontend Listed

ship-a-browser-surface

How to take a change to one of this repo's browser surfaces — the console PWA, the graph viewer, pulse — from edit to believed-working, and how to verify an accessibility claim by measuring the rendered DOM rather than reading the stylesheet. Use BEFORE editing anything under src/thalamus/console/static/, src/thalamus/viewer/ or frontend/, BEFORE claiming a colour or target size conforms, when a change is correct on disk and wrong on the phone, and when adding a renderer that draws a session row.

1 Updated today
Ybx-jp
Testing & QA Listed

testing-gibson-harness

How to runtime-test The Gibson's bash harness (loop.sh, second-opinion.sh, devin-supervisor.sh) — scratch repos, vendor-CLI auth reality, PATH shims, mock Devin API, and macOS bash 3.2 portability checks.

1 Updated 3 days ago
The-AIE