Troubleshooting

Start here when something is not working. Follow the steps in order.

First Steps

1. Check if the daemon is running

bash

triggerfish status

If the daemon is not running, start it:

bash

triggerfish start

2. Check the logs

bash

triggerfish logs

This tails the log file in real time. Use a level filter to cut through the noise:

bash

triggerfish logs --level ERROR
triggerfish logs --level WARN

3. Run diagnostics

bash

triggerfish patrol

Patrol checks whether the gateway is reachable, the LLM provider responds, channels are connected, policy rules are loaded, and skills are discovered. Any check marked CRITICAL or WARNING tells you where to focus.

4. Validate your config

bash

triggerfish config validate

This parses triggerfish.yaml, checks required fields, validates classification levels, and resolves secret references.