Use the actual agents directory name
Graph and trajectory commands use the directory identifier. On the course agent it is the UUID, but other agents may use a display name.
Get-ChildItem "$env:USERPROFILE\.armaraos\agents" -Directory
find "$HOME/.armaraos/agents" -mindepth 1 -maxdepth 1 -type d
Put the engine before graph work
Graph memory and trajectories need the runtime layer. An off agent has nothing new to accumulate.
Do not overclaim the switch
Enable means enable the AINL runtime engine. The help makes no promise of deterministic or scripted behavior.
Enable a disposable agent
armaraos agent enable-runtime-engine <AGENT_UUID>
armaraos agent list --json
Find the directory identifier
Read the actual directory list rather than guessing from the friendly name. Record the exact directory name for the next modules.
Prove graph inspection returns cleanly
armaraos memory graph-inspect <AGENT_DIRECTORY_ID> --json
Read empty as initial state
An empty entries array means no scoped semantic facts exist yet. It is not an enable failure.
Keep the reversible control
armaraos agent disable-runtime-engine <AGENT_UUID>
Do not disable yet. Modules 5.3 through 5.6 use the enabled agent.
Check it / prove both layers
Read effective true and a clean graph response.
Entries may be empty. The command must return OK against the actual directory identifier.
The runtime engine can accumulate operational knowledge and trajectories. Use a disposable or reviewed agent first, and read complete graph output before sharing it.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| Configured true, effective false | Environment or compiled state differs. | Read all flags and doctor. |
| No such agent | Directory ID differs from display name. | Inspect the agents folder. |
| Entries is empty | No graph facts exist. | Continue to 5.3. |
| Tempted to disable | The toggle is reversible. | Leave it enabled through 5.6. |