Help & Feedback

PandaOS includes a built-in Support dialog with searchable documentation and a feedback system that creates GitHub issues directly from the app.

Opening the Support Dialog

• Click the Support button in the Workspace Dock (bottom right)
• The Support dialog opens with two tabs: Help and Feedback

---

Help Tab

The Help tab provides in-app documentation search so you can find answers without leaving PandaOS.

Searching

1. Type your query in the search field (e.g., "keyboard shortcuts", "MCP servers", "browser preview")
2. Results appear instantly, ranked by relevance
3. Click any result to open the full documentation page in your browser

Search matches against:

• Page titles (highest priority)
• Section headings (medium priority)
• Page content (lower priority)

Each result shows the page title, the section it belongs to (Getting Started, Features, Configuration, Advanced), and the matched heading if applicable.

Quick Links

When no search query is entered, the Help tab shows Popular Topics, quick links to commonly used documentation pages:

• Installation
• Adding a Project
• Chat
• Keyboard Shortcuts
• MCP Servers
• Troubleshooting

A "Browse full documentation" link at the bottom opens the complete documentation site.

---

Feedback Tab

The Feedback tab lets you submit bug reports and feature requests as GitHub issues.

Authentication

Feedback submission requires GitHub authentication (same as the clone feature):

1. Click "Sign in with GitHub"
2. A device code appears and is copied to your clipboard
3. Click "Open GitHub" to authorize
4. PandaOS detects authorization automatically

You only need to authenticate once, the token persists.

Submitting Feedback

Feedback Type, choose between:

• Bug Report, something isn't working as expected
• Feature Request, an idea for improvement

Required Fields:

• Title, A brief summary (max 256 characters)
• Description, detailed explanation of the bug or feature

AI Text Refinement

Click the "Refine" button (sparkle icon) to have PandaOS improve your feedback text:

• Formats the description with proper Markdown
• Adds structure and clarity
• Uses PandaOS Haiku for fast, lightweight refinement
• The refined text replaces your original, review before submitting

System Information

A collapsible "System information" section is automatically attached to every submission:

• App version
• Electron version
• Node.js version
• Operating system and architecture

This helps with debugging and is included as a collapsible section in the GitHub issue.

What Happens

When you click Submit:

1. A GitHub issue is created with your feedback
2. The issue is labeled as "bug" or "feature request"
3. A toast notification shows the issue number with a "View" link to open it on GitHub

Tips

• Be specific about steps to reproduce for bug reports
• Include what you expected vs. what actually happened
• The AI refinement feature works best when you give it a rough draft to improve