Replit toolkit — one skill, four lanes

references/platform.md

references/platform.md

setup.sh

replit_userenv.py

cannot open shared object file

references/nix.md

generate-closure.sh

libpool.sh

references/playwright-chromium.md

ensure_browser.sh

monitor.sh

browser_monitor.py

browser_exec

references/camofox.md

start-camofox.sh

camofox.py

--locked

references/hermes-on-replit.md

The platform in five facts (detail in platform.md)

1. $HOME

   (

   /home/runner

   ) is wiped on recreate;

   $REPL_HOME

   (

   /home/runner/workspace

   ) is persistent. Anything you want to survive lives under the workspace. The XDG vars are pre-set into the workspace, but do not trust that implicitly — check with

   printenv | grep XDG_

   .
2. Everything system-level comes from

   /nix/store

   , and store paths get GC'd. A path that worked yesterday may not exist today; long-lived things need a durable copy outside the store (see nix.md, hermes-on-replit.md).

3. $REPLIT_LD_LIBRARY_PATH

   is never enough for GUI browsers — you need the full transitive closure (nix.md §3;

   generate-closure.sh

   ).
4. npm is behind a package firewall; pin

   --registry=https://registry.npmjs.org/

   .
5. Replit ships a Playwright-managed Chromium —

   $REPLIT_PLAYWRIGHT_CHROMIUM_EXECUTABLE

   ; never

   playwright install

   .

Scripts (flat, all in

scripts/

)

• setup.sh

  — idempotent toolchain/env provisioning (node/uv/python pins, LD paths, rc chain); run it after any recreate.

  --doctor

  verifies installs + wiring read-only (exit 2 = wiring gaps);

  --fix

  rewrites ALL wiring (rc block, userenv, shim, ~/.profile, hermes shell_init_files, libatomic) with zero downloads/reinstalls — safe after a $HOME wipe or a partial recreate.

  --doctor --fix

  = report then repair. Re-running

  --fix

  is a byte-identical fixed point. Pitfall encoded in the script:

  --fix

  never execs the

  hermes

  launcher — any subcommand can boot the full source-update cycle (venv sync, npm build, GB-scale runtime clone). config.yaml is edited textually + verified instead.

• replit_userenv.py

  — structural

  .replit [userenv]

  edits (tomlkit, no regex).

• start-camofox.sh

  — one-command provision + launch of the Camoufox server.

• camofox.py

  — the scraping CLI (open/nav/eval/screenshot, cookie import, keep-alive loop). See camofox.md for its env-file contract.

• generate-closure.sh

  /

  libpool.sh

  — transitive lib closure (per-process) + pool healing (additive-only).

• camofox_mcp_check.sh

  — one-shot MCP health probe (waits for REST, runs a real stdio handshake, asserts the 11

  camofox_*

  tools; exit 0 = live). Used by the

  .replit

  "camofox mcp" workflow — the adapter itself is stdio-only, running it standalone just idles forever.

• ensure_browser.sh

  — idempotent CDP launcher for the bundled Chromium.

• monitor.sh

  /

  browser_monitor.py

  — opt-in :5000 screenshot relay.

camofox.env.example

$CAMOFOX_ROOT/.env

Installing this skill pack

npx -y skills add skynight137/skills -s replit