Your Account

Your GitHub handle is your registry namespace. Authenticate with GitHub - no separate account needed.

Authentication

muxi login

This opens your browser to authenticate with GitHub. Once complete:

✓ Authenticated as @alice
✓ Registry access granted

Your formations publish under @alice/*.

Your Namespace

Your GitHub username becomes your registry namespace:

# Publish under your username
muxi push
# → @alice/my-formation

Profile Information

Your registry profile is pulled from GitHub:

• Username - Your handle
• Avatar - Your GitHub avatar
• Bio - Your GitHub bio (optional)
• URL - Your GitHub profile or website

Update these on GitHub; they sync automatically.

Check Authentication

To verify your authentication, you can try to push (with --dry-run) or list your formations:

muxi push --dry-run

If authenticated, you'll see your username in the output.

Logout

muxi logout

Revokes the stored token. You'll need to re-authenticate to push.

Token Storage

Authentication tokens are stored locally:

Tokens are scoped to registry access only - MUXI cannot access your GitHub repos.

Publishing Formations

Publish formations to the registry:

muxi push              # Publish to your namespace

Next Steps

• Publishing - Publish your first formation
• Versioning - Version management