Agent Skills › NicholasFlemmer/styx-app › run-app

run-app

GitHub

启动 Styx 开发环境并诊断常见启动故障，如 ABI 不匹配、端口占用、Keychain 循环及 Electron 二进制缺失等问题。

.claude/skills/run-app/SKILL.md NicholasFlemmer/styx-app

Trigger Scenarios

启动应用时遇到报错需要快速运行特定屏幕的测试

Install

npx skills add NicholasFlemmer/styx-app --skill run-app -g -y

More Options

Non-standard path

npx skills add https://github.com/NicholasFlemmer/styx-app/tree/main/.claude/skills/run-app -g -y

Use without installing

npx skills use NicholasFlemmer/styx-app@run-app

指定 Agent (Claude Code)

npx skills add NicholasFlemmer/styx-app --skill run-app -a claude-code -g -y

安装 repo 全部 skill

npx skills add NicholasFlemmer/styx-app --all -g -y

预览 repo 内 skill

npx skills add NicholasFlemmer/styx-app --list

SKILL.md

Frontmatter

{
    "name": "run-app",
    "description": "Launch Styx in dev with a seeded fixture and open a specific screen; diagnose common startup failures (native ABI mismatch, missing fonts, locked SQLite, keychain prompts, stale broker socket).",
    "allowed-tools": "Bash(pnpm:*), Bash(lsof:*), Bash(ps:*), Bash(rm:*), Read",
    "argument-hint": "[fixture] [screen]"
}

Run app

STYX_FIXTURE=${0:-demo} STYX_SCREEN=$1 STYX_KEYCHAIN=memory pnpm dev

Symptom	Fix
`NODE_MODULE_VERSION` mismatch / `was compiled against a different Node.js version`	`pnpm rebuild:native`
`EADDRINUSE` / stale socket	remove `/tmp/styx-<uid>/broker.sock`
Keychain prompt loop	`STYX_KEYCHAIN=memory`
Blank window	run with `--inspect` and read the renderer console; check CSP in `src/renderer/index.html`
Fonts fall back	`pnpm tokens:build` (copies woff2 from @fontsource)
Electron binary missing	`node node_modules/electron/install.js`
`TypeError: Cannot read properties of undefined (reading 'setPath')` / `electron.app` undefined	The shell inherits `ELECTRON_RUN_AS_NODE=1` (VS Code extension host). Run with `env -u ELECTRON_RUN_AS_NODE …`; the e2e launcher strips it automatically.