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 your AI coding agent 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.
AI Agent Integration
Which AI coding agents does Blueberry support?
Blueberry works with any terminal-based AI coding agent, including Claude Code, Codex, and Gemini CLI. If it runs in a terminal, it works in Blueberry.
How does AI integration work?
Your AI agent can see everything in your workspace through the Blueberry MCP: your code, terminal, browser, and pinned apps. 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 subscription to an AI agent?
You need access to at least one AI coding agent (e.g., Claude Code, Codex, or Gemini CLI), which may require a separate subscription. Blueberry itself is free.
What can AI agents do with Blueberry?
Through the Blueberry MCP, your AI agent 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
- Create and manage App Mode startup configs
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 my AI agent seeing my workspace?
Make sure youâre running your AI agent from a terminal tab inside Blueberry, not from a separate Terminal app. The Blueberry MCP server connects automatically when agents are started from a Blueberry terminal.
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)