FAQ
Frequently asked questions about Blueberry.
General
What is Blueberry?
Blueberry is a focus-first workspace for builders. It brings your code, terminal, browser, and apps into one window, giving you and Claude full context without the chaos of scattered tabs and windows.
How much does Blueberry cost?
Blueberry is completely free while in beta. Weâll introduce pricing down the road, but for now you can enjoy full access at no cost.
What platforms does Blueberry support?
Blueberry is currently available for Mac only (Apple Silicon). Weâre focused on making the Mac experience exceptional before expanding to other platforms.
Claude Integration
How does Claude integration work?
Claude can see everything in your workspaceâyour code, terminal, browser, and pinned appsâwith the Blueberry MCP. This gives it full context to help you build. No more copying and pasting screenshots or explaining what youâre looking at.
Do I need a Claude subscription?
Yes, you need access to Claude Code, which requires a Claude subscription. Blueberry itself is free.
What can Claude do with Blueberry?
Claude can:
- See your open files and code
- Read terminal output
- View your preview browser content
- Open files and navigate to specific lines
- Run terminal commands
- Take screenshots of your preview
Features
What are pinned apps?
Pinned apps let you keep your essential tools like PostHog, Vercel, Supabase, Gmail, etc. right in your workspace. Switch between them with Ctrl+number. No more hunting through browser tabs.
Whatâs Flow Mode?
Flow Mode removes all distractions with a single keystroke. Just you, your work, and ambient music to keep you in flow. Your attention, protected.
Does Blueberry support music?
Yes. Blueberry has Spotify and Apple Music plugins, so you can control your music without leaving your workspace. One less app to manage.
Technical
Is Blueberry an IDE or a text editor?
Blueberry is a workspace that includes a code editor, but itâs designed as a complete environment rather than just an editor. It combines editing, terminal, browser preview, and app access in one window.
What editor does Blueberry use?
Blueberry has a powerful built-in code editor with syntax highlighting for 30+ languages, LSP integration, and all the editing features youâd expect.
Can I use my VS Code extensions?
Not directly. Blueberry has its own built-in features rather than using VS Codeâs extension system. Many common extension features (Git integration, language support, etc.) are built in.
Does Blueberry work offline?
Core features (editing, terminal, file browsing) work offline. Features that require network access (preview of web apps, pinned apps, Claude integration) need a connection.
Troubleshooting
Why canât I open Blueberry?
macOS may block apps from unidentified developers. Right-click the app and select âOpenâ to bypass this.
Why is my terminal slow?
Check if you have heavy processes running. Close unused terminal tabs and try clearing the terminal buffer with Cmd+K.
Why isnât Claude seeing my workspace?
Make sure youâre running Claude from a terminal tab inside Blueberry, not from a separate Terminal app.
Getting Help
How do I get help or give feedback?
Join our Slack community to chat with other builders and the Blueberry team. Weâd love to hear what youâre building and how we can make Blueberry better for you.
How do I report a bug?
Post in our Slack community or reach out directly. Include:
- What you were trying to do
- What happened instead
- Your macOS version
- Blueberry version (from the menu bar)