toast README

The project's README from github.com/paradise-runner/toast. As one markdown file: README.md.

prek

toast

toast is a beautiful developer environment right in your terminal. vim, nvim, and emacs have you build your editor from scratch, while toast ships with managed LSPs, an integrated file tree, multiple file tabs, and themes out of the box. toast is for the developer who wants to stay in their terminal without spending hours getting it up to snuff.

⚠️ This project is in early development, you may encounter bugs. ⚠️

toast logo

Quick Install

brew install paradise-runner/tap/toast

Features

Editor No AI features No telemetry Built-in file tree Mouse support
toast ✅ ✅ ✅ ✅
vim ✅ ✅ ❌ ❌
emacs ✅ ✅ ❌ ❌
vscode ❌ ❌ ✅ ✅
zed ❌ ❌ ✅ ✅

Installation

Homebrew (macOS)

brew install paradise-runner/tap/toast

Download a release

Grab a zip for your platform from the releases page, unzip it, and place the binary on your $PATH:

# example for Apple Silicon
curl -Lo toast.zip https://github.com/paradise-runner/toast/releases/latest/download/toast-darwin-arm64.zip
unzip toast.zip
install -m755 toast-darwin-arm64 /usr/local/bin/toast

Standalone macOS app

⚠️ Experimental: this bundles toast inside a libghostty terminal window and has more bugs than the terminal version. The TUI — Homebrew or the release binary above — is the primary, best-tested way to run toast.

Prefer a native app over the terminal? Each release also ships Toast.app — a complete desktop app with its own terminal window (libghostty), native menu bar, and dock icon. No terminal, Homebrew, or Go required.

  1. Grab the zip for your Mac from the releases page: toast-app-darwin-arm64.zip for Apple Silicon (M1/M2/M3/M4), toast-app-darwin-amd64.zip for Intel.
  2. Unzip it and drag Toast.app into your Applications folder.
curl -LO https://github.com/paradise-runner/toast/releases/latest/download/toast-app-darwin-arm64.zip
unzip toast-app-darwin-arm64.zip
mv Toast.app /Applications/

First launch: the app is not code-signed or notarized yet, so macOS Gatekeeper will block a plain double-click. Right-click Toast.app in Finder and choose Open, then Open again — it launches fine from then on. Or clear the quarantine flag once: xattr -dr com.apple.quarantine /Applications/Toast.app

open -a Toast ~/src/foo.go
open -a Toast ~/src/myproject

Build from source

Requires Go 1.25.2+.

git clone https://github.com/paradise-runner/toast
cd toast
make build
# binary written to bin/toast

Usage

toast               # open current directory
toast path/to/dir   # open a specific directory
toast path/to/file  # open a file (auto-detects git root)
toast new/file.go   # open a new file buffer if the parent directory exists
toast --help
toast --version

Keybindings

All keybindings can be remapped in ~/.config/toast/config.json (see Configuration).

Key Action
Ctrl+Q Quit
Ctrl+S / Cmd+S Save
Ctrl+W / Cmd+W Close tab
Ctrl+P Quick-open file search (fuzzy)
Ctrl+Shift+P / Cmd+Shift+P Command palette
Ctrl+Alt+Right Next tab
Ctrl+Alt+Left Previous tab
Ctrl+B Toggle sidebar
Ctrl+Shift+E Toggle focus between editor and file tree
Ctrl+Shift+F Search
Ctrl+F / Cmd+F Find and replace in the current file
Ctrl+G / Cmd+L Go to line
Ctrl+Shift+M Toggle Markdown preview
Ctrl+Z / Cmd+Z Undo
Ctrl+Y / Ctrl+Shift+Z / Cmd+Y / Cmd+Shift+Z Redo
Ctrl+Space / Cmd+Space Trigger completion
Ctrl+Shift+K Show hover
Ctrl+hover / Ctrl-click Check for and follow a definition
F12 Go to the definition at the cursor

Configuration

Toast reads ~/.config/toast/config.json on startup. Missing keys fall back to defaults.

{
  "theme": "toast-dark",
  "editor": {
    "tab_width": 4,
    "auto_indent": true,
    "trim_trailing_whitespace_on_save": true,
    "insert_final_newline_on_save": true,
    "auto_save": "auto",
    "auto_save_delay_ms": 300,
    "bottom_padding": 3
  },
  "sidebar": {
    "visible": true,
    "width": 30,
    "confirm_delete": true,
    "file_icons": {
      "enabled": true,
      "color_mode": "accent"
    }
  },
  "ignored_patterns": [".git", "node_modules", "__pycache__", ".DS_Store"]
}

auto_save selects the save mode: "auto" (default) writes dirty buffers to disk after auto_save_delay_ms milliseconds of inactivity, while "manual" requires an explicit save (ctrl+s / super+s).

Keybindings

All default keybindings can be overridden with the keybindings object. Each action accepts a list of key strings (supports ctrl, alt, shift, super modifiers). An empty list unbinds the action.

{
  "keybindings": {
    "save": ["ctrl+s"],
    "quick_open": ["ctrl+o"],
    "next_tab": ["ctrl+tab"],
    "prev_tab": ["ctrl+shift+tab"],
    "quit": []
  }
}

