[尖叫声] APX v1不再维持. APX v2 替换为: 一个新的桌面应用程序、一个电话应用程序和一个单行安装 您的服务器, 从零开始重建 。 它带来了你的v1项目,代理和聊天. 见APX v2 • 妇女
curl -fsSL https://agentprojectcontext.github.io/apx/install.sh | bash
见你的船员们.
APX是一个开源代理OS:你自己的AI代理团队,运行在你的机器上.
给他们角色,记忆和工具. 和他们说话,让他们一起工作,跟随他们的行为.
研究,写作,日常计划,业务操作或代码——围绕你的生活和工作建立船员队伍.
见APX工作情况 • 妇女 安装 v1 • 妇女 APX v2 (中文(简体) ) • 妇女 西班牙语Name • 妇女 解析器
看到你的船员行动
真实记录APX v1 运行演示组. 在网站上观看更多记录的工作流程.
每个特工都得到一个 双管 ——它自己的面孔——与角色,记忆,技能和工具相伴. 在谈话中提及其中之一,它可以捡起工作或向另一名代理寻求帮助. 面相让你的船员容易识别;所记录的工作流程显示了它的实际作用.
尽你所能
- 保持一个团队 为你的每一部分的工作. 研究者,作家,组织者或编码代理:选择您需要的角色,并按项目分组.
- 给团队工作. 启动分组聊天, 在任务中提及代理, 并跟踪其回复 。 特工可以互相请求帮助.
- 把经常性的工作安排在日程上. 每日的通报会,报告和登机可以作为例行公事运行,而APX则保持运行.
- 联系来自不同地点的同一批船员. 使用网络面板, Telegram, WhatsApp 或您的手机; 您的代理人员保留他们的角色并访问他们的工具.
- 见所出事. 对话显示代理动作,而面板将聊天,任务,例行和代码会话合并在一起.
- 带上你的模型和工具. 连接模型提供商,当地Ollama模型,技能和MCP服务器. 对于编码工作,Claude Code, Codex或其他支持CLI的代表.
APX在你的机器上运行。 连接云模型和服务接收您发送请求所需的数据;本地操作并不意味着每个模型都下线运行.
为什么是APX?
尝试APX的原因是 机组工作流程:可辨认的代理人,围绕你的项目组织的角色, 在一个地方分享对话、下放的工作、任务和例行工作。 项目可以是企业,是创意 项目、个人工作空间或密码库。 您不需要 Git 寄存器开始使用 APX .
如果您已经使用 OpenClaw 或其他代理应用程序, 本地执行, 标记下的文件和信件集成 单靠自己不是改变的理由。 比较一下经验:APX是否让你的特定团队更容易组织, 合作跟随? 观看真实的工作流程 尝试一个任务 这对你很重要.
对于代码项目,代理定义,技能和共享的项目背景可以与寄存器一同出行. 对话、会话、全权证书和私人运行时间记忆都留在外面.
快开始
这个寄存器和这些安装命令用于APX v1. Requireds Node.js 22+ on macOS, Linux 或 Windows.
npm install -g @agentprojectcontext/apx
apx setup
设置向导帮助您选择一个提供者,一个模型和您的频道,启动APX,并打印您的面板地址. 打开 http://localhost:7430 (英语) 在您的浏览器中.
从一个代理和一个真正的任务开始. 随你需要增加专家及例行公事. 云提供商需要自己的访问权限或证书;本地模型需要配置的本地提供商.
更喜欢终点站? 从项目文件夹中 :
apx init
apx agent list
# Replace <agent> with an agent listed above.
apx exec <agent> "Help me plan the next steps for this project"
apx run <agent> --runtime claude-code "Review this project and suggest improvements"
apx run <agent> --runtime codex "Add tests for the parser"
编码命令需要安装和认证选定的外部 CLI .
在你的电话上
面板也适合你的电话. apx panel share 给您一个网络地址;
apx panel tailscale on 让你通过尾网到达它。 在您的手机上打开面板并添加到您的家用屏幕上.
还有个本地人 Android 应用程序,带有通知,浮动吉祥物和Android Auto:
- 下载 Android APK。 。 。 .
- 或者用USB连接你的电话 然后运行
apx android install。 。 。 . - 读取安装指南。 。 。 .
Android应用从一个文件安装,在Google Play之外. 在iPhone上,使用网页面板. USB 访问在电缆连接时持续; 局域网访问停留在您的网络内; 尾网上的 Tailscale 连接设备 .
APX v2 替换 v1
v1不再维持. APX v2将APX进一步作为您的机组的独立应用程序:从
其网站 或
main 分支。上面的v1命令安装v1,而不是v2.
运行有虚构数据的脚本演示的真V2接口:代理对代理授权,交互式部件和活浏览器页面. 观取取取光相相相.
| 经历 | APX v1 今天 | V2的方向 |
|---|---|---|
| 你的主要经纪人 | 通过面板和渠道联系到一名当地助理 | 在个人和项目工作中与主要代理人和专家合作的中心场所 |
| 对话 | 聊天、分组交谈和代码会话 | 由工程、代理和频道组织的统一收件箱,以及外部编码会话 |
| 在网络上工作 | 通过集成浏览器工具 | 嵌入式桌面浏览器:监视代理导航并接管自己 |
| 工作结束后 | 小组中的代理行动、任务和例行程序 | 围绕当前工作空间进行的对话、授权的工作、工具、文件和应用 |
| 设备 | 网页面板、信件、桌面和Android表面 | 连接到同一核心的桌面和电话客户端,包括您自己的服务器上的主机核心 |
这些是方向和目前的发展经验,而不是每个v1特征已经达到对等的保证.
V2的操作方式
flowchart TB
You[You: desktop, phone or messaging] --> Main[Your main agent]
Main <--> Crew[Specialists and project crews]
Main --> Core[One APX core]
Crew --> Core
Core <--> Tools[Models, skills and connected tools]
Core <--> Browser[Desktop browser: watch or take over]
Core <--> Work[Conversations, tasks, routines and apps]
一个核心拥有作品和历史;应用程序,电话和消息频道与之相接. 您的主要代理人可以直接工作或委托给专家。 桌面提供浏览器, 在那里你可以看到页面并控制。 这样在设备之间移动时 船员们会在一起.
跟随 网页 财务报告和审定财务报表 解析器 v2 进度并发布新闻.
文献和社区
技术参考: v1 频道和编码运行时间
消息频道
活动属于APX运行时状态,而非 .apc/。信件存储为本地到 APX,在
~/.apx/数字 :
JSONL 信件包括 type (单位:千美元)user, (中文(简体) ), agent, (中文(简体) ), tool,或 system+) 加上 (中文(简体) ) actor_id,所以聊天视图
可以区分Telegram用户与APX代理和未来子代理.
A 类 频道 是表面的转动。 警犬名单在
src/core/constants/channels.js· ; voice 是一个 模式不是频道.
| 频道 | 它捕捉到的东西 |
|---|---|
cli | apx exec 编号 : apx run 从终端 |
telegram | 电报机器人消息 |
api | 直接守护进程 HTTP 呼叫 |
web | 管理员面板主聊天 |
web_sidebar | 小组的副助理 |
web_code | 面板的编码表面 |
code | apx code 会议 |
deck | 平板电脑/电话仪表板 |
desktop | 浮动语音胶囊( 总是语音模式) |
routine | 排定的例行运行 |
运行时间
| 运行时间 | 说明 |
|---|---|
claude-code | Spawns Claude 代码 CLI 与代理系统迅速注射 |
codex | 通过非交互操作的 OpenAI Codex CLI codex exec --sandbox workspace-write --skip-git-repo-check |
opencode | 打开代码 CLI |
aider | 援助者CLI |
cursor-agent | 光标的无头代理 |
gemini-cli | 谷歌双子座CLI |
qwen-code | Quen 代码 CLI |
antigravity | 反重力CLI |
Global APX 技能安装也写有名的助手技能 codex-cli, (中文(简体) ), claude-code, (中文(简体) ),
opencode-cli,以及 openrouter。它们是有意缩小的,并且只有在下列情况下才能激活:
明确提到工具/提供者.
APX开始的地方
APX开始作为一种方式 装甲运兵车-代理项目背景 实际工作:便携式代理人定义,
技术和项目指导 AGENTS.md 财务报告和审定财务报表 .apc/它发展成一个应用 自己的船员,
对话,任务,常规,渠道和接口. APX是您今天使用的产品;APC是其发源地和项目编译基础的一部分.
您不需要学习使用APX 的协议 。 如果你想要技术背景, 读取 装甲运兵车规格。 。 。 .
对于贡献者,从 一般事务人员(其他职等). APX v1有本地守护进程,CLI,网络面板和连接外部工具的桥梁.
项目背景可以生活在项目文件夹中;运行时状态生活在 ~/.apx/,位于仓库外.