macOS
Homebrewverified · 100%
brew install esboniolocal Homebrew formula metadata
brew / rank 13856
Install esbonio with Homebrew
Language server for working with Sphinx projects. Version 2.1.0 via Homebrew; verified 2026-07-07.
install
Additional install commands
overview
Package summary
Language server for working with Sphinx projects
Project links
Commands and aliases
- esbonio
history
Project history and usage
Esbonio is a language server for Sphinx documentation projects. It provides editor features such as references, completions, diagnostics, previews, and extension points for documentation tooling.
Project history
The project is hosted in the official swyddfa/esbonio repository and is organized around a Python language server, a VS Code extension, and Sphinx extensions. Its documentation describes Esbonio as tooling that reduces friction when writing Sphinx content.
The 1.0 release in October 2025 changed the server architecture by moving Sphinx builds into background processes, adding support for multi-root and multiple Sphinx projects in a workspace, and expanding configuration sources beyond initialization options.
The 2.x releases in 2026 continued the migration with Sphinx 9 support, command changes, logging changes, and a dedicated `esbonio sphinx build` command.
Adoption history
Esbonio is packaged as a Homebrew formula and as editor-facing tooling, especially through its VS Code extension and documented integrations for editors such as Emacs and Neovim.
Its adoption follows Sphinx users who want language-server behavior while editing reStructuredText or MyST documentation, rather than treating documentation as plain text plus an external build step.
How it is used
Typical use is to install or launch the Esbonio language server from an editor integration and let it run Sphinx builds in the background for completion, diagnostics, references, and live preview.
Project-specific configuration is documented through `pyproject.toml` under `[tool.esbonio.sphinx]`, with settings such as build arguments, configuration overrides, Python command, environment, and working directory.
Why package nerds care
Esbonio is notable to package-manager users because it turns a documentation build system into editor infrastructure: a Homebrew-installed CLI/server can support Sphinx projects across editor clients.
It sits at the intersection of Python packaging, Sphinx documentation workflows, Language Server Protocol clients, and editor extensions.
Timeline
- 2025-10-28: Esbonio Language Server v1.0.0 released with background Sphinx process architecture and expanded configuration.
- 2026-02-19: v1.1.0 introduced `esbonio.sphinx.buildArguments` and documented project discovery.
- 2026-04-11: v2.0.0 dropped Sphinx 6 support, changed command behavior, and added Sphinx 9 support.
- 2026-06-28: v2.1.0 added `esbonio sphinx build`.
Related projects
- Sphinx is the documentation system Esbonio targets.
- The Language Server Protocol defines the editor integration model.
- The official repository also includes a VS Code extension and Sphinx extension packages.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for esbonio. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
pyproject.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
esbonio | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version2.1.0
manager updated2026-07-07
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:esbonio |
|---|---|
| Version | 2.1.0 |
| Package manager | Homebrew |
| Homepage | https://github.com/swyddfa/esbonio |
| Last updated | 2026-07-07T10:01:21Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- pkg.so package database
- pkgdb category and tag curation