FAQ
Installation
Q: I installed the extension but can't find @cooder?
Make sure GitHub Copilot is installed and enabled. Cooder relies on Copilot Chat for its command interface. Search for "GitHub Copilot" in the VS Code Extensions panel and confirm its status is "Enabled".
Q: I see "GitHub Copilot not authorized"?
Verify your GitHub account has an active GitHub Copilot subscription (or student/open-source free access). Check your authorization status at github.com/settings/copilot.
Q: The extension was installed but nothing happens?
Try restarting VS Code. If the problem persists, file an issue on GitHub Issues and include the error log from the VS Code Output panel.
Connection & Pairing
Q: QR code pairing failed?
Check the following:
- Your device has an internet connection (the Relay server is cloud-hosted)
- The Cooder extension in VS Code shows a "Connected" status
- Your camera can clearly scan the QR code
Note: Both PWA and native clients require camera permission for QR login, device pairing, and payment.
Alternatively, use manual pairing by entering the Relay URL and Token directly.
Q: The app shows my device as offline?
Possible causes: VS Code was closed, network interrupted, or the connection timed out from inactivity. Reopen VS Code and run Cooder: Reconnect to restore the connection.
Q: Can I connect multiple computers?
Yes. Each computer is a separate device in the app. The number of devices you can have connected depends on your plan.
Agent Behavior
Q: The Agent stopped mid-task?
Possible causes:
- Waiting for your input (the Agent is pausing for a decision)
- Reached the maximum conversation round limit (default: 20 rounds)
- Network disruption
Check the last log entry in the Cooder app — it usually explains the reason. Send a follow-up instruction to continue, or tap Restart.
Q: The Agent modified files I didn't want changed?
Cooder never auto-commits to Git. Use git diff to review all changes and git checkout to revert anything unwanted. It's good practice to commit your current work before starting a major Agent task.
Q: Can I choose which AI model the Agent uses?
Model selection is controlled by GitHub Copilot. The model currently selected in Copilot Chat is what the Agent uses — switch it in the Copilot panel.
Billing & Account
Q: What are the Free plan limitations?
Free supports 1 device, 1 concurrent Agent, and unlimited usage. Conversation history is stored locally only (no cloud sync).
Q: How do I check my current plan?
In the Cooder app, tap your avatar in the bottom-left corner to view your account plan and quota usage.
Q: Can I get a refund?
Pricing is being finalized. Refund policy will be clearly stated on the purchase page when subscriptions launch.
Q: How do I delete my account?
Go to Settings → Account in the app to request account deletion. All data is permanently removed within 30 days.
More Help
If none of the above resolves your issue:
- GitHub Issues — report bugs or suggest features
- Email support: rainfu@outlook.com
- In-app feedback — Settings → About → Send Feedback (requires verified email)
