Distribution¶

This document describes how agent-lsp is distributed, what is automated, and what is still planned.

Current channels¶

GitHub Releases¶

Pre-built binaries for all platforms, published automatically by GoReleaser on every v* tag.

Platform	Architecture
macOS	arm64, amd64
Linux	arm64, amd64
Windows	arm64, amd64

Homebrew¶

brew install blackwell-systems/tap/agent-lsp

Formula in blackwell-systems/homebrew-tap is updated automatically by GoReleaser on every release.

curl | sh (macOS / Linux)¶

curl -fsSL https://raw.githubusercontent.com/blackwell-systems/agent-lsp/main/install.sh | sh

Detects OS and architecture, downloads the matching binary from GitHub Releases, installs to /usr/local/bin.

PowerShell (Windows)¶

iwr -useb https://raw.githubusercontent.com/blackwell-systems/agent-lsp/main/install.ps1 | iex

Detects amd64/arm64, downloads the matching zip from GitHub Releases, installs to %LOCALAPPDATA%\agent-lsp, adds to user PATH. No admin required.

Scoop (Windows)¶

scoop bucket add blackwell-systems https://github.com/blackwell-systems/agent-lsp
scoop install blackwell-systems/agent-lsp

Manifest at bucket/agent-lsp.json in this repo (the repo doubles as the Scoop bucket). autoupdate is configured — scoop update agent-lsp picks up new releases automatically.

Winget (Windows)¶

winget install BlackwellSystems.agent-lsp

Manifests at winget/manifests/b/BlackwellSystems/agent-lsp/. Submit new versions as a PR to microsoft/winget-pkgs — copy the winget/manifests/ directory structure, update version and hashes.

npm¶

npm install -g @blackwell-systems/agent-lsp

Uses the optionalDependencies pattern (same as esbuild): a root package with a JS shim and six platform-specific packages each containing the native binary. npm installs only the package matching the current platform.

Published automatically by the npm-publish CI job after GoReleaser completes.

Packages: - @blackwell-systems/agent-lsp — root (install this) - @blackwell-systems/agent-lsp-darwin-arm64 - @blackwell-systems/agent-lsp-darwin-x64 - @blackwell-systems/agent-lsp-linux-arm64 - @blackwell-systems/agent-lsp-linux-x64 - @blackwell-systems/agent-lsp-win32-x64 - @blackwell-systems/agent-lsp-win32-arm64

Docker (GHCR + Docker Hub)¶

# GHCR
docker pull ghcr.io/blackwell-systems/agent-lsp:latest

# Docker Hub
docker pull blackwellsystems/agent-lsp:latest

# Base image (same content, two registries)
docker pull ghcr.io/blackwell-systems/agent-lsp:latest

# Language-specific images
docker pull ghcr.io/blackwell-systems/agent-lsp:go
docker pull ghcr.io/blackwell-systems/agent-lsp:typescript
docker pull ghcr.io/blackwell-systems/agent-lsp:python

# Combo images
docker pull ghcr.io/blackwell-systems/agent-lsp:fullstack

All images are multi-arch (linux/amd64 + linux/arm64) via Docker manifest lists. Native performance on Apple Silicon and AWS Graviton — no Rosetta/QEMU emulation. Built and pushed to both registries automatically by GoReleaser on every v* tag. Tags: latest, base, semver (0.1.2, 0.1), and per-language (go, typescript, python, ruby, cpp, php, web, backend, fullstack, full).

MCP registries¶

Official MCP Registry¶

Published automatically via mcp-publisher in CI using GitHub OIDC (no secrets required). PulseMCP ingests from the official registry weekly.

Server name: io.github.blackwell-systems/agent-lsp Status: Live as of v0.1.2 — verified at registry.modelcontextprotocol.io

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.blackwell-systems/agent-lsp"

Glama¶

Listed at glama.ai/mcp/servers/blackwell-systems/agent-lsp. Profile managed via glama.json in repo root. Score badge: A grade. Build verified — server passes Glama's automated inspection checks.

Smithery¶

smithery.yaml in the repo root enables auto-indexing on Smithery. Auto-discovered from GitHub.

cursor.directory¶

Submitted. Cursor detects 20 skill components from SKILL.md files. Listed under Developer Tools.

mcpservers.org¶

Manually submitted. Free listing.

Awesome MCP Servers¶

PR submitted (punkpeye/awesome-mcp-servers#5145). Pending maintainer review.

Documentation site¶

URL: agent-lsp.com

Built with mkdocs-material from the docs/ folder. Deployed to GitHub Pages automatically on every push to main via .github/workflows/docs.yml. Custom domain via Cloudflare DNS (CNAME → blackwell-systems.github.io).

Release pipeline¶

Every git tag v* push triggers three sequential CI jobs:

release              → GoReleaser: binaries, GitHub Release, Homebrew formula,
                       all 11 Docker images (GHCR + Docker Hub)
npm-publish          → downloads binaries from GitHub Release, publishes 7 npm packages
mcp-registry-publish → publishes metadata to official MCP Registry (GitHub OIDC)

Docker images are built inside the release job by GoReleaser (dockers: section). 22 images (11 tags × 2 architectures) are built and combined into 11 multi-arch manifest lists via docker_manifests. Base images build first so downstream images can pull them as their FROM layer.

Planned¶

Channel	Notes
Nix flake	`nix run github:blackwell-systems/agent-lsp`
mcp.so	Top Google result for "MCP servers"; direct submission
VS Code extension	Zero-CLI-setup path for Copilot/Continue/Cline users