Available actions: quit, toggle_sidebar, save, new_file, close_tab, undo, redo, next_tab, prev_tab, search, find_replace, quick_open, command_palette, theme_picker, go_to_line, go_to_definition, toggle_focus, markdown_preview, show_hover, trigger_completion.

Omit lsp to use Toast's managed defaults for Go, Rust, Python, JavaScript, TypeScript, and Markdown; set "lsp": {} to disable all language servers. 

{
  "lsp": {
    "zig": {
      "command": "zls",
      "args": [],
      "extensions": [".zig"]
    }
  }
}

Themes

Built-in themes: system, toast-dark, toast-light. Custom themes live in ~/.config/toast/themes/.

Import a VSCode theme:

toast migrate-theme vscode path/to/theme.json
# writes ~/.config/toast/themes/<theme-name>.json

Then set "theme": "<theme-name>" in your config.

Feedback & Issues

Found a bug or have a feature request? We'd love to hear from you! Please open an issue on GitHub with as much detail as possible. Your feedback helps make Toast better.

Development

make build             # compile
make run               # go run ./cmd/toast .
make test              # go test ./...
make test-integration  # run opt-in Ghostty/tmux terminal integration tests
make test-integration-update  # refresh golden screenshots

toast (paradise-runner/toast)

Searching Database…

278 ·GitHub
Toast
Что это такое?Toast — это IDE «всё в одном», которая работает прямо в терминале и написана на Go: из коробки есть управление серверами языков, встроенное дерево файлов, несколько вкладок с файлами и темы оформления.
Чем это отличается от обычного vim или emacs?В отличие от vim, nvim или emacs, где редактор собирается вручную через конфиги, Toast — это один бинарник, который работает сразу, и он рассчитан на разработчиков, которые не хотят тратить часы на настройку перед написанием кода.
Как его запустить?На macOS установите через Homebrew, либо скачайте zip-архив для своей платформы со страницы релизов, распакуйте его и положите бинарник в директорию из $PATH. Сборка из исходников требует Go 1.25.2+.
Мне нужно самому предварительно ставить серверы языков или ripgrep?Настраивать LSP вручную не нужно: Toast сам предлагает доустановить недостающие серверы для Go, Rust, Python, JavaScript, TypeScript и Markdown, а для других языков есть расширяемый конфиг. Поиск по всему проекту работает на ripgrep.
Он достаточно стабилен для повседневной работы?Стоит ожидать багов — проект ещё на ранней стадии разработки. Терминальная версия — основной и лучше всего протестированный способ запуска Toast; встроенное приложение для macOS экспериментальное и работает с бо́льшим количеством багов.
Он запустится на Linux и Windows или только на macOS?Терминальная версия кроссплатформенная — релизы поставляются отдельным zip-архивом для каждой платформы. На macOS дополнительно доступны Homebrew и отдельное приложение Toast.app, которое собирается отдельно для Apple Silicon и Intel.
Там есть функции с ИИ или телеметрия, которая отправляет данные наружу?Ни того, ни другого — в сравнительной таблице README у Toast стоят галочки «Нет ИИ-функций» и «Нет телеметрии», в отличие от vscode и zed.
Для каких языков есть подсветка синтаксиса и умные подсказки от сервера языков?Подсветка синтаксиса на Tree-sitter охватывает Go, Python, JavaScript, TypeScript, Rust, CSS, HTML, YAML, Bash и Markdown. Управляемые серверы языков (устанавливаются по запросу) покрывают Go, Rust, Python, JavaScript, TypeScript и Markdown через harper, а другие языки можно добавить через конфиг.
Я не хочу жить в терминале — есть настольное приложение?Да: в релизах для macOS идёт Toast.app, который запускает toast внутри собственного окна терминала libghostty с нативной строкой меню и иконкой в доке — терминал, Homebrew и Go не нужны. Приложение пока не подписано кодовой подписью, поэтому при первом запуске нужно открыть его через правый клик и «Открыть» в Finder или снять флаг карантина с помощью xattr.
Насколько это можно настраивать — горячие клавиши, темы, автосохранение?Довольно сильно, и всё через ~/.config/toast/config.json: любую горячую клавишу по умолчанию можно переопределить, автосохранение переключается между автоматическим режимом (по умолчанию запись через 300 мс бездействия) и ручным сохранением, а среди тем есть system, toast-dark и toast-light, плюс импортёр тем из VSCode и поддержка собственных файлов тем.
Как ориентироваться в кодовой базе в Toast?Ctrl+P открывает файлы с нечётким поиском, Ctrl+Shift+F запускает поиск по всему проекту через ripgrep, а Ctrl+F делает поиск и замену внутри файла с опциями учёта регистра и поиска по целым словам. Для навигации зажмите Ctrl и наведите курсор на символ, чтобы он подчеркнулся, затем Ctrl+клик (или F12) — и вы перейдёте к его определению.
What are similar projects?gitlogue, telescope.nvim, helix, micro, NvChad, awesome-neovim, atom, monaco-editor
Which topics is it in?terminal-app, terminal-ui, fuzzy-search, autocomplete, tree-sitter, code-editor, lsp, text-editor, syntax-highlighting, themes, ide, homebrew
Creator
paradise-runner
Size
10.5 MB
Stars
278
Updated
CommitOct 17Releasev0.12.0Oct 17
Age
6mo
Commits · 90 Days