codex-cloud-start
Start and health-check the agent-ebpf-filter Codex Cloud frontend or docs development services without elevated kernel privileges.
SKILL.md.agents/skills/codex-cloud-start/SKILL.md
GitHubStart skill
When a task needs an interactive UI, start only the required service from the repository root:
bash scripts/codex-cloud/maintain.sh doctorfirst. If it fails, inspectreports/codex-cloud/latest.md; runmaintain.sh installonly when network and package permissions allow it.- Frontend:
bash scripts/codex-cloud/start.sh frontend. Verifyhttp://127.0.0.1:5173/; changeCODEX_FRONTEND_PORTif required. - Documentation:
bash scripts/codex-cloud/start.sh docs. Verifyhttp://127.0.0.1:5174/. bash scripts/codex-cloud/start.sh statusto inspect,bash scripts/codex-cloud/start.sh stopto stop recorded PIDs.- After code changes,
bash scripts/codex-cloud/maintain.sh verify; report its real pass/fail status and the saved log paths.
Never implicitly run make dev, scripts/dev-backend.sh, privileged containers, BPF LSM/cgroup enforcement, or kernel attach in Codex Cloud. Do not read .env.dev or inject production keys into the environment. The frontend proxies backend requests to localhost:8080; if no privileged backend is running, UI rendering can work but API-backed features are unavailable. State that limitation explicitly. Live eBPF tests require a separately authorized Linux/BTF host.