run-devlisted

# Run the Codevisor dev app/server From the repository worktree root, run: ```sh bun run dev ``` This is the canonical development command. It: - derives a stable identity and preferred port from the current worktree; - builds the TypeScript server and native Swift app; - uses worktree-local `DerivedData`; - launches `Codevisor (<worktree-name>)` with an isolated database and Application Support directory; - owns both processes and stops the server when the app exits or the command is interrupted. Do not start the development server by itself. The app and server are one development instance and must receive the same port and data configuration. Set `CODEVISOR_DEV_PORT` only when a specific port is required. Ordinarily the runner selects a deterministic available port automatically. ## Rules - Never `xcodebuild` a shared main checkout that other agent sessions may be editing. Run from your own git worktree; the development command uses that worktree's ignored `DerivedData` directory. - Keep at most one `bun run dev` instance running for the current worktree. Before starting one, check whether this worktree already has a live instance. Reuse an instance you started when it is still current; never start a second instance on another port. - Track the owning `bun run dev` process for every instance you start. Stop that parent process and wait for its app and server children to exit before starting a replacement. Do not kill arbitrary listeners by port, process name, or bro