The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
Bash — LSP setup
- Builtin server:
bash—bash-language-server start - Extensions:
.sh .bash .zsh .ksh - Install hint:
npm install -g bash-language-server
An alias id bash-ls exists with the identical command; either id works.
Install
- macOS:
npm install -g bash-language-server - Linux:
npm install -g bash-language-server - Windows:
npm install -g bash-language-server(PowerShell)
For real diagnostics, also install shellcheck:
- macOS:
brew install shellcheck - Linux:
apt install shellcheck(ordnf install ShellCheck) - Windows:
scoop install shellcheck
Confirm it resolves:
command -v bash-language-server
command -v shellcheck
Configure
Builtin — usually NO config needed (auto-resolved by extension). Configure only to set priority, init options, override extensions, or disable. Same JSON shape in every harness's project config (per-harness paths: the Configure step in SKILL.md):
{ "lsp": { "bash": { "priority": 100 } } }
For builtin ids in a PROJECT config, command is supplied automatically — only set priority/initialization/extensions/disabled (a project entry drops env). env, and a fully custom (non-builtin) server with its own command, must go in your harness's USER config (see the Configure step in SKILL.md).
Initialization options (only if commonly needed)
None commonly required. bash-language-server discovers shellcheck on PATH automatically. To point at a non-PATH binary, export SHELLCHECK_PATH via env (USER config only; a project entry drops env):
{ "lsp": { "bash": { "env": { "SHELLCHECK_PATH": "/opt/bin/shellcheck" } } } }
Alternatives
shellcheckstandalone as a linter-only flow (no LSP).shfmtfor formatting (complements, does not replace, the LSP).
Troubleshooting
- PATH:
bash-language-serveron PATH; reopen shell afternpm -ginstall. - No diagnostics:
shellcheckmissing — diagnostics are powered by it; install and reopen. - Wrong shell dialect:
.zsh/.kshare linted as bash; shellcheck may flag shell-specific syntax.
Verify
bun ../../scripts/verify-lsp.ts path/to/file.sh