Common Problems

Start with the symptom, not with guesswork. Most Gestura issues fall into a small set of categories: installation, microphone, provider configuration, MCP connectivity, permissions, or workflow state.

If Gestura is not hearing you

• Verify microphone permissions.
• Test the selected device.
• Reduce background noise or adjust sensitivity.
• Use gestura-app --test-audio if available.

If a workflow seems stuck

• Check for a hidden approval prompt.
• Confirm the current permission level matches the task.
• Retry with a smaller, clearer request.
• Use Workflow Recovery if the session has drifted.

If tools or MCP servers are failing

• Run gestura mcp status.
• Validate your config with gestura config check.
• Confirm the server command and environment are still valid.

If installation or app health is the issue

• Re-run the installation verification steps.
• Use gestura-app --health when available.
• Review the platform-specific notes in Installation.