# Blueberry Documentation

> 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.

For complete documentation in a single file, see: /llms-full.txt

## Overview

Blueberry is a macOS desktop application (Apple Silicon only) that provides:
- Code editor with LSP support
- Integrated terminal with session persistence
- Built-in browser for previewing web apps
- Pinned apps for quick access to tools like PostHog, Vercel, Supabase
- Native Claude Code integration via MCP (Model Context Protocol)
- Flow Mode for distraction-free work
- Music integration (Spotify, Apple Music)

## Documentation Structure

/docs - Documentation home
/docs/getting-started/installation - Download and install Blueberry
/docs/getting-started/quick-tour - 5-minute introduction to Blueberry
/docs/getting-started/claude-setup - Set up Claude Code with Blueberry MCP
/docs/features/code-editor - Code editor with syntax highlighting and LSP
/docs/features/terminal - Multi-tab terminal with persistence
/docs/features/preview-browser - Built-in browser with DevTools
/docs/features/source-control - Git integration with visual diffs
/docs/features/pinned-apps - Keep essential tools accessible
/docs/features/remote-access - Access Blueberry from other devices
/docs/features/flow-mode - Distraction-free mode
/docs/features/music - Spotify and Apple Music integration
/docs/claude-integration/overview - How Claude sees your workspace
/docs/claude-integration/mcp-tools - Available MCP tools reference
/docs/claude-integration/best-practices - Tips for effective prompting
/docs/customization/themes - 8 wallpaper themes
/docs/customization/layouts - Panel arrangement options
/docs/customization/settings - All configurable options
/docs/reference/keyboard-shortcuts - Complete keyboard shortcuts list
/docs/reference/troubleshooting - Common issues and solutions
/docs/reference/faq - Frequently asked questions
/docs/changelog - Version history and release notes

## Key Concepts

### MCP Integration
Blueberry provides Claude Code with tools to interact with your workspace:
- blueberry_get_context: Get current IDE state (open files, terminal, preview)
- blueberry_open_file: Open files in the editor
- blueberry_open_preview: Open URLs in preview browser
- blueberry_send_terminal_command: Execute terminal commands
- blueberry_create_terminal: Create new terminal tabs
- blueberry_capture_webview_screenshot: Screenshot preview/pinned apps
- blueberry_capture_webview_content: Get page content as text
- blueberry_get_console_logs: Read browser console logs
- blueberry_get_terminal_logs: Read terminal output
- blueberry_open_pinned_app: Show a pinned app panel

### Running Claude in Blueberry
Claude must be started from a Blueberry terminal to access MCP tools:
1. Open a terminal tab in Blueberry
2. Run `claude` from that terminal
3. Claude will automatically have access to Blueberry MCP tools

## Technical Details

- Platform: macOS 12+ (Apple Silicon only)
- Editor: Full-featured code editor with LSP
- Languages: 30+ with syntax highlighting
- File size limit: 2MB for optimal performance
- Terminal: PTY-based with 30-minute session persistence
- Network: Optional remote access for other devices on same network

## Support

- Slack community: https://join.slack.com/t/blueberry-ens6414/shared_invite/zt-3odsq3aet-ItPj32AlGAkFx9_9YgYUnw
- Website: https://meetblueberry.com