AIShelf
README.mdfeatures.mdhow-it-works.mduse-cases.mdpricing.mddocs.mdregistry-guide.mdregistry-policy.md

Create and manage your own AIShelf registry to share AI resources with your team. This guide covers automatic setup, organization, and team access management.

Automatic Setup (Recommended)

Step 1: Click Create Registry

Open the AIShelf sidebar and click the Create Registry button in the toolbar.

Step 2: Choose Repository Details

Fill in the details:

  • Repository Name: Choose a descriptive name (e.g., team-ai-registry)
  • Description: Briefly describe the registry contents
  • Visibility: Public (free) or Private (requires subscription)

Start with a public registry to try AIShelf for free.

Step 3: AIShelf Initializes Everything

The extension automatically:

  • Creates a new GitHub repository in your account
  • Adds the required ai_shelf_registry.json file
  • Creates the packages/ directory structure
  • Commits and pushes the initial files
  • Connects the registry to your AIShelf sidebar

Step 4: Start Adding Resources

Your registry is ready:

  • Create packages (click the folder icon)
  • Upload resources (click the upload icon)
  • Invite team members to collaborate

Registry is now live on GitHub. Share the repository URL with team members.

Organizing Your Registry

Resource Organization Example

packages/
├── code-review/
├── workflows/
├── pr-review-checklist.md
└── security-review.md
├── rules/
└── review-standards.md
└── prompts/
└── ask-for-tests.md
├── documentation/
├── workflows/
└── api-doc-generator.md
└── prompts/
└── explain-code.md
└── testing/
├── workflows/
└── test-coverage.md
└── skills/
└── pytest-helper.md

Tips: Group packages by purpose or team, use clear names, keep related resources together, and maintain consistent naming.

Managing Team Access

All permissions are managed through GitHub. AIShelf does not provide or revoke repository access.

GitHub Permissions

Public Repos

Anyone can read, only collaborators can write

Private Repos

Only invited users can access

Organization Repos

Use GitHub teams for granular access

Collaboration Roles

Read-Only Team Members

  • Can connect and sync
  • Can copy resources
  • Cannot upload or edit

Contributors

  • Can create drafts locally
  • Can upload new resources
  • Can edit existing resources

Admins

  • Full repository access
  • Can manage collaborators
  • Can delete packages/resources

Common Issues

Team member can't connect? Check their GitHub repository permissions.

Someone has only read access? Add them as a collaborator in GitHub to grant write access.

Example Registries

AIShelf Starter Registry

Vedant2254/aishelf-starter-registry

Sample workflows, rules, prompts, and skills.

Next Steps

Registry Policy & Security

File requirements and security validations

Documentation

Learn how to use AIShelf