Docs

Getting started

Install bigbud on your machine, set up your AI providers, launch the app, and start your first session. No terminal needed — everything works from the app.

1. Download and install

bigbud runs on macOS, Windows, and Linux.

Download the latest version — The installer will walk you through setup in a few clicks.

2. Set up your AI providers

bigbud works with the AI providers you already use. If you don't have an account yet, download and sign up for one or more of these providers:

• Claude — Download the desktop app, sign in, and subscribe if needed
• Codex — Install the CLI and sign in with your account
• GitHub Copilot — Install the extension and sign in with your GitHub account
• OpenCode — Install the CLI and authenticate

Once you have your provider accounts ready:

1. Open bigbud — it will automatically detect installed providers on your machine
2. bigbud performs a handshake with each provider, verifying your subscription
3. Your available models from each provider appear in the provider picker

You can connect multiple providers and switch between them as needed. bigbud shows you which models are available from each subscription, so you always know what you have access to.

3. Launch the app

Open bigbud from your applications folder (or start menu on Windows). You'll see your workspace — a clean window with a sidebar on the left, the main area in the center, and tools on the right.

4. Start a thread

Press Cmd + N (macOS) or Ctrl + N (Windows/Linux) to start a new thread. Type your question or task in the input at the bottom and press enter. bigbud will respond using your connected provider.

You can switch providers mid-thread using the provider picker at the top of the input area. Threads are organized in the sidebar — rename them, switch between them, or archive them as you go.

5. Explore your workspace

bigbud brings everything into one window. Here are the key areas to know:

Left side panel — your navigation hub. Browse your Projects, jump back into recent Chats, trigger Automations, and pin Favorite threads for quick access.

Chat — the main area where you talk to your AI providers. Type a question, paste code, or describe what you need. The provider responds inline, and the conversation stays in the thread.

Right side panel — Use the right panel to view and work with your own files, write notes, browse the web, and more without leaving your chat. Press Cmd + T (macOS) or Ctrl + T (Windows/Linux) to open the panel switcher and choose from:

• Files — Browse and open project files
• Notes — Write markdown notes
• Browser — Open a website alongside your workspace
• Terminal — Start an interactive shell
• Diff — View code changes side by side
• Kanban — Track work across columns
• Git — Inspect repo changes

Search — Find anything fast:

• Cmd + F / Ctrl + F — Search across your threads
• Cmd + P / Ctrl + P — Search files, folders, and commands

6. Keyboard shortcuts

7. Next steps

• Read the changelog — see what's new in each release
• Join the community — share feedback, ideas, and feature requests

Using bigbud

Writing notes like a Pro

Using bigbud's Kanban board