Pontia

快速开始

安装 Pontia，将你的设备连接到 Pontia Cloud，然后在 Remote Dashboard 中开始使用你的编程 Agent。

要求

  • 带有 systemd 的 Linux，或 macOS 13.5 及更高版本。
  • 推荐的 npx 命令需要 Node.js 和 npm。没有 Node.js 时，请使用 shell 安装脚本。
  • 至少一个编程 Agent：pi、Codex、Claude Code 或某个 ACP Agent。各自的要求见 Agent Client。

安装并初始化 Pontia

运行推荐的设置命令：

npx @pontia/cli init

该命令会安装 Pontia 并打开交互式初始化程序。如果 Pontia 已安装，它会复用现有安装。你无需再次运行 pontia init。

默认安装目录为 $HOME/.local/bin。将其添加到 shell 的 PATH 中，即可直接运行 pontia 命令。设置 PONTIA_INSTALL_DIR 可使用其他目录。

npm 安装方式支持 npm 镜像和私有仓库，不需要 curl 或 openssl。如果只安装而不打开初始化程序，请运行 npx @pontia/cli install。

使用 shell 脚本安装

如果你希望不使用 Node.js 安装，请使用已签名的发布版安装脚本。它需要 curl 和 openssl；完整要求见 Linux 或 macOS。

curl -fsSL https://get.pontia.dev/install.sh | sh
"$HOME/.local/bin/pontia" init

这些命令使用默认安装目录。如果你设置了 PONTIA_INSTALL_DIR，请改为从该目录运行 pontia init。

完成初始化

初始化程序可以让你：

  1. 选择所需的 pi、Codex 和 Claude Agent 集成。
  2. 生成本地 Dashboard 凭据。
  3. 启动 Pontia 后台服务。
  4. 登录 Pontia Cloud，并为 Remote Dashboard 注册你的设备。

首次初始化时，Pontia 使用你的主目录作为 Workspace Browser 根目录。再次运行初始化程序时，现有根目录会被保留。

当提示登录并启用远程访问时，选择接受并完成浏览器授权。选择一个可用的 Edge 并确认你的设备名称。设置完成后，Pontia 会打开 Remote Dashboard。

对于 Agent 或脚本，请按照初始化，用独立命令安装 Client 集成、启动服务并注册远程访问，而不是回答向导提示。

检查服务

pontia status

使用 pontia down 停止服务，使用 pontia up 重新启动服务。

更新 Pontia

在 Linux 或 macOS 上将 pontia 和 pontiad 更新到最新的已签名稳定版：

pontia update

如果受管理的服务正在运行，Pontia 会重启它并等待其进入健康状态。如果替换或重启失败，Pontia 会恢复之前的二进制文件并尝试恢复服务。

打开你设备的 Remote Dashboard，按照 Dashboard 指南激活一个 Workspace 并启动你的第一个 Session。如果设备注册尚未完成，请先完成远程访问设置。