{
  "format": "recx-index/1.0",
  "generated_at": "2026-10-14T09:29:53Z",
  "generator": "recx-crawler (recx-cli 0.1.2)",
  "spec_versions": [
    "0.1"
  ],
  "counts": {
    "entries": 1,
    "rejected": 0
  },
  "entries": [
    {
      "source": {
        "full_name": "jbmv/recx",
        "url": "https://github.com/jbmv/recx",
        "default_branch": "main",
        "commit": "750ad28f0b32d2dfc03bb482d9c26bf6c6473d5c",
        "blob_sha": "94fd061714de4f7b23223755514de2d729f73b28",
        "manifest_url": "https://raw.githubusercontent.com/jbmv/recx/750ad28f0b32d2dfc03bb482d9c26bf6c6473d5c/RECX.yaml",
        "detected_license": "MIT",
        "license_check": "match",
        "declared_repository": "absent",
        "is_fork": false,
        "parent": null,
        "is_archived": false,
        "stars": 0,
        "repo_created_at": "2026-10-11T13:43:17Z",
        "pushed_at": "2026-10-13T00:48:44Z",
        "found_by": [
          "recheck",
          "seed",
          "topic"
        ],
        "first_indexed": "2026-10-11T20:09:45Z",
        "last_verified": "2026-10-14T09:29:53Z"
      },
      "manifest": {
        "recx": "0.1",
        "name": "recx",
        "summary": "A manifest format that lets coding agents find and reuse other people's open-source work.",
        "description": "res extra commercium: things outside commerce. A repository drops RECX.yaml at\nits root to say what it does, which of its modules can be taken on their own,\nhow to take them, and which checks anyone can rerun to see that they work.\nA scheduled workflow here finds manifests through GitHub search and\npublishes a daily index as a static file, so there is no service to run.\nThis repository holds the spec, and it is the spec's first adopter.\n",
        "license": "MIT",
        "status": "experimental",
        "capabilities": [
          "define a manifest format describing a repository's reusable modules to coding agents",
          "validate a RECX.yaml manifest with any JSON Schema 2020-12 validator",
          "keep a repository's RECX.yaml valid as a Claude Code session ends",
          "search published manifests for reusable modules that match a planned task"
        ],
        "tags": [
          "agents",
          "manifest",
          "code-reuse",
          "discovery",
          "json-schema"
        ],
        "modules": [
          {
            "id": "schema",
            "path": "spec/recx.schema.json",
            "summary": "The JSON Schema that defines a valid RECX.yaml.",
            "interface": {
              "type": "schema",
              "entrypoints": [
                "uvx check-jsonschema --schemafile spec/recx.schema.json RECX.yaml"
              ]
            },
            "extract": {
              "method": "package",
              "package": "pkg:npm/%40jbmv/recx",
              "notes": "The schema is one self-contained file, so copying spec/recx.schema.json works too. In Python it ships inside recx-cli."
            }
          },
          {
            "id": "fixtures",
            "path": "spec/examples/",
            "summary": "Valid and invalid example manifests for testing any recx validator.",
            "interface": {
              "type": "other",
              "entrypoints": [
                "spec/examples/valid/*.yaml: every file must validate",
                "spec/examples/invalid/*.yaml: every file must be rejected, for the reason its first-line comment names",
                "spec/examples/invalid-rules/*.yaml: every file passes the schema alone but must be rejected by the rules beyond it (recx check --no-repo)"
              ]
            },
            "requires": {
              "modules": [
                "schema"
              ]
            },
            "extract": {
              "method": "package",
              "package": "pkg:npm/%40jbmv/recx",
              "notes": "Shipped as @jbmv/recx/examples/*, or copy spec/examples/."
            }
          },
          {
            "id": "validator",
            "path": "src/recx_cli/",
            "summary": "The recx check command, which validates a RECX.yaml against the schema and the rules beyond it.",
            "language": "python",
            "interface": {
              "type": "cli",
              "entrypoints": [
                "recx check [PATH] [--no-repo]",
                "recx evidence [PATH] [--list] [--only ID ...]",
                "recx search QUERY... [--json] [--limit N] [--language TAG] [--interface TYPE] [--license ID]",
                "recx show OWNER/NAME [--json]",
                "recx mcp",
                "recx_cli.search.search(query, limit=20) -> dict",
                "recx hook stop"
              ]
            },
            "requires": {
              "packages": [
                "pkg:pypi/jsonschema",
                "pkg:pypi/pyyaml"
              ],
              "modules": [
                "schema"
              ]
            },
            "extract": {
              "method": "package",
              "package": "pkg:pypi/recx-cli"
            }
          },
          {
            "id": "plugin",
            "path": "plugin/",
            "summary": "The Claude Code plugin, with the recx:manifest skill and a Stop and SubagentStop hook that keeps RECX.yaml valid.",
            "interface": {
              "type": "claude-code-plugin",
              "entrypoints": [
                "/plugin marketplace add jbmv/recx",
                "/plugin install recx@recx",
                "/recx:manifest"
              ]
            },
            "requires": {
              "modules": [
                "validator"
              ]
            },
            "extract": {
              "method": "copy",
              "notes": "Installing through the marketplace is the intended route; copying plugin/ works but the hook then needs recx-cli 0.1.1 or later."
            }
          },
          {
            "id": "search-plugin",
            "path": "plugin-search/",
            "summary": "An opt-in Claude Code plugin that starts recx's MCP server, with the recx_search and recx_show tools, and the recx-search:find skill on reading results safely.",
            "interface": {
              "type": "claude-code-plugin",
              "entrypoints": [
                "/plugin marketplace add jbmv/recx",
                "/plugin install recx-search@recx",
                "/recx-search:find"
              ]
            },
            "requires": {
              "packages": [
                "pkg:pypi/mcp"
              ],
              "modules": [
                "validator"
              ]
            },
            "extract": {
              "method": "copy",
              "notes": "Installing through the marketplace is the intended route; the server runs through uvx from recx-cli[mcp] 0.1.2 or later."
            }
          },
          {
            "id": "action",
            "path": "action.yml",
            "summary": "A composite GitHub Action that runs recx check, and optionally recx evidence, in a repository's CI.",
            "interface": {
              "type": "github-action",
              "entrypoints": [
                "uses: jbmv/recx@main"
              ]
            },
            "requires": {
              "modules": [
                "validator"
              ]
            },
            "extract": {
              "method": "copy",
              "notes": "Referencing it with \"uses:\" in a workflow is the intended route; copying action.yml works but it then installs recx-cli from PyPI like any user."
            }
          }
        ],
        "evidence": [
          {
            "id": "schema-is-valid",
            "summary": "The schema is itself a valid JSON Schema 2020-12 document.",
            "covers": [
              "schema"
            ]
          },
          {
            "id": "manifests-validate",
            "summary": "This manifest and the valid examples pass the schema.",
            "covers": [
              "schema",
              "fixtures"
            ]
          },
          {
            "id": "validator-tests",
            "summary": "The validator passes its tests, including every fixture.",
            "covers": [
              "validator",
              "schema",
              "fixtures"
            ]
          }
        ]
      }
    }
  ]
}
