aws / aws/aws-toolkit-vscode

Amazon Q LSP: Failure to initialize on NixOS - EPIPE error during LSP startup

Open
#6,972 12 comments 0 reactions 0 assignees View on GitHub
amazon-q bug
Dominant language
TypeScript
Stars
2k
Forks
807
Avg merge
10h 12m
Merged PRs (30d)
7

Description

## Problem
As a NixOS user attempting to use Amazon Q, the Language Server fails to start. NixOS being an immutable operating system, this appears to be a configuration-related issue with the Language Server initialization.

## Steps to reproduce the issue
1. Install Amazon Q extension in VS Code on NixOS
2. Open VS Code
3. Attempt to initialize Amazon Q
4. Language Server fails to start

## Expected behavior
The Language Server should initialize successfully and Amazon Q should be available for use within VS Code.

## System details
- OS: NixOS 25.05 (Warbler)
- Visual Studio Code version (VSCodium): 1.98.2 Release: 25072
- AWS Toolkit version: N/A
- Amazon Q version: 1.54.0

Amazon Q About:
- OS: Linux x64 6.12.19
- Visual Studio Code extension host: 1.98.2
- Amazon Q: 1.54.0
- node: 20.18.2
- electron: 34.2.0

## Relevant logs
```log
[info] using amazonqWorkspaceLsp service configuration: default
[info] lsp: Failed to download latest "AmazonQ-Workspace" manifest. Falling back to local manifest.
[info] lsp: Finished setting up LSP server
[info] [Error] Starting client failed
[info] Error: write EPIPE
at afterWriteDispatched (node:internal/stream_base_commons:161:15)
at writeGeneric (node:internal/stream_base_commons:152:3)
at Socket._writeGeneric (node:net:958:11)
at Socket._write (node:net:970:8)
at writeOrBuffer (node:internal/streams/writable:572:12)
at _write (node:internal/streams/writable:501:10)
at Writable.write (node:internal/streams/writable:510:10)
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7259:3222
at new Promise ()
at x.send (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7259:3201)
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7211:207
at x.createMessageTransports (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6456:30748)
at x.createConnection (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6456:8193)
at x.resolveConnection (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6456:3445)
at x.start (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6456:2095)
at w (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6494:15863)
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6494:23212
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7211:629
at AsyncLocalStorage.run (node:async_hooks:346:14)
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7245:10371
at I.withTraceId (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7245:10601)
at I.run (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7245:10267)
at Object.run (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7245:11070)
at s (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7211:562)
at /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6494:23179
at async /nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7211:623
at async s (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:7211:523)
at async f.setupLsp (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6494:23060)
at async Immediate. (/nix/store/-vscode-extension-amazonwebservices-amazon-q-vscode-1.54.0/share/vscode/extensions/amazonwebservices.amazon-q-vscode/dist/src/extensionNode.js:6494:22010)

Contributor guide

Open the contributing guide

Research direction

Reproduce the failure using the listed NixOS, VSCodium, and Amazon Q versions, then inspect dist/src/extensionNode.js around setupLsp, createMessageTransports, and the reported write EPIPE call. Done means the Language Server initializes successfully in VS Code on NixOS; the issue names no source test, so validation must be established while investigating.

Written by the indexing model from the issue text.

Assessment

Tech stack
nixos, node.js, typescript, vscode
Domain
developer-experience, devtools, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.