claude-astro-lsp
Astro code intelligence for Claude Code. Ships two plugins from one marketplace:
| Plugin | What | Memory | Install |
|---|
astro-check | On-demand diagnostics via /astro-check:check | 0 (runs and exits) | Always enabled |
astro-lsp | Full language server — real-time diagnostics, go-to-definition, references | ~1.2GB | Opt-in for heavy sessions |
Install
# Add the marketplace
/plugin marketplace add ricardo-nth/claude-astro-lsp
# Install the lightweight check skill (recommended)
/plugin install astro-check@claude-astro-lsp
# Optionally install the full LSP (disabled by default)
/plugin install astro-lsp@claude-astro-lsp
Usage
/astro-check:check (recommended)
Runs astro check on demand — catches type errors, missing imports, and invalid syntax across .astro and .ts files. No persistent process.
/astro-check:check
You can also add this to your project's CLAUDE.md for automatic use:
After editing `.astro` files, run `pnpm astro check` before considering the task complete.
Full LSP (heavy sessions)
Memory warning: The Astro language server is built on Volar and spawns its own TypeScript server internally. Expect ~1.2GB total memory (Claude Code + Astro LS + tsserver). This is inherent to the Volar architecture — the bulk is TypeScript loading your project graph, not something that can be optimised away. Use /astro-check:check for normal work and only enable the full LSP when you need persistent real-time diagnostics.
For sessions with lots of .astro edits where you want real-time diagnostics after every edit:
/plugin enable astro-lsp@claude-astro-lsp # requires restart
/plugin disable astro-lsp@claude-astro-lsp # when done
The LSP uses a Node.js proxy that auto-resolves typescript.tsdk from your project (npm, yarn, pnpm, or global installs).
Prerequisites
npm install -g @astrojs/language-server
Troubleshooting
| Issue | Fix |
|---|
astro-ls: command not found | Install @astrojs/language-server globally |
Could not resolve typescript | Install typescript in your project or globally |
| High memory (~1.2GB) | This is expected — disable astro-lsp, use /astro-check:check instead |
| Plugin not loading | /plugin → Errors tab |
License
MIT
boostvolt
TheBushidoCollective
alexanderop