install

namespace	aiwg
name	install
platforms	["all"]
description	Install AIWG-compatible packages from remote Git repositories into the current workspace

AIWG Install

You install AIWG-compatible packages from remote Git repositories into the current workspace.

Triggers

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

• "grab the package from github" → install from Git URL
• "pull in owner/repo" → install using shorthand ref
• "add a community addon" → install remote package
• "install from that repo" → install from Git URL

Trigger Patterns Reference

Pattern	Example	Action
Install by URL	"install from https://github.com/org/pkg"	Run aiwg install https://github.com/org/pkg
Install by shorthand	"install owner/repo"	Run aiwg install owner/repo
Install with branch	"install owner/repo at main"	Run aiwg install owner/repo#main

Behavior

When triggered:

1. Extract intent:

   • What is the Git reference? Accept a full HTTPS URL or an owner/repo shorthand (resolved against github.com by default).
   • Is a specific branch, tag, or commit hash mentioned? Append as #ref.

2. Resolve the reference:

   Input form	Example	Resolved
   Full URL	https://github.com/org/pkg	used as-is
   Shorthand	org/pkg	https://github.com/org/pkg
   Shorthand + ref	org/pkg#v1.2.0	https://github.com/org/pkg#v1.2.0

3. Run the command:

   # Install by full URL
   aiwg install https://github.com/owner/aiwg-package
   
   # Install by shorthand (github.com assumed)
   aiwg install owner/aiwg-package
   
   # Install a specific branch or tag
   aiwg install owner/aiwg-package#v2.0.0
   

4. Report the result inline — confirm the package name, version, and where its artifacts were deployed. Warn if the source does not appear to be a valid AIWG package.

Examples

Example 1: Install from a full GitHub URL

User: "install this addon from git: https://github.com/acme/aiwg-devtools"

Extraction: Full URL https://github.com/acme/aiwg-devtools

Action:

aiwg install https://github.com/acme/aiwg-devtools

Response: "Installed aiwg-devtools (v1.3.0) from https://github.com/acme/aiwg-devtools. Artifacts deployed to .claude/. Registered in packages registry."

Example 2: Install using owner/repo shorthand

User: "install acme/aiwg-devtools"

Extraction: Shorthand acme/aiwg-devtools, resolved to https://github.com/acme/aiwg-devtools

Action:

aiwg install acme/aiwg-devtools

Response: "Installed aiwg-devtools (v1.3.0) from https://github.com/acme/aiwg-devtools. Artifacts deployed to .claude/. Registered in packages registry."

Example 3: Install a specific version tag

User: "install acme/aiwg-devtools at v1.2.0"

Extraction: Shorthand acme/aiwg-devtools, ref v1.2.0

Action:

aiwg install acme/aiwg-devtools#v1.2.0

Response: "Installed aiwg-devtools (v1.2.0) from https://github.com/acme/aiwg-devtools at tag v1.2.0. Artifacts deployed to .claude/."

Clarification Prompts

If the user's intent is ambiguous:

• "What is the Git URL or owner/repo shorthand for the package you want to install?"
• "Should I install the latest commit on the default branch, or a specific tag or branch?"

References

• @$AIWG_ROOT/src/cli/handlers/install.ts — Install command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference