Stats
Links
Categories
Astro code intelligence for Claude Code — on-demand diagnostics and optional full LSP
npx claudepluginhub ricardo-nth/claude-astro-lspOn-demand Astro diagnostics via /astro-check:check — zero persistent memory cost
Full Astro language server for Claude Code — real-time diagnostics, go-to-definition, references. ~400MB memory. Enable for heavy sessions.
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 |
# 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
/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.
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:checkfor 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).
@astrojs/language-server globally installednpm install -g @astrojs/language-server
| 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 |
MIT