Oosh Module

Create a new module for an oosh CLI. Use /oosh-module <cli> <module> to generate an annotated .sh file in the CLI's modules directory. Trigger when the user wants to add a command, module, or feature to an existing oosh CLI. Use when this capability is needed.

tomevault-io Updated

File contents

/oosh-module — Create a new module

Create a new module file in the CLI's modules directory.

Steps

  1. Determine the modules path: ~/.<cli>/modules/ (default) — if the CLI was generated to a custom path, ask the user
  2. Ask what commands and flags the module should expose
  3. Write <module>.sh following the conventions below
  4. Run oosh lint <cli> <module> to validate the new module

Conventions

Read references/annotations.md in this skill directory for the full annotation reference and module template.

Key rules:

  • File starts with #!/bin/bash and #@module <Name> - <description>
  • Import the engine: . ${MODULES_DIR}/../oo.sh
  • Variable names: UPPER_SNAKE_CASE, prefixed with module name (e.g., DEPLOY_ENV in deploy.sh)
  • End with main $0 "$@"
  • No sed, awk, grep in hot paths — bash builtins only
  • Bash 3.2 compatible

Source: bruno-de-queiroz/oosh — distributed by TomeVault.

tomevault-io/skills-registry/tree/main/bruno-de-queiroz--oosh--oosh commit 845136e940

Frequently asked questions

npx skillmds@latest add tomevault-io/oosh-module