APX CLI — это ежедневный цикл, а не дашборд

Перестаньте относиться к APX CLI как к огромной панели управления. Относитесь к нему как к небольшому ежедневному циклу.

Дизайн основан на разделении между APC и APX. APC остается в вашем репозитории как переносимый слой контекста. APX остается на вашей машине как локальный слой среды выполнения (runtime). Если вы попытаетесь заставить CLI делать всё, вы потеряете границу между ними.

Сосредоточьте работу с CLI с помощью следующей рутины:

• Зарегистрируйте проект один раз. • Проверяйте состояние перед началом работы. • Изучайте устойчивую память (durable memory), прежде чем просить о помощи. • Используйте tail для сообщений, чтобы увидеть, что произошло на самом деле.

Проект становится проектом APX, как только в нем появляются AGENTS.md и .apc/project.json. Вы регистрируете его следующими командами:

apx init apx project add .

Репозиторий остается переносимым, потому что дерево .apc/ содержит контракт. В нем хранятся агенты, навыки и конфигурация. APX хранит состояние среды выполнения локально на вашей машине. Это означает, что вы можете клонировать репозиторий на новую машину и восстановить структуру проекта без старой истории выполнения.

Когда вы начинаете работу, сначала проверьте среду выполнения:

apx status

Это показывает состояние демона и статус движка. Это помогает понять, является ли проблемой локальная среда выполнения или сам репозиторий. Если проект был перемещен, исправьте регистрацию:

apx project rebuild <project>

Память APX предназначена для устойчивых фактов. Используйте это для её просмотра:

apx memory reviewer

Чтобы добавить заметку, добавьте одну строку:

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

Не скармливайте моделям «сырой» контекст. Используйте стабильный контекст через память.

Если память говорит вам о том, что должно быть правдой, то сообщения говорят о том, что произошло. Используйте это для аудита системы:

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