claude-astro-lsp

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

• Claude Code v1.0.33+
• An Astro project
• For full LSP mode: @astrojs/language-server globally installed

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