Troubleshooting

The MCP client cannot connect

Confirm that the server URL is https://api.rulith.ai/mcp, OAuth completed in the same client, and the credential has not been revoked. Reconnect from the agent's Connections view instead of copying an old token.

The board has inputs but no conclusion

Read the logic context and check four things:

1. the installed recipe contains the expected vocabulary and rule;
2. predicate names and argument keys match exactly;
3. the rule's required inputs are active in the current case;
4. the rule is safe and stratified.

Do not assert the desired conclusion to make the screen look complete. Fix the missing premise or rule.

An action is not callable

An action becomes callable only when its definition is installed, all arguments bind from supported board facts, its preconditions hold, and Constitution clearance is satisfied. The model should not fill missing action parameters from prose.

The Worker does not receive work

Verify that the Worker credential is active, the implementation name matches the tool contract, the Worker is polling the correct agent or queue, and another instance has not already claimed the request.

If startup reports Connection credential rejected (401), create or rotate the Worker Connection in Console and copy both the channel ID and the one-time key again. The Worker now stops with exit code 3; it does not continue in an apparently online state.

The local timeline does not open

Start the Agent with --ui. It listens on loopback only and prints the exact URL, including its temporary access key. The default port is 7788; set RULITH_UI_PORT if another local process already uses it. Run node rulith-agent.mjs --help to see the current flags before configuring credentials.

A Source package is installed but its Connection is missing

A Source package is a reusable declaration, not a credential or trust root. Installation creates an unbound Source instance. Before that Source can attest data or execute a Tool, create a Worker Connection owned by the same Agent and bind the Source instance to it under Agent → Configuration → Data sources. A package cannot carry or mint a trusted Connection.

An action ran but the case is still pending

Read the structured receipt and the remaining acceptance criteria. A successful external call may still leave a required result unverified, a notification outstanding, or another goal incomplete.

A run stopped without sealing

This is expected when the model reaches its round limit, makes no progress, encounters an unresolved objection, or fails completion gates. The case stays open so another run can continue with the same evidence.

Get help

Include the case ID, visible errorCode, and the smallest relevant evidence chain when contacting support. Do not send credentials or private source payloads.