Skip to content

Repository files navigation

Omegon Armory

Official plugin and extension repository for Omegon — the terminal-native AI agent harness.

Armory is also the source tree for OCI-packaged ecosystem artifacts. The first distribution target is GHCR; the self-hosted target is a zot registry backed by Cloudflare R2. Profiles are distributed as OCI meta-packages that reference skills, personas, tones, extensions, and agents. See docs/compatibility.md, docs/profile-schema.md, docs/nex-forge-templates.md, docs/public-payload-security.md, docs/public-launch-checklist.md, docs/profile-artifacts.md, docs/self-hosting.md, docs/oci-registry-stack.md, and deploy/zot-r2.

Build the OCI payloads locally:

python3 scripts/build-oci-artifacts.py

Validate all armory entries before publishing:

node --test tests/armory-entry-suite.mjs
OMEGON_BIN=/path/to/omegon node --test tests/armory-entry-suite.mjs
OMEGON_BIN=/path/to/omegon ARMORY_TEST_NETWORK=1 node --test tests/armory-entry-suite.mjs

The first command runs local schema, catalog, extension-gating, JSONL, and OCI tool contract checks. The second adds sandboxed installs for text plugins and catalog agents. The third performs live registry smoke tests and installs every enabled extension by name.

Publish after logging in with ORAS:

python3 scripts/publish-oci-artifacts.py --sign

Run the public catalog site locally:

cd site
npm install
npm run dev

Extensions

Install enabled extensions by name:

omegon extension install flynt
Extension Category Description
flynt knowledge Vault documents, tasks, knowledge graph, design nodes

Candidate extensions remain in registry.toml with enabled = false until their name-based install path and release artifacts have been tested.

Search from the CLI:

omegon extension search           # list all
omegon extension search forge     # filter by name, category, or description

Plugins

Plugins provide personas, tones, and skills — declarative TOML manifests with no binary required.

Plugin Type Description
personas/systems-engineer persona Systems engineering harness — the default Omegon identity
personas/tutor persona Socratic tutor — guides through questioning, never lectures
tones/concise tone Terse, direct output — minimal filler
tones/alan-watts tone Philosophical, paradox-friendly, gently irreverent
skills/security skill Security checklist for code review

Install plugins:

git clone https://github.com/styrene-lab/omegon-armory
omegon plugin install ./omegon-armory/personas/tutor
omegon plugin install ./omegon-armory/tones/alan-watts

Submit

Extensions

  1. Build: omegon extension init my-ext
  2. Test: omegon extension install ./my-ext
  3. Push to a public git repo
  4. PR adding your entry to registry.toml

Plugins

  1. Create a directory with plugin.toml following the plugin spec
  2. PR adding your plugin directory

License

MIT

About

Official plugin and extension registry for Omegon — personas, tones, skills, and native extensions (scribe, scry, vox, aether, codex)

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages