FAQ

This chapter helps you solve various problems encountered while using Plannotator. Whether it's port conflicts, browser not opening, or integration failures, there are corresponding solutions and debugging techniques here.

Chapter Contents

🔧 Common Problems

Solve common problems encountered during use, including port conflicts, browser not opening, plans not displaying, Git errors, image upload failures, Obsidian/Bear integration issues, etc.

🔍 Troubleshooting

Master basic troubleshooting methods, including log viewing, error handling, and debugging techniques. Learn to quickly identify the source of problems through log output.

Learning Path

Common Problems → Troubleshooting
      ↓            ↓
  Quick Fix    Deep Debug

Recommended Sequence:

1. First check Common Problems: Most problems can find ready-made solutions here
2. Then learn Troubleshooting: If common problems don't cover your issue, learn how to troubleshoot through logs and debugging techniques

Suggestions when encountering problems

First search for keywords in "Common Problems" (such as "port", "browser", "Obsidian") to find corresponding solutions. If the problem is complex or not in the list, refer to "Troubleshooting" to learn debugging methods.

Prerequisites

Before studying this chapter, it's recommended that you have completed:

• ✅ Quick Start - Understand basic concepts of Plannotator
• ✅ Installed Claude Code or OpenCode plugin (choose one):
  • Install Claude Code Plugin
  • Install OpenCode Plugin

Next Steps

After completing this chapter, you can continue learning:

• API Reference - Understand all API endpoints and request/response formats
• Data Models - Understand data structures used by Plannotator
• Environment Variables - Deep dive into all available environment variables