This page is out of date, and might use pre-V1 features, if you experience any
issues, please read the V1 migration
guide
for guidance.
Show Server Doesn’t Start
Show Server Doesn’t Start
Issue: Gradle shows “83%” and appears to hang.
- ✅ This is normal. The server is running in the background.
- 🔍 Confirm by checking for logs in the terminal.
- 🔧 Change the port using
-sse-server <port>or stop any processes using that port.
Show Agent Not Responding
Show Agent Not Responding
Issue: Agent doesn’t respond after being mentioned in a thread.
- ✅ Ensure the agent was registered with the correct ID.
- ✅ Make sure the agent is actively running and listening via
wait_for_mentions. - 🔍 Confirm the message payload includes the correct thread and mention.
Show Messages Not Delivered
Show Messages Not Delivered
Issue: Messages do not appear in the thread log.
- ✅ Ensure the thread ID is valid and was created.
- ✅ Verify the sender and mentioned agents are listed as participants.
Show Agent Registration Fails
Show Agent Registration Fails
Issue:
register_agent returns an error.- ✅ Check your JSON payload for proper structure.
- ✅ Confirm that the Coral Server is running and accepting requests.
Show CLI Issues
Show CLI Issues
Issue:
coralizer command not found.- ✅ Confirm the CLI is installed:
pip install coralizer-cli - 🔧 Check your
PATHenvironment variable and Python installation.
- ✅ Make sure the
-serverURL is correct and the Coral Server is running.
Show Agent Lifecycle Issues
Show Agent Lifecycle Issues
Issue: Agent state not resetting between runs.
- 🔁 Restart the Coral Server to clear previous agent states.
- 🛑 Coral agents are limited to 20 iterations in test setups to prevent API overuse. Restart agents if needed.