Skip to main content
AI/MLjmagly

run

Execute a named script defined in .aiwg/aiwg.config or list all available scripts

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--run
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/aiwg-utils/skills/run/SKILL.md -o .claude/skills/run.md

Drops the SKILL.md into .claude/skills/run.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Run

You execute a named script defined in .aiwg/aiwg.config, or list all available scripts when no name is given.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

  • "what scripts are available" → list scripts
  • "run the deploy script" → run deploy
  • "execute test script" → run test
  • "aiwg run" → list if no name; run if name given

Trigger Patterns Reference

Pattern Example Action
Named run "run the test script" Run aiwg run test
Explicit list "list aiwg scripts" Run aiwg run (no args)
With args "run deploy with flag --prod" Run aiwg run deploy --prod
Unknown name "run the build script" Run aiwg run build; report if not found

Behavior

When triggered:

  1. Verify config exists:

    • Read .aiwg/aiwg.config to confirm scripts block is present.
    • If no config found, suggest aiwg init to create one.

  2. Extract arguments:

    • Is a script name specified? If yes, run it.
    • If no name, list all registered scripts with their shell commands.
    • Are additional arguments passed through? Append them to the shell invocation.

  3. Run the appropriate command:

    # List all available scripts
aiwg run

# Run a named script
aiwg run <script-name>

# Run with pass-through arguments
aiwg run <script-name> -- <extra-args>

  4. What "run" does:

    • Reads the script's shell command from .aiwg/aiwg.config
    • Executes it in the project root
    • Streams output to the terminal
    • Reports exit code on completion

  5. Report the result — show the command that was executed, stream output, and confirm success or failure with exit code.

Examples

Example 1: List available scripts

User: "What scripts do I have registered in aiwg?"

Extraction: List request, no script name

Action:

aiwg run

Response:

Registered scripts (from .aiwg/aiwg.config):

  test    → npm test
  lint    → npm run lint
  deploy  → ./scripts/deploy.sh --env staging

Run a script with: aiwg run <script-name>

Example 2: Run a named script

User: "Run the lint script"

Extraction: Script name lint

Action:

aiwg run lint

Response: Executes npm run lint, streams output, then reports: "Script lint completed (exit 0)."

Example 3: Run with pass-through arguments

User: "Run the deploy script with --env production"

Extraction: Script name deploy, extra args --env production

Action:

aiwg run deploy -- --env production

Response: Executes ./scripts/deploy.sh --env staging --env production (or however the script merges args), then reports exit status.

Example 4: Script not found

User: "Run the build script"

Extraction: Script name build, not present in config

Action:

aiwg run build

Response: "No script named build found in .aiwg/aiwg.config. Available scripts: test, lint, deploy. Register build with aiwg init --interactive or edit .aiwg/aiwg.config directly."

Example 5: No config present

User: "aiwg run test"

Extraction: No .aiwg/aiwg.config found

Response: ".aiwg/aiwg.config not found. Run aiwg init to create one and register scripts."

Clarification Prompts

If the user's intent is ambiguous:

  • "Which script would you like to run? Available: test, lint, deploy."
  • "No script name given — should I list all registered scripts?"

References

  • @$AIWG_ROOT/src/cli/handlers/run.ts — run command handler
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/init/SKILL.md — Registering scripts via init