remote-agent-server

Remote Agent Server 是一个自托管的 Agent 执行网关，能够将 Claude Code、Codex 和 Hermes 等 AI 代理工具接入到工单系统、CI/CD流水线以及业务系统中。它提供 Web 管理控制台，允许用户直接发起任务；同时支持通过 HTTP API、GitHub/GitLab Webhook 等方式调用熟悉的命令行 Agent。服务端负责处理任务的排队、工作区隔离、会话管理和执行记录；外部系统则通过查询、SSE流或签名 Webhook 获取进度与结果。

项目采用 acpx（Agent Context Protocol）和 Agent Client Protocol (ACP) 作为底层通信协议，支持 Skills、MCP、执行器扩展以及模型策略配置。单个 Fastify 进程配合 SQLite WAL 存储层，无需额外部署数据库或消息队列即可运行。项目环境通过 Git 仓库预置依赖和环境变量，Session Workspace 使用 APFS Clone（macOS）或 Btrfs Snapshot（Linux）实现写时复制隔离。

核心设计原则包括：每个 Session 拥有独立的 Write-Once-Read-Many (WORM) Workspace；同一会话可连续执行多个 Run 并在 Provider 支持下续接 ACP Session；外部调用方通过幂等键保证任务不重复执行。项目环境版本管理采用 uv.lock + pyproject.toml，支持依赖迁移和版本回退。

部署方式包括 Docker Compose、Linux systemd 服务以及 macOS LaunchAgent。Web 管理台提供从 Git 仓库同步项目环境、创建 Agent、配置模型策略、查看任务状态的全流程界面。首次使用需完成 Provider 认证（如 claude auth login）、项目环境初始化及 Workspace 克隆，后续可通过 API 或 Webhook 实现持续集成接入。

适用于需要长期运行 AI Agent 的 DevOps 团队、运维平台以及希望将现有 Shell/CI 脚本与 Agent 能力结合的开发者。首次部署建议先在管理台跑通一个简单任务验证流程，再逐步接入生产环境中的工单系统或 CI/CD 流水线。