Boring Registry Schema Specification

Version: 1.0.0
Status: Draft
Date: 2026-01-18

This document defines the structure of registry.json, which is the index file for the decentralized Boring-Gemini plugin ecosystem.

Core Philosophy

• Index Only: The Registry only stores indices, not code.
• Git-Native: Relies on Git URLs as the single "Source of Truth".
• Decentralized: Anyone can fork this registry and maintain their own list.

JSON Structure

{
  "schema_version": "1.0",
  "last_updated": "YYYY-MM-DD",
  "maintainer": "Boring Team",
  "plugins": [
    {
      "id": "namespace/plugin-name",
      "type": "plugin",
      "name": "Display Name",
      "description": "Short description",
      "repo": "https://github.com/user/repo",
      "branch": "main",
      "path": "/",
      "min_core_version": "15.0.0",
      "tags": ["tag1", "tag2"],
      "verified": false
    }
  ]
}

Field Definitions

Root Object

Field	Type	Description
schema_version	string	Registry format version (e.g. "1.0")
last_updated	string	Last updated date (ISO 8601)
plugins	array	List of plugins

Plugin Object

Field	Type	Required	Description
id	string	Yes	Unique identifier, format namespace/name. Usually corresponds to github_user/repo_name.
type	string	Yes	Resource type: plugin, workflow, brain, theme
name	string	Yes	Human-readable display name
description	string	Yes	Short description (suggested < 100 characters)
repo	string	Yes	Full Git Repository URL (HTTPS)
branch	string	No	Specific branch, defaults to main or master
path	string	No	Subdirectory path within the repository, defaults to root /
min_core_version	string	No	Minimum supported boring-gemini version (SemVer)
tags	array	No	Keywords for search
verified	bool	No	(Official use) Whether it has passed official security audit

Example

{
  "schema_version": "1.0",
  "last_updated": "2026-01-18",
  "plugins": [
    {
      "id": "boring/security-scanner",
      "type": "plugin",
      "name": "Security Scanner",
      "description": "Advanced static analysis for Python code security.",
      "repo": "https://github.com/boring-plugins/security-scanner",
      "min_core_version": "15.0.0",
      "tags": ["security", "audit", "linter"],
      "verified": true
    }
  ]
}