RSIAgent troubleshooting
Distinguish build, data, authentication, host integration and benefit-validation failures.
Common problems
| Symptom | Check |
|---|---|
| Build failure | Pinned toolchain, native dependencies and the complete error |
No prompt after mcp starts | It is a stdio service waiting for a host |
| Busy port or locked data | Another process using the listener or data directory |
| Sensitive HTTP call returns 503 | Server role credentials and startup admission |
| Management call fails | Client token, registered identity and operation role |
Rejected --shared or --auth-token | Neither is supported by the current CLI |
| Prepare succeeds without changing work | Whether the host attaches and uses the skills |
| Proposal stays inactive | Evaluation, approval and canary state |
| Restored data cannot start | Trusted revocation data and recovery admission |
Report an issue
Record version/commit, platform, non-secret startup arguments, time, error and a minimal reproduction. Do not upload tokens, private databases or unredacted task material. Consult the repository and its public ledger.
A connected host is not proof of benefit. Inspect actual attachment, execution and evaluation before reinstalling.