𝗧𝗵𝗲 𝗔𝗣𝗫 𝗖𝗟𝗜 𝗜𝘀 𝗔 𝗗𝗮𝗶𝗹𝘆 𝗟𝗼𝗼𝗽, 𝗡𝗼𝘁 𝗔 𝗗𝗮𝘀𝗵𝗯𝗼𝗮𝗿𝗱
APX CLIని ఒక పెద్ద కంట్రోల్ ప్యానెల్గా చూడటం ఆపండి. దానిని ఒక చిన్న రోజువారీ లూప్గా పరిగణించండి.
ఈ డిజైన్ APC మరియు APX మధ్య విభజనపై ఆధారపడి ఉంటుంది. APC మీ రిపో (repo)లో ఒక పోర్టబుల్ కాంటెక్స్ట్ లేయర్గా ఉంటుంది. APX మీ మెషీన్లో ఒక లోకల్ రన్టైమ్ లేయర్గా ఉంటుంది. మీరు CLIతో అన్ని పనులు చేయించాలని ప్రయత్నిస్తే, వాటి మధ్య ఉన్న సరిహద్దును కోల్పోతారు.
ఈ విధానంతో CLIని ఫోకస్డ్గా ఉంచండి:
• ప్రాజెక్ట్ను ఒకసారి రిజిస్టర్ చేయండి. • పని ప్రారంభించే ముందు మీ స్టేట్ను (state) తనిఖీ చేయండి. • సహాయం కోరకముందే డ్యూరబుల్ మెమరీని (durable memory) చదవండి. • అసలు ఏం జరిగిందో తెలుసుకోవడానికి మెసేజ్లను టెయిల్ (tail) చేయండి.
ఒక ప్రాజెక్ట్లో AGENTS.md మరియు .apc/project.json ఉన్నప్పుడు అది APX ప్రాజెక్ట్గా మారుతుంది. ఈ కమాండ్లతో మీరు దానిని రిజిస్టర్ చేయవచ్చు:
apx init
apx project add .
.apc/ ట్రీ కాంట్రాక్ట్ను కలిగి ఉండటం వల్ల రిపో పోర్టబుల్గా ఉంటుంది. ఇది ఏజెంట్లు, స్కిల్స్ మరియు కాన్ఫిగరేషన్ను కలిగి ఉంటుంది. APX రన్టైమ్ స్టేట్ను మీ మెషీన్లో లోకల్గా ఉంచుతుంది. అంటే, మీరు ఒక రిపోను కొత్త మెషీన్లోకి క్లోన్ చేసి, పాత రన్టైమ్ హిస్టరీ లేకుండానే ప్రాజెక్ట్ రూపాన్ని తిరిగి పొందవచ్చు.
మీరు పని ప్రారంభించినప్పుడు, మొదట రన్టైమ్ను తనిఖీ చేయండి:
apx status
ఇది డెమొన్ హెల్త్ (daemon health) మరియు ఇంజిన్ స్టేటస్ను చూపుతుంది. సమస్య రిపోలో ఉందో లేక లోకల్ రన్టైమ్లో ఉందో తెలుసుకోవడానికి ఇది మీకు సహాయపడుతుంది. ఒకవేళ ప్రాజెక్ట్ మారితే, రిజిస్ట్రేషన్ను సరిచేయండి:
apx project rebuild <project>
APX మెమరీ అనేది డ్యూరబుల్ ఫ్యాక్ట్స్ (durable facts) కోసం. దానిని రివ్యూ చేయడానికి దీనిని ఉపయోగించండి:
apx memory reviewer
ఒక నోట్ను జోడించడానికి, ఒక లైన్ యాడ్ చేయండి:
apx memory reviewer --append "Prefers short PR summaries"
మోడల్స్కు రా (raw) కాంటెక్స్ట్ను అందించకండి. మెమరీ ద్వారా స్థిరమైన (stable) కాంటెక్స్ట్ను ఉపయోగించండి.
మెమరీ మీకు ఏమి నిజం కావాలి అని చెబితే, మెసేజ్లు ఏమి జరిగిందో చెబుతాయి. సిస్టమ్ను ఆడిట్ చేయడానికి దీనిని ఉపయోగించండి:
apx messages tail --channel runtime -n 20
ఈ మూడు విషయాలను వేరుగా ఉంచండి:
- memory.md: డ్యూరబుల్ ఫ్యాక్ట్స్ కోసం.
- messages: ఇటీవలి కార్యకలాపాల (recent activity) కోసం.
- sessions: ఇన్వోకేషన్ హిస్టరీ (invocation history) కోసం.
ఒకే ఫైల్ మూడు పనులు చేయకూడదు. APC ప్రాజెక్ట్ను నిర్వచిస్తుంది. APX ఈరోజు ఏమి జరిగిందో నిర్వచిస్తుంది.
సరైన దిశలో ఉండటానికి ఈ క్రమాన్ని ఉపయోగించండి:
apx project list
apx memory reviewer
apx messages tail -n 20
CLI ఒక అలవాటుగా ఉంటేనే బాగా పనిచేస్తుంది. పోర్టబుల్ కాంటెక్స్ట్ కోసం రిపోను ఉపయోగించండి. రన్టైమ్ స్టేట్ కోసం మెషీన్ను ఉపయోగించండి. ప్రతిరోజూ సరిహద్దును (boundary) తనిఖీ చేయడానికి CLIని ఉపయోగించండి.
Source: https://dev.to/agentprojectcontext/the-apx-cli-is-a-daily-loop-not-a-dashboard-1o98
Optional learning community: https://t.me/GyaanSetuAi