Submit

Accept new tools through review, not through direct uploads.

The safest path is still GitHub: open an issue, add `tool.yaml` and `examples.jsonl` in a PR, include a valid `parent_id` for the hierarchical model, then run the registry builder before merge.

Submission Checklist

Public upstream repository and a clear license.

A category that already exists or a strong case for a new one.

A valid parent_id for the hierarchical model.

At least three distinct natural-language examples.

Parameters that are practical, minimal, and not overfit to one benchmark.

Contribution Flow

1. Open the tool submission issue template and describe the open-source project.
2. Add `registry/tools/<tool-id>/tool.yaml` and `examples.jsonl` in a pull request.
3. Set a valid `parent_id` so the hierarchical model has the right parent label.
4. Run `python3 scripts/build_registry.py` and include the generated diff.
5. After merge, the next training snapshot and Hugging Face release can include the tool.

tool.yaml

id: ripgrep.search
display_name: Ripgrep Search
description: Search file contents recursively with fast regex-aware text matching.
interface_type: cli
source_repo: https://github.com/BurntSushi/ripgrep
license: MIT OR Unlicense
maintainers:
  - your-handle
parent_id: filesystem.search
tags:
  - search
  - grep
parameters:
  type: object
  properties:
    pattern:
      type: string
  required:
    - pattern

examples.jsonl

{"query":"Find every TODO under src","split":"train","language":"en"}
{"query":"Search recursively for CUDA references in this repo","split":"train","language":"en"}
{"query":"Look for postgres mentions in markdown files","split":"train","language":"en"}