Troubleshooting

काहीतरी काम नसेल तेव्हा येथे सुरू करा. Steps क्रमाने follow करा.

पहिले Steps

1. Daemon running आहे का check करा

triggerfish status

Daemon running नसल्यास, start करा:

triggerfish start

2. Logs check करा

triggerfish logs

हे real time मध्ये log file tail करतो. Noise cut करण्यासाठी level filter वापरा:

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

3. Diagnostics run करा

triggerfish patrol

Patrol gateway reachable आहे का, LLM provider respond करतो का, channels connected आहेत का, policy rules loaded आहेत का, आणि skills discovered आहेत का ते check करतो. CRITICAL किंवा WARNING marked कोणताही check तुम्हाला कोठे focus करायचे ते सांगतो.

4. Config validate करा

triggerfish config validate

हे triggerfish.yaml parse करतो, required fields check करतो, classification levels validate करतो, आणि secret references resolve करतो.

Area नुसार Troubleshooting

वरील first steps तुम्हाला problem कडे point नाही केल्यास, तुमच्या symptoms शी match होणारा area निवडा:

• Installation - install script failures, source मधून build issues, platform problems
• Daemon - service start होणार नाही, port conflicts, "already running" errors
• Configuration - YAML parse errors, missing fields, secret resolution failures
• Channels - bot respond करत नाही, auth failures, message delivery issues
• LLM Providers - API errors, model not found, streaming failures
• Integrations - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP servers
• Browser Automation - Chrome सापडत नाही, launch failures, navigation blocked
• Security & Classification - write-down blocks, taint issues, SSRF, policy denials
• Secrets & Credentials - keychain errors, encrypted file store, permission problems

अजूनही Stuck?

वरील guides पैकी कोणत्याही guide ने तुमची issue resolve नाही केल्यास:

1. Log bundle collect करा
2. Filing issues guide वाचा
3. GitHub वर issue open करा