README.md

Athas Extensions

Extensions for the Athas editor.

Syntax highlighting is now bundled in Athas core by default. This repository focuses on language tooling extensions (LSP, formatter, linter, snippets), plus themes and icon themes.

Extension manifests are declarative. New manifests should prefer the contributes shape for editor contributions, while managed runtime tooling stays under capabilities. Existing top-level contribution fields are still supported.

Structure

Language extensions can live under extensions/{name}/. Marketplace contribution extensions are grouped by type:

extensions/
  lua/
    extension.json    # Extension manifest
    tooling.json      # Platform-specific tooling (LSP, formatter, linter binaries)
    build.sh          # Build script for tooling archives
  theme/
    market/
      extension.json  # Theme contribution manifest
      icon.svg
  icon-theme/
    market/
      extension.json  # Icon theme contribution manifest
      icon.svg

Root-level files:

• registry.json / index.json - Extension registry for the marketplace
• manifests.json - Combined manifests (auto-generated, do not edit manually)

Manifest Shape

{
  "$schema": "https://athas.dev/schemas/extension.json",
  "id": "athas.mylang",
  "name": "MyLang",
  "displayName": "MyLang",
  "version": "1.0.0",
  "publisher": "Athas",
  "categories": ["Language"],
  "engines": {
    "athas": ">=0.7.0"
  },
  "contributes": {
    "languages": [
      {
        "id": "mylang",
        "extensions": [".ml"],
        "filenames": ["MyLangfile"],
        "filenamePatterns": ["*.mylang.json"],
        "aliases": ["MyLang"]
      }
    ]
  },
  "capabilities": {
    "lsp": {
      "name": "mylang-language-server",
      "runtime": "node",
      "package": "mylang-language-server",
      "args": ["--stdio"]
    }
  }
}

Supported contribution arrays include languages, snippets, themes, iconThemes, databaseProviders, agents, commands, and keybindings. The validation and catalog scripts read both top-level arrays and contributes.*.

Scripts

bun run scripts/validate.ts
bun run scripts/package-extensions.ts
bun run scripts/generate-manifests.ts
bun run scripts/build-extensions-index.ts

Contributing

See CONTRIBUTING.md.

License

GPL-3.0