APX CLI 是一个日常循环，而不是一个仪表盘

不要再把 APX CLI 当作一个巨大的控制面板了。把它当作一个日常的小循环。

该设计依赖于 APC 与 APX 之间的职责分离。APC 作为可移植的上下文层保留在你的代码库中。APX 作为本地运行时层保留在你的机器上。如果你试图让 CLI 完成所有工作，你就会失去它们之间的边界。

通过以下常规操作让 CLI 保持专注：

• 注册一次项目。 • 工作前检查状态。 • 在寻求帮助之前，先阅读持久化记忆。 • 追踪（tail）消息以查看实际发生了什么。

一旦项目拥有了 AGENTS.md 和 .apc/project.json，它就成为了一个 APX 项目。你可以使用以下命令进行注册：

apx init apx project add .

代码库保持了可移植性，因为 .apc/ 树保存了契约。它包含了 agents、skills 和 config。APX 将运行时状态保留在本地机器上。这意味着你可以将代码库克隆到新机器，并在没有旧运行时历史的情况下恢复项目的形态。

开始工作时，先检查运行时：

apx status

这会显示守护进程（daemon）健康状况和引擎状态。它能帮你判断问题出在本地运行时还是代码库。如果项目移动了，请修复注册信息：

apx project rebuild <project>

APX memory 用于存储持久的事实。使用此命令进行查看：

apx memory reviewer

要添加笔记，追加一行即可：

apx memory reviewer --append "Prefers short PR summaries"

不要向模型喂入原始上下文。通过 memory 使用稳定的上下文。

如果 memory 告诉你“应当是什么样”，那么 messages 就会告诉你“实际发生了什么”。使用此命令审计系统：

apx messages tail --channel runtime -n 20

将以下三者分开：

  • memory.md: 用于持久事实。
  • messages: 用于近期活动。
  • sessions: 用于调用历史。

一个文件不应承担三项工作。APC 定义项目，APX 定义今天发生了什么。

使用以下序列来保持状态清晰：

apx project list apx memory reviewer apx messages tail -n 20

将 CLI 作为一种习惯来使用，效果最佳。使用代码库进行可移植上下文管理。使用机器进行运行时状态管理。每天使用 CLI 来检查边界。

Source: https://dev.to/agentprojectcontext/the-apx-cli-is-a-daily-loop-not-a-dashboard-1o98

Optional learning community: https://t.me/GyaanSetuAi