Registry

The InitRunner registry lets you install pre-built roles from GitHub repositories and a community index. Instead of writing every role from scratch, you can search for existing roles, inspect their configuration, and install them with a single command.

Quick Start

# Search for roles
initrunner search "code review"

# Inspect before installing
initrunner info user/initrunner-code-reviewer

# Install
initrunner install user/initrunner-code-reviewer

# Run the installed role
initrunner run code-reviewer -i

CLI Commands

Search

initrunner search <query>

Searches the community role index by name, description, and tags. Returns matching roles with name, description, author, and install source.

initrunner search "kubernetes"
initrunner search "slack notification"
initrunner search "rag"

Info

initrunner info <source>

Inspects a role's metadata without installing it. Shows name, description, author, version, tags, dependencies, model requirements, and tools used.

# From GitHub
initrunner info user/initrunner-k8s-monitor

# From the community index
initrunner info k8s-monitor

Install

initrunner install <source>

Installs a role from a GitHub repository or community index entry.

# From GitHub
initrunner install user/initrunner-code-reviewer

# From community index by name
initrunner install code-reviewer

List

initrunner list

Shows all installed roles with name, version, source, and install date.

NAME              VERSION   SOURCE                                          INSTALLED
code-reviewer     1.2.0     user/initrunner-code-reviewer                   2025-01-10
k8s-monitor       0.5.1     user/initrunner-k8s-monitor                     2025-01-08
slack-notifier    1.0.0     community-index                                 2025-01-05

Update

initrunner update [name]

Updates installed roles to their latest version. Without a name, updates all installed roles.

# Update a specific role
initrunner update code-reviewer

# Update all installed roles
initrunner update

Uninstall

initrunner uninstall <name>

Removes an installed role from the local system.

initrunner uninstall code-reviewer

Install Sources

GitHub Repositories

Any public GitHub repository containing a valid role YAML can be installed directly using user/repo shorthand:

initrunner install user/initrunner-my-role

The repository should contain a role YAML file at the root level. If the repo contains multiple roles, InitRunner installs all of them.

Community Index

The community index is a curated collection of roles maintained by the InitRunner community in vladkesler/community-roles. Roles in the index can be installed by name:

initrunner install code-reviewer

Install Location

Installed roles are stored in ~/.initrunner/roles/:

~/.initrunner/roles/
├── code-reviewer/
│   ├── role.yaml
│   ├── SKILL.md
│   └── my_tools.py
├── k8s-monitor/
│   └── role.yaml
└── slack-notifier/
    └── role.yaml

Each role gets its own directory containing the role YAML and any associated files (skills, custom tool modules, etc.).

Installed roles are discoverable by initrunner list, the TUI, and the web dashboard. You can run them directly by name:

initrunner run code-reviewer -i