Start with the roster, not a guess
A UUID is safe to display but easy to mislabel. Copy the friendly name beside it.
$env:USERPROFILE\.armaraos\agents.$HOME/.armaraos/agents.Treat no such agent as an identifier clue
The agent probably exists. The command may want a different kind of identifier.
Version 0.8.3 is inconsistent about this. The card below is the entire workaround, and later courses reprint it where the distinction matters.
Read the corrected identifier card
| Identifier | Commands that use it |
|---|---|
| Friendly name or UUID | chat, KV memory, cron create, webhooks create, mission agent selection, runtime-engine toggles |
| UUID | message in the live build, agent chat, agent kill, agent set, trigger create, orchestration quota |
| Agent directory name | Every trajectory command and every graph-memory command |
message help says name or ID, but the name path fails. The optional sessions agent filter is ignored, so it is not placed on the card as a working filter.
Copy a UUID from JSON
armaraos agent list --json
Copy the id and label it with the matching name. The workspace path is separate and does not replace either value.
Look at the directory names once
Get-ChildItem "$env:USERPROFILE\.armaraos\agents" -Directoryls -1 "$HOME/.armaraos/agents"
The live tree contains UUID folders and one called Email Drafter. For trajectory and graph-memory commands, use whatever the actual folder is called.
Open the UUID-only chat twin
armaraos agent chat <UUID>The next state-changing command that genuinely needs this UUID is armaraos agent set in Module 2.2.
Check it / run this yourself
Leave with a labeled UUID.
armaraos agent list --jsonCopy one id, write its friendly name beside it, and name all three identifier categories without looking at the card.
Identifiers are not provider credentials, but commands such as kill and set act on real agents. Match the UUID to its friendly name before any state-changing command.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| Message rejects a friendly name | Verified API mismatch. | Use the UUID from the JSON roster. |
| A trajectory command finds nothing | The identifier does not match the folder. | List the agents directory and use its exact name. |
| Sessions still shows all agents | The optional filter is ignored. | Match agent_id manually. |
| The UUID has no clear owner | It was copied without a label. | Return to the roster and store the friendly name beside it. |