toor
1e9ea89d86
Import the client, server, skills, tests, and build scripts as the starting point for the rebuild, then trim the surfaces this project does not ship: Electron desktop packaging, the marketing website, and the ESP32 firmware tree. CI keeps the web build, e2e, lockfile, release, and Docker workflows. Rename the package and CLI entry points to hermes-ui, drop the prepare hook so npm ci no longer triggers a build, and drop the removed tsconfig and nodemon references. Rewrite AGENTS.md, ARCHITECTURE.md, DEVELOPMENT.md, and the READMEs so the documented package map and hard rules match this repository. reference_code/ is ignored: it is a read-only snapshot, not an input to the build.
1.3 KiB
1.3 KiB
Worktree Runbook
Use a separate git worktree for agent changes so local user work remains untouched.
Create A Worktree
git fetch origin --prune
git worktree add -b codex/<short-topic> ../worktrees/hermes-web-ui-<short-topic> origin/main
cd ../worktrees/hermes-web-ui-<short-topic>
If the repository uses a fork remote, push to the remote requested by the task. Do not rewrite or reset unrelated branches.
Install
npm ci --ignore-scripts
npm rebuild node-pty
Isolated Runtime
Use per-worktree state and ports to avoid colliding with a running local app:
export PORT=18648
export HERMES_WEB_UI_HOME="$PWD/.tmp/hermes-web-ui"
export HERMES_WEBUI_STATE_DIR="$HERMES_WEB_UI_HOME"
export UPLOAD_DIR="$PWD/.tmp/uploads"
npm run dev
Do not point HERMES_WEB_UI_HOME at a user's real ~/.hermes-web-ui when a task
only needs local verification.
Browser Checks
For browser-visible changes:
npm run test:e2e
Prefer existing Playwright fixtures and mocked backend services. Add real-service requirements only when the behavior cannot be represented with mocks.
Cleanup
After a PR is pushed and no more local work is needed:
git worktree remove ../worktrees/hermes-web-ui-<short-topic>
Only remove the worktree you created.