Artifact Hub

Discover, install, and manage AI development artifacts from any Git platform

Artifact Hub is a VS Code extension that provides a marketplace for AI development artifacts (chat modes, prompts, instructions, and profiles). Install artifacts with one click from GitHub, GitLab, or any Git platform.

Features

🔍 Universal Search

• Search across multiple catalog repositories
• Filter by type, language, framework, category, and difficulty
• Full-text search with intelligent ranking
• Preview artifacts before installing

📦 One-Click Installation

• Install artifacts directly into your workspace
• Automatic dependency resolution
• Conflict detection and resolution
• Update notifications

🔐 Private Catalogs

• Support for private repositories
• Bearer token and PAT authentication
• Environment variable support
• Secure credential storage

👥 Team Collaboration

• Share organization catalogs
• Standardize AI workflows across teams
• Profile bundles for quick setup

Getting Started

Installation

1. Install the extension from the VS Code Marketplace
2. Click the Artifact Hub icon in the Activity Bar
3. Add a catalog repository

Managing Catalogs

Adding a Catalog

Click Add Repository in the Repositories view and enter:

• URL: Raw URL to copilot-catalog.json
• ID: Unique identifier (auto-generated)
• Auth (optional): For private repositories

Example URLs:

GitHub:  https://raw.githubusercontent.com/org/repo/main/copilot-catalog.json
GitLab:  https://gitlab.com/org/repo/-/raw/main/copilot-catalog.json

Removing a Catalog

You can remove a catalog in two ways:

1. From the Repositories view: Click the Remove button on any repository card
2. From the Command Palette: Run Artifact Hub: Remove Repository and select from the list

When you remove a repository, the extension will:

• Prompt for confirmation if there are installed artifacts from that repository
• Automatically delete all installed artifacts from that repository
• Clean up all database records and metadata
• Update your workspace settings

Installing Artifacts

1. Search for artifacts in the Search view
2. Click Preview to view details
3. Click Install to add to your workspace
4. Artifacts are installed in .github/ by default

Catalog Format

Create your own catalog with a copilot-catalog.json file:

{
  "version": "1.0.0",
  "catalog": {
    "id": "my-catalog",
    "name": "My Catalog",
    "description": "My custom artifacts",
    "author": {
      "name": "Your Name"
    },
    "repository": {
      "type": "github",
      "url": "https://github.com/user/repo",
      "branch": "main"
    },
    "license": "MIT"
  },
  "artifacts": [
    {
      "id": "my-chatmode",
      "type": "chatmode",
      "name": "My Chat Mode",
      "description": "Description of the chat mode",
      "path": "chatmodes/my-chatmode.chatmode.md",
      "version": "1.0.0",
      "category": "Development",
      "tags": ["typescript", "expert"],
      "dependencies": []
    }
  ]
}

See examples/sample-catalog.json for a complete example.

Configuration

Settings

• artifactHub.repositories: List of configured catalog repositories
• artifactHub.autoUpdate: Automatically check for catalog updates (default: true)
• artifactHub.updateInterval: Update check interval in seconds (default: 3600)
• artifactHub.installRoot: Root directory for installations (default: .github)

Commands

• Artifact Hub: Search Artifacts - Open search view
• Artifact Hub: View Installed Artifacts - View installed artifacts
• Artifact Hub: Add Repository - Add a new catalog
• Artifact Hub: Remove Repository - Remove a catalog and its installed artifacts
• Artifact Hub: Refresh Catalogs - Refresh all catalogs

Authentication

Personal Access Token (GitLab/GitHub)

1. Generate a PAT with read_repository scope
2. When adding a catalog, check "Requires Authentication"
3. Enter your token when prompted
4. Tokens are stored securely in VS Code

Environment Variables

Reference environment variables in your settings:

{
  "artifactHub.repositories": [
    {
      "id": "private-catalog",
      "url": "https://gitlab.company.com/...",
      "auth": {
        "type": "bearer",
        "token": "${env:GITLAB_TOKEN}"
      }
    }
  ]
}

Artifact Types

• Chat Modes (.chatmode.md): Installed to .github/chatmodes/
• Instructions (.md): Installed to .github/instructions/
• Prompts (.md): Installed to .github/prompts/
• Tasks (.md): Installed to .github/tasks/
• Profiles (.json): Bundles of artifacts

Contributing

We welcome contributions! Please see our Contributing Guide.

Development Setup

cd extension
npm install
npm run watch

Press F5 to launch the Extension Development Host.

Publishing

1. Bump the version in package.json and commit your changes.
2. Run the quality gates:

   npm run lint && npm run typecheck && npm test
   

3. Build and package a .vsix artifact (written to artifacts/<name>-<version>.vsix and echoed after completion):

   npm run package:vsix
   

4. Publish the extension to the Visual Studio Code Marketplace (the script automatically loads VSCE_PAT from .env via dotenv-cli):

   npm run publish:marketplace
   

The publish:marketplace script uses vsce under the hood and injects VSCE_PAT from .env, so you can store the token once and keep publishing repeatable. You can still run npx vsce login nimsbhai if you prefer the interactive flow. See the VS Code publishing guide for additional options (pre-releases, platform-specific VSIX files, and automation tips).

License

MIT © Artifact Hub

Support

• 📖 Documentation
• 💬 Discussions
• 🐛 Issue Tracker

Enjoy using Artifact Hub! ⭐