Find before you open
Search the complete agents tree for agent.toml. Do not assume the folder named for your running agent contains one.
Get-ChildItem "$env:USERPROFILE\.armaraos\agents" -Filter agent.toml -Recursefind "$HOME/.armaraos/agents" -name agent.toml -type fLocate a manifest that actually exists
Only the Email Drafter directory currently has agent.toml. Other running-agent directories contain runtime stores but no manifest. Open a file that exists, never an imagined path.
Read the declared capabilities twice
The file says profile = "full", then lists empty network, tools, and shell capabilities with agent spawn false. A field is a declaration, not proof of the runtime path.
Runtime evidence is mixed: network and a harmless shell command completed, the outside-workspace read was refused, and the queue stayed empty. Use the observed result for the specific action.
Read the resource gate before delegation
max_subagents and max_spawn_depth are zero. The cost fields read 0.0 and do not provide proven enforcement. Course 4 changes delegation only after another backup.
Read the execution policy as text
The policy names safe binaries, a timeout, an output limit, and enforced path and process guards. Do not translate mode = "full" into a promise that every path is reachable.
Prepare a copy with two unique fields
Copy the manifest outside the live agents directory before editing.
name = "manifest-roundtrip-test"
workspace = "<your ArmaraOS home>/workspaces/manifest-roundtrip-test"Changing only the name would make two agents share one workspace. Change the name and workspace, then leave all capability and resource lines unchanged.
Spawn, confirm, and kill the copy
armaraos agent spawn <MANIFEST_COPY>
armaraos agent listarmaraos agent kill <NEW_UUID>
Kill ends the running row but leaves its stored directory and workspace. This is a runtime round trip, not data deletion.
Name the missing command levers
The manifest copy is the CLI-side lever for declared capability changes.
There is no top-level tools command, no agent profile command, and live help documents only model for agent set.
Check it / complete the round trip
Confirm the copy, then end only the copy.
armaraos agent listSee the unique copied name, kill its new UUID, and confirm the original roster remains. Keep the edited manifest copy outside the live agents directory for Course 4.
Never edit the only live manifest in place. Copy it, change both name and workspace, spawn the copy, verify its row, and remember that kill does not erase stored files.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| The expected path is missing | That running agent has no manifest file. | Search the full agents tree. |
| Spawn reports a name collision | The copy kept the original name. | Give it a unique name and workspace. |
| Two agents share one workspace | Only the name changed. | Kill the copy and prepare a corrected copy. |
| The queue stays empty during a probe | This matches verified CLI behavior. | Use the direct response and refusal as evidence. |