muxi registry

Pull pre-built formations to use as templates, publish your own for others to use, and search the registry for solutions to common problems.

Usage

muxi pull <name>           # Pull formation
muxi push                  # Publish formation
muxi search <query>        # Search registry

Pull Formation

muxi pull @muxi/hello-muxi

Downloads to current directory:

Pulling @muxi/hello-muxi...
✓ Downloaded v1.0.0
✓ Extracted to ./starter

cd starter-assistant
muxi secrets setup
muxi dev

Pull Specific Version

muxi pull @muxi/hello-muxi@1.0.0

Pull to Custom Path

muxi pull @muxi/hello-muxi --output /path/to/dir

Search Registry

muxi search "customer support"

Output:

NAME                      DESCRIPTION                 DOWNLOADS
@muxi/support-bot         Customer support agent      1,234
@acme/helpdesk           Helpdesk assistant          567
@company/zendesk-agent   Zendesk integration         89

Filter by Tag

muxi search --tag support
muxi search --tag research

Publish Formation

cd my-formation
muxi push

Output:

Publishing my-formation...
✓ Validated formation
✓ Bundled (2.3MB)
✓ Published to registry

Available at: https://registry.muxi.org/my-formation

First-Time Setup

muxi login

Authenticates with registry via GitHub OAuth.

Publish to an Organization

If you're an admin or owner of a GitHub organization, you can publish formations under that org:

muxi push --org my-org

Only org admins can publish. To see which orgs you can publish to:

muxi registry orgs

Publish Options

muxi push --public              # Public visibility
muxi push --private             # Private (default)
muxi push --tag v1.0.0          # Specific version tag
muxi push --org my-org          # Publish under organization

Registry Namespaces

Formation Metadata

Add registry metadata to formation.afs:

schema: "1.0.0"
id: my-formation
name: My Formation
description: A helpful assistant

# Registry metadata
author: username
license: MIT
tags:
  - assistant
  - support
repository: https://github.com/user/my-formation

Organizations

List your GitHub organizations and see which ones you can publish to:

muxi registry orgs

Output:

  Found 2 organization(s)

  ● muxi-ai
    The Agent Server
    admin (can publish)

  ○ some-other-org
    Another org
    member

• ● (green) = you can publish to this org (muxi push --org )
• ○ = member only, cannot publish

The registry auto-creates the org record on first publish -- no setup needed.

Browse Online

Visit registry.muxi.org to:

• Browse formations
• View documentation
• Check download stats

Private Registry

Configure private registry:

# ~/.muxi/cli/config.yaml
registry:
  url: https://registry.company.com

Examples

# Pull official starter
muxi pull @muxi/hello-muxi

# Search for research agents
muxi search research

# Publish your formation
muxi push --public

# Pull specific version
muxi pull @acme/support@2.0.0