Haunting Things 是一个多智能体会话管理的 Web 服务器应用。启动后会在本机提供浏览器访问入口，用户可以通过 Web 页面创建团队、管理智能体成员、发起对话，并在同一个服务中保存会话、附件和运行状态。
- 提供基于浏览器的团队与智能体工作台。
- 支持会话消息、附件和团队数据的本地持久化。
- 工作区作为独立实体保存，会话和团队只通过
workspaceId关联；WebUI 只能在服务端启动项目目录内新建工作区分组，不支持手工输入绝对路径。 - 左侧 Teams 按工作区分组展示，未绑定持久工作区的内容统一归入“对话”；工作区不能被直接删除，当其下没有 Team 和 Conversation 时会自动清理工作区记录，且不会删除磁盘上的实际文件夹。
- 支持 ACP session、权限模式、模型选择和 MCP 工具配置的会话级恢复。
- 应用重启会自动修复异常退出遗留的 running 会话状态。
- 可开启局域网与 Tailscale 远程访问。
npx haunting-things服务默认监听 http://127.0.0.1:25808。如需修改端口，可在启动时设置 PORT：
PORT=3000 npx haunting-things服务启动后，在浏览器中打开 http://127.0.0.1:25808 即可使用。
mkdir test-haunting-things
cd test-haunting-things
npm init -y
npm install haunting-things
npm exec haunting-things本地安装会把命令放到当前项目的 node_modules/.bin/haunting-things。Shell 不会自动把这个目录加入全局 PATH，因此如果不使用 npx，也可以直接运行：
./node_modules/.bin/haunting-things如果希望在当前终端直接输入 haunting-things，可以把本项目的本地命令目录加入 PATH：
export PATH="$PWD/node_modules/.bin:$PATH"
haunting-things如需在任意目录直接输入 haunting-things，请使用全局安装：
npm install -g haunting-things
haunting-things项目只保留三条 npm script 命令：
npm run dev
npm run check
npm run builddev：构建前端资源，并以 watch 模式热重启开发服务器。check：执行 Node 与原生依赖检查、前端样式约束检查、ESLint、TypeScript 类型检查和测试。build：检查构建环境与前端样式约束，然后构建前端和服务端产物。
项目辅助脚本统一使用 TypeScript 编写，并通过 tsx 直接执行。