TUI

不带参数运行 joppa 会在终端中以全屏方式打开应用，视觉风格与窗口一致：

• 侧边栏：项目和服务，带有状态指示点和端口；
• 所选项目的页面：域名及其健康状态、服务状态、它的数据库、实时日志；
• 状态栏：代理、CA、在线域名、运行时。

所有内容每两秒刷新一次。主题跟随终端（Nuit 深色或 Jour 浅色）；--theme 可强制指定，T 可切换。

按键

按键	操作
↑ ↓ · j k	移动
tab	在侧边栏和页面之间切换
ctrl p · :	命令面板，相当于应用中的 ⌘ K
p	启动 / 停止代理
s	启动 / 停止服务
空格	启用 / 停用域名
o	在浏览器中打开域名
c	复制其 URL
t	在 TablePlus 中打开
n	创建数据库
a	添加项目（在“项目”上）或服务（在“服务”上）
N	从模板新建项目
T	切换主题
esc	返回上一步
? · q	帮助 · 退出

也可以使用鼠标：单击、双击打开、滚轮滚动。

在 TUI 中添加

• 项目（a）：选择文件夹（默认是当前文件夹，tab 可补全路径）、查看 Joppa 在其中检测到的内容（用 空格 勾选域名，或手动添加：app 5173），然后填写名称。
• 服务（在“服务”上按 a）：按类别浏览服务目录，选择版本（← →）和第一个空闲端口，然后启动。
• 新项目（N）：选择模板、名称、父文件夹和选项，查看命令，然后实时查看创建过程；esc 可取消。

如果应用没有运行，TUI 会提示你并提议启动它（l），之后会自动重新连接。