OpenShellOrg modular extension host — manifests, discovery, and registration for shell extensions. This repository implements the host stub that loads extension manifests and registers core and user-supplied extensions.
OpenShellOrg splits architecture from implementation:
| Repository | Role |
|---|---|
| shell-architecture | Canon — thesis, Tool Runs, command channels, Antora docs, diagrams |
| shell-framework (this repo) | Extension host — manifest schema, core extension registry, discovery, host APIs |
Do not duplicate architecture docs here. When you need design rationale (structured pipelines, SOS relationship, host identity, env refresh plans), use shell-architecture.
manifests/core/— pointers to first-party core extensions (repos/packages), not vendored sourcesrc/— TypeScript extension host: load manifests, register extensions, discover bundled core set- Tests + CI — build and verify core registration (e.g. Prohelp) without cloning extension repos
Core extensions are registered by manifest only. The host does not embed their code.
| Extension | Manifest | Upstream |
|---|---|---|
| Prohelp | manifests/core/prohelp.manifest.json |
openshellorg/prohelp · CLI: prohelp-cli |
pnpm install
pnpm build
pnpm testProgrammatic bootstrap:
import { bootstrapExtensionHost } from "@openshellorg/shell-framework";
const host = await bootstrapExtensionHost();
console.log(host.listCore()); // includes openshellorg/prohelpSee CONTRIBUTING.md for layout and manifest conventions.
- shell-architecture — canon docs
- prohelp — structured help / gutter tooling (first core extension)
- docs — SOS certification and org docs site
MIT — see LICENSE.