𝗧𝗵𝗲 𝗔𝗣𝗫 𝗖𝗟𝗜 ਇੱਕ ਰੋਜ਼ਾਨਾ ਲੂਪ ਹੈ, ਡੈਸ਼ਬੋਰਡ ਨਹੀਂ

APX CLI ਨੂੰ ਇੱਕ ਵਿਸ਼ਾਲ ਕੰਟਰੋਲ ਪੈਨਲ ਵਾਂਗ ਸਮਝਣਾ ਬੰਦ ਕਰੋ। ਇਸਨੂੰ ਇੱਕ ਛੋਟੇ ਰੋਜ਼ਾਨਾ ਲੂਪ ਵਜੋਂ ਵਰਤੋ।

ਇਹ ਡਿਜ਼ਾਈਨ APC ਅਤੇ APX ਵਿਚਕਾਰ ਵੰਡ 'ਤੇ ਨਿਰਭਰ ਕਰਦਾ ਹੈ। APC ਤੁਹਾਡੇ ਰੈਪੋ (repo) ਵਿੱਚ ਇੱਕ ਪੋਰਟੇਬਲ ਕੰਟੈਕਸਟ ਲੇਅਰ (context layer) ਵਜੋਂ ਰਹਿੰਦਾ ਹੈ। APX ਤੁਹਾਡੀ ਮਸ਼ੀਨ 'ਤੇ ਇੱਕ ਲੋਕਲ ਰਨਟਾਈਮ ਲੇਅਰ (local runtime layer) ਵਜੋਂ ਰਹਿੰਦਾ ਹੈ। ਜੇਕਰ ਤੁਸੀਂ CLI ਤੋਂ ਸਭ ਕੁਝ ਕਰਵਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਉਹਨਾਂ ਵਿਚਕਾਰਲੀ ਸੀਮਾ ਗੁਆ ਲੈਂਦੇ ਹੋ।

ਇਸ ਰੁਟੀਨ ਨਾਲ CLI ਨੂੰ ਕੇਂਦਰਿਤ ਰੱਖੋ:

• ਪ੍ਰੋਜੈਕਟ ਨੂੰ ਇੱਕ ਵਾਰ ਰਜਿਸਟਰ ਕਰੋ। • ਕੰਮ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਆਪਣੀ ਸਟੇਟ (state) ਦੀ ਜਾਂਚ ਕਰੋ। • ਮਦਦ ਮੰਗਣ ਤੋਂ ਪਹਿਲਾਂ ਡਿਊਰੇਬਲ ਮੈਮੋਰੀ (durable memory) ਪੜ੍ਹੋ। • ਇਹ ਦੇਖਣ ਲਈ ਕਿ ਅਸਲ ਵਿੱਚ ਕੀ ਹੋਇਆ ਹੈ, ਮੈਸੇਜਾਂ ਨੂੰ ਟੇਲ (tail) ਕਰੋ।

ਇੱਕ ਪ੍ਰੋਜੈਕਟ ਉਦੋਂ APX ਪ੍ਰੋਜੈਕਟ ਬਣ ਜਾਂਦਾ ਹੈ ਜਦੋਂ ਉਸ ਵਿੱਚ AGENTS.md ਅਤੇ .apc/project.json ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਇਹਨਾਂ ਕਮਾਂਡਾਂ ਨਾਲ ਇਸਨੂੰ ਰਜਿਸਟਰ ਕਰਦੇ ਹੋ:

apx init apx project add .

ਰੈਪੋ (repo) ਪੋਰਟੇਬਲ ਰਹਿੰਦੀ ਹੈ ਕਿਉਂਕਿ .apc/ ਟ੍ਰੀ (tree) ਕੰਟਰੈਕਟ ਨੂੰ ਸੰਭਾਲਦੀ ਹੈ। ਇਸ ਵਿੱਚ agents, skills, ਅਤੇ config ਹੁੰਦੇ ਹਨ। APX ਰਨਟਾਈਮ ਸਟੇਟ ਨੂੰ ਤੁਹਾਡੀ ਮਸ਼ੀਨ 'ਤੇ ਲੋਕਲ ਰੱਖਦਾ ਹੈ। ਇਸਦਾ ਮਤਲਬ ਹੈ ਕਿ ਤੁਸੀਂ ਇੱਕ ਰੈਪੋ ਨੂੰ ਨਵੀਂ ਮਸ਼ੀਨ 'ਤੇ ਕਲੋਨ ਕਰ ਸਕਦੇ ਹੋ ਅਤੇ ਪੁਰਾਣੀ ਰਨਟਾਈਮ ਇਤਿਹਾਸ ਤੋਂ ਬਿਨਾਂ ਪ੍ਰੋਜੈਕਟ ਦੇ ਰੂਪ ਨੂੰ ਮੁੜ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦੇ ਹੋ।

ਜਦੋਂ ਤੁਸੀਂ ਕੰਮ ਸ਼ੁਰੂ ਕਰਦੇ ਹੋ, ਪਹਿਲਾਂ ਰਨਟਾਈਮ ਦੀ ਜਾਂਚ ਕਰੋ:

apx status

ਇਹ ਡੇਮਨ (daemon) ਦੀ ਸਿਹਤ ਅਤੇ ਇੰਜਣ ਦੀ ਸਟੇਟ ਦਰਸਾਉਂਦਾ ਹੈ। ਇਹ ਤੁਹਾਨੂੰ ਇਹ ਦੇਖਣ ਵਿੱਚ ਮਦਦ ਕਰਦਾ ਹੈ ਕਿ ਰੈਪੋ ਦੀ ਬਜਾਏ ਲੋਕਲ ਰਨਟਾਈਮ ਸਮੱਸਿਆ ਤਾਂ ਨਹੀਂ ਹੈ। ਜੇਕਰ ਕੋਈ ਪ੍ਰੋਜੈਕਟ ਹਿੱਲ ਗਿਆ ਹੈ, ਤਾਂ ਰਜਿਸਟ੍ਰੇਸ਼ਨ ਨੂੰ ਠੀਕ ਕਰੋ:

apx project rebuild <project>

APX ਮੈਮੋਰੀ ਡਿਊਰੇਬਲ ਤੱਥਾਂ (durable facts) ਲਈ ਹੈ। ਇਸਦੀ ਸਮੀਖਿਆ ਕਰਨ ਲਈ ਇਸਦੀ ਵਰਤੋਂ ਕਰੋ:

apx memory reviewer

ਨੋਟ ਜੋੜਨ ਲਈ, ਇੱਕ ਲਾਈਨ ਜੋੜੋ:

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

ਮਾਡਲਾਂ ਨੂੰ ਰਅਅ (raw) ਕੰਟੈਕਸਟ ਨਾ ਦਿਓ। ਮੈਮੋਰੀ ਰਾਹੀਂ ਸਥਿਰ ਕੰਟੈਕਸਟ ਦੀ ਵਰਤੋਂ ਕਰੋ।

ਜੇਕਰ ਮੈਮੋਰੀ ਤੁਹਾਨੂੰ ਦੱਸਦੀ ਹੈ ਕਿ ਕੀ ਸੱਚ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਤਾਂ ਮੈਸੇਜ ਤੁਹਾਨੂੰ ਦੱਸਦੇ ਹਨ ਕਿ ਕੀ ਹੋਇਆ। ਸਿਸਟਮ ਦੀ ਆਡਿਟ ਕਰਨ ਲਈ ਇਸਦੀ ਵਰਤੋਂ ਕਰੋ:

apx messages tail --channel runtime -n 20

ਇਹਨਾਂ ਤਿੰਨ ਚੀਜ਼ਾਂ ਨੂੰ ਵੱਖਰਾ ਰੱਖੋ:

  • memory.md: ਡਿਊਰੇਬਲ ਤੱਥਾਂ ਲਈ।
  • messages: ਹਾਲੀਆ ਗਤੀਵਿਧੀ ਲਈ।
  • sessions: ਇਨਵੋਕੇਸ਼ਨ ਇਤਿਹਾਸ (invocation history) ਲਈ।

ਇੱਕ ਫਾਈਲ ਨੂੰ ਤਿੰਨ ਕੰਮ ਨਹੀਂ ਕਰਨੇ ਚਾਹੀਦੇ। 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