mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-26 06:01:49 +00:00
- Note that typescript-language-server pulls in the typescript SDK automatically (peer-dep relationship was previously implicit and caused initialize failures when the SDK was absent). - Add a Troubleshooting entry for the new Backend warnings section in hermes lsp status, with the shellcheck install commands across apt / brew / scoop. Reflects what shipped in PR #24630.
This commit is contained in:
parent
557deece6f
commit
80c4b27437
1 changed files with 25 additions and 0 deletions
|
|
@ -92,6 +92,13 @@ manager makes sense for that language (rustup, ghcup, opam, brew,
|
||||||
…). Hermes auto-detects the binary on PATH or in
|
…). Hermes auto-detects the binary on PATH or in
|
||||||
`<HERMES_HOME>/lsp/bin/`.
|
`<HERMES_HOME>/lsp/bin/`.
|
||||||
|
|
||||||
|
A few servers are installed alongside a peer dependency that npm
|
||||||
|
won't auto-pull. The current case is `typescript-language-server`,
|
||||||
|
which requires the `typescript` SDK importable from the same
|
||||||
|
`node_modules` tree — Hermes installs both packages together when you
|
||||||
|
run `hermes lsp install typescript` or auto-install fires on first
|
||||||
|
use.
|
||||||
|
|
||||||
## CLI
|
## CLI
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
@ -207,6 +214,24 @@ The binary isn't on PATH and isn't in `<HERMES_HOME>/lsp/bin/`. Run
|
||||||
`hermes lsp install <server_id>` to attempt an auto-install, or
|
`hermes lsp install <server_id>` to attempt an auto-install, or
|
||||||
install the binary manually through the language's normal toolchain.
|
install the binary manually through the language's normal toolchain.
|
||||||
|
|
||||||
|
**`Backend warnings` section in `hermes lsp status`**
|
||||||
|
|
||||||
|
Some servers ship as thin wrappers around an external CLI for actual
|
||||||
|
diagnostics — they spawn cleanly and accept requests but never emit
|
||||||
|
errors when the sidecar binary is missing. The most common case is
|
||||||
|
`bash-language-server`, which delegates diagnostics to `shellcheck`.
|
||||||
|
When `hermes lsp status` shows a `Backend warnings` section, install
|
||||||
|
the named tool through your OS package manager:
|
||||||
|
|
||||||
|
```
|
||||||
|
apt install shellcheck # Debian / Ubuntu
|
||||||
|
brew install shellcheck # macOS
|
||||||
|
scoop install shellcheck # Windows
|
||||||
|
```
|
||||||
|
|
||||||
|
The same warning is logged once at server spawn time in
|
||||||
|
`~/.hermes/logs/agent.log`.
|
||||||
|
|
||||||
**Server starts but never returns diagnostics**
|
**Server starts but never returns diagnostics**
|
||||||
|
|
||||||
Check `~/.hermes/logs/agent.log` for `[agent.lsp.client]` entries —
|
Check `~/.hermes/logs/agent.log` for `[agent.lsp.client]` entries —
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue