omas

English: README.en.md

Agent 时代，上下文太多。omas 帮你把每个任务拆成独立会话——终端居中、用完即关标签页，Agent 在后台继续跑；历史自动扫描，随时轻松恢复。

面向 AI 辅助开发的自托管 Web 终端。不是 Agent，不是 IDE 替代品，而是减轻记忆负担的 Shell 控制台：主界面是 terminal，侧栏只保留改小文件、review AI 改动刚好够用的能力。

核心想法：记忆要轻便

一个人同时开着 Claude、Cursor、三个 repo、五路 Agent 时，最难的不是跑命令，而是记住「哪个窗口在干嘛」。

omas 的做法：

  你的大脑                         omas 帮你记住的
  ─────────                       ─────────────────
  「这个项目 Agent 在跑测试」  →    会话列表 + scrollback
  「上次 Claude 会话 id 是啥」 →    历史页按项目分组、自动解析 cwd
  「改了哪些文件」           →    Git 侧栏 diff
  「改个 yaml 就行」         →    文件树点开保存，不用开 IDE

和编辑器 / Agent 客户端比

omas 不抢 Cursor、VS Code、Claude Desktop 的饭碗——复杂重构、大项目导航、Chat 推理仍在 IDE 里做。omas 管的是 「Agent 在跑、Shell 在干、改动要过一眼」 这段轻量上下文。

一句话：IDE 负责想清楚、写大块代码；omas 负责跑着、看着、过改动、随时续上 Agent——且不用把所有上下文都塞进一个编辑器窗口。

和 CLI + tmux 比

很多人用 SSH → tmux → Claude/Cursor CLI 挂 Agent。tmux 会话保活很强，但在 「往上滚看日志」和「复制一段输出」 上很难兼顾——omas 刻意用浏览器 + xterm 绕开这套摩擦。

tmux 的核心矛盾：想 鼠标滚历史，往往要开 mouse 模式，但 复制 仍依赖 copy-mode，和 TUI 应用的鼠标事件、选区逻辑缠在一起；关 mouse 则滚历史也要进 copy-mode，无法同时「自然滚动」和「自然复制」。omas 把 PTY 输出放进 xterm.js，滚动与复制交给浏览器——Agent 长跑时查日志、拷报错、贴进 Issue 都更省事。

omas 不是 tmux 替代品：不需要 pane 编排、远程纯 SSH 的极简场景，tmux 依然合适。omas 适合 Agent 工作流 + 经常要翻输出/复制 + 偶尔远程看一眼。

典型用法：用完即弃的标签页

┌──────────┬──────────────────────────────┬──────────┐
│ 文件树   │  ■ 会话 A  claude --resume    │ Git diff │
│ 改 .env  │  ■ 会话 B  npm test           │ review   │
│          │  ■ 会话 C  tail -f log        │ AI 改动  │
└──────────┴──────────────────────────────┴──────────┘
     ↑ 轻量编辑              ↑ 主舞台              ↑ 过一眼再 merge

1. 历史页恢复 — 自动扫描本机 AI CLI 会话，按项目分组；点恢复 → 新标签页 / 弹窗，自动 cd + --resume。
2. 一会话一任务 — Agent 长跑占一个会话；你另开空会话查日志，关掉标签页不杀 Agent（omas 进程里 PTY 仍在）。
3. Review 再决定 — Git 面板看 Agent 改了什么；小改动侧栏保存，大的 $EDITOR 丢回终端或回 IDE。
4. 用完即走 — 任务结束关掉浏览器标签；上下文留在 omas 会话列表和历史页，不必占着 IDE 工作区。

→ 详细说明：docs/AI-WORKFLOW.md

和 ttyd 有什么不同？

ttyd / gotty 是通用 Web 终端；omas 在终端之上加了 Agent 时代的会话管理：

• 多会话列表、断线重连、scrollback
• Claude / Cursor / Qoder / OpenCode 历史扫描与恢复
• 文件树 + Git 侧栏（够用即可，不膨胀成 IDE）
• 单文件 omas 二进制，四架构 Release

快速开始

下载二进制（推荐）：Releases 取 omas-*，或：

git clone https://github.com/lilymoonight/omas.git && cd omas
npm install && npm run build    # → release/omas

chmod +x release/omas
./release/omas serve --port 7681
# http://127.0.0.1:7681（默认无密码；生产环境请 omas init）

omas init                       # 持久化密码
omas install --prefix ~/.local/bin
omas service install            # 后台常驻 → Agent 关浏览器也能继续跑

文档

开发

OMAS_PASSWORD=devpass npm run dev:server   # :7681
npm run dev:web                            # :5173
npm test && npm run typecheck

命名说明

License

MIT © lily