APX CLIはダッシュボードではなく、日々のループである
APX CLIを巨大なコントロールパネルのように扱うのはやめましょう。日々の小さなループとして扱ってください。
この設計は、APCとAPXの分離に基づいています。APCはポータブルなコンテキスト層としてリポジトリ内に保持されます。APXはローカルなランタイム層としてマシン上に保持されます。CLIにすべてをやらせようとすると、両者の境界が失われてしまいます。
次のルーチンに従って、CLIの役割を絞り込みましょう：
• プロジェクトを一度だけ登録する。 • 作業前に状態を確認する。 • 助けを求める前に、永続的なメモリ（durable memory）を読み込む。 • メッセージをtailして、実際に何が起きたかを確認する。
AGENTS.mdと.apc/project.jsonが存在すれば、そのプロジェクトはAPXプロジェクトとなります。以下のコマンドで登録できます：
apx init
apx project add .
.apc/ツリーがコントラクト（契約）を保持しているため、リポジトリのポータビリティが維持されます。ここにはエージェント、スキル、設定が含まれます。APXはランタイムの状態をマシン上にローカルに保持します。つまり、リポジトリを新しいマシンにクローンしても、古いランタイムの履歴を引き継ぐことなく、プロジェクトの構成を復元できるということです。
作業を開始するときは、まずランタイムを確認してください：
apx status
これにより、デーモンの健全性とエンジンのステータスが表示されます。リポジトリではなく、ローカルのランタイムに問題があるのかどうかを判断するのに役立ちます。プロジェクトが移動した場合は、登録を修正してください：
apx project rebuild <project>
APX memoryは永続的な事実のためのものです。内容を確認するにはこれを使用します：
apx memory reviewer
ノートを追加するには、1行追記します：
apx memory reviewer --append "Prefers short PR summaries"
モデルに生のコンテキストをそのまま与えないでください。メモリを通じて安定したコンテキストを使用してください。
メモリが「あるべき事実」を伝え、メッセージが「実際に起きたこと」を伝えます。システムを監査するにはこれを使用してください：
apx messages tail --channel runtime -n 20
次の3つを明確に分けておきましょう：
- memory.md: 永続的な事実用。
- messages: 最近のアクティビティ用。
- sessions: 呼び出し履歴用。
1つのファイルに3つの役割を持たせてはいけません。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