Blueberry Documentation

Welcome to the Blueberry documentation. Blueberry is a focus-first desktop IDE for AI-native builders.

What is Blueberry?

Blueberry brings your code, terminal, browser, and apps into one window, giving you and your AI full context without the chaos of scattered tabs and windows.

Workspace

• Terminal - Multi-tab terminal with session persistence
• Code Editor - Full-featured editor with LSP, git gutter, and syntax highlighting
• Canvas - Whiteboard with AI agent integration
• Source Control - Git integration with staging and diff viewer
• Preview Browser - Built-in browser with DevTools and device modes

Context

• Blueberry MCP - Give your AI full context over your workspace
• Pinned Apps - Keep essential apps ready per project
• Screenshot & Element Select - Visual context for your AI

Models

• Claude Code - Anthropic’s AI coding agent
• Codex - OpenAI’s coding agent
• Gemini CLI - Google’s AI coding tool

App Mode

• Startup Config - Define how your project launches with .blueberry/startup.json
• Add to Desktop - Turn any project into a standalone desktop app

Workflow

• Command Bar - Quick access to actions via Cmd+P
• Worktrees - Work on multiple branches simultaneously
• Saved Setups - Per-project workspace configurations
• Remote Access - Use Blueberry from any device

Focus

• Flow Mode - Distraction-free deep work
• Layouts - Hyprland-inspired tiling layouts
• Music - Built-in ambient music
• Themes - 8 wallpaper themes

Getting Help

Join our Slack community  for support and feedback.