Noctalia Plugins

Plugin monorepo for Noctalia 5+. Each subdirectory is a plugin loaded directly from source — no build step.

Plugins

Plugin	Description
rbw-launcher	Search Bitwarden vault entries via rbw CLI (prefix /rbw)

Structure

├── catalog.toml            # Aggregated metadata (auto-generated)
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── .gitignore
├── LICENSE
├── README.md
└── <plugin>/
    ├── plugin.toml         # Plugin manifest (required)
    ├── launcher.luau       # Launcher provider (optional)
    ├── assets/             # Images / screenshots
    └── translations/       # i18n files (en.json, fr.json, ...)

Adding a New Plugin

1. Create new-plugin/plugin.toml with metadata + entry declarations
2. Create entry files
3. Optionally add translations/, assets/
4. Update .gitignore if needed
5. Regenerate catalog (see catalog.toml header)

Development

# Validate plugin manifest
noctalia validate-plugin rbw-launcher

# Luau static analysis
luau-analyze --defs noctalia.d.luau rbw-launcher/launcher.luau

.luau files are hot-reloaded on save.

Contributing

See CONTRIBUTING.md for guidelines, bug reports, and pull request process.

Editor Setup

.vscode/settings.json and noctalia.d.luau provide autocomplete for the Noctalia API via luau-lsp. Types are loaded from noctalia.d.luau automatically.

AI Disclosure

Parts of this codebase were developed with AI assistance (Claude Code). AI tooling is welcome in contributions — just mention it in your PR description. All contributions, AI-assisted or not, are reviewed with the same standards.

Dependencies

• Noctalia 5.0.0+ — runtime
• Luau — language (subset of Lua 5.1 with type annotations)
• Allium (optional) — behavioral spec language
• curl — used by services for HTTP polling (noctalia.http unavailable in service context)