Bloom Docs
Settings and shortcuts
Configure how projects start and learn the fastest ways to move around Bloom.
Project settings
Bloom reads TOML settings files, layering them in this order, with later files winning. It reads Conductor's files too, so a project already set up for Conductor works with no changes.
~/.conductor/settings.toml
~/.bloom/settings.toml
<project>/.conductor/settings.toml
<project>/.bloom/settings.toml
<project>/.conductor/settings.local.toml
<project>/.bloom/settings.local.tomlThe keys it understands:
| Key | What it does |
|---|---|
scripts.setup | Runs once in a new worktree, before the agent starts. |
scripts.run | Your dev server. A string, or a table of named scripts each with a command. |
scripts.archive | Runs before a worktree is removed. |
scripts.run_mode | How run scripts are started. |
files_to_copy | Globs copied from the main checkout into each new worktree. Defaults to .env*. |
git.branch_prefix | What every branch name starts with. |
git.branch_prefix_type | How that prefix is built. |
git.delete_branch_on_archive | Whether archiving also deletes the branch. |
models.default | The model a new session starts on. |
All of this is also editable in the window: ⌘⇧, opens the settings for the current project.
Keyboard shortcuts
| Shortcut | Does |
|---|---|
| ⌘N | New workspace |
| ⌘T | New session in this workspace |
| ⌘W | Close session |
| ⌘⇧O | Add a project folder |
| ⌘F | Find a workspace |
| ↩ or ⌘↩ | Send what is in the composer |
| ⇧↩ | A new line in the composer |
| ⌘. | Stop the agent |
| ⌘⌥↓ / ⌘⌥↑ | Next and previous workspace |
| ⌘⇧U | Next unread workspace |
| ⌘⇧H | Go to Home |
| ⌘⌃S | Toggle the sidebar |
| ⌘⌥I | Toggle the inspector |
| ⌘⇧T | New terminal tab |
| ⌘⇧B | New browser tab |
| ⌘⇧D | Show the changes, and go back again |
| ⌘⇧N | Show the notes |
| ⌘\ / ⌘⇧\ | Split the pane right, or down |
| ⌘⌃W | Close the pane |
| ⌘⇧[ / ⌘⇧] | Previous and next tab |
| ⌘⌥J / ⌘⌥K | Next and previous changed file |
| ⌘E | Switch between the diff and the editor |
| ⌘S | Save the file you are editing |
| ⌘⇧E | Open the worktree in your editor |
| ⌘⇧R | Reveal the worktree in Finder |
| ⌘⇧C | Copy the branch name |
| ⌘⌫ | Archive the workspace |
| ⌘⇧, | Settings for this project |
| ⌘+ / ⌘- / ⌘0 | Zoom the text in, out, back to normal |
Deep links and Services
Bloom answers a URL scheme, with the same shape as Conductor's, so scripts written for one work with the other:
open "bloom://prompt=<urlencoded prompt>&path=<urlencoded project root>"Bloom also installs a Services item, so you can select text anywhere on the system and send it straight into a workspace, and four Shortcuts actions: start a workspace, open one, list them, and read one's status.