Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/despotb/handelsregister-cli/gemini-mdgit clone --depth 1 https://github.com/DespotB/handelsregister-cliWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00390 | $0.00390 |
| Opus 5 | $0.00195 | $0.00195 |
| Sonnet 5 | $0.00078 | $0.00078 |
| Haiku 4.5 | $0.00039 | $0.00039 |
Grade A, and why
handelsregister-cli GEMINI.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Handelsregister document fetch (Gemini CLI extension)
This extension wraps the hreg CLI from this repository to fetch official
registry documents for German companies from handelsregister.de.
Rules
- Ensure the CLI is available: run
hreg --version. If missing, install with the first available tool —uv tool install,pipx install, orpip install --user— each withgit+https://github.com/DespotB/handelsregister-cli. Ifhregis still not found, the install bin dir is likely not on PATH: try~/.local/bin/hreg. If all fail, tell the user and stop. - Always search before fetching:
hreg search "<keywords>" --json. If several plausible companies match, ask which one is meant unless the user already provided a register number. - Fetch with
hreg fetch "<keywords>" --register "<HRB/HRA number>" -o "<outdir>" --json. Honour a narrower request via--docs AD,CD,SI,DK. Never lower--delaybelow 3 and never loop over company lists: the portal rate-limits at roughly 60 requests/hour. A full fetch takes a few minutes by design. - Afterwards read
manifest.jsonin the output directory and summarise what was downloaded (highlight Gesellschafterlisten and Gesellschaftsverträge with dates), what was skipped, and where the files are. - Registry documents contain personal data (names, birth dates, addresses). Do not send their contents to external services unprompted.
- On parsing errors the portal layout may have changed: point the user to https://github.com/DespotB/handelsregister-cli/issues instead of retrying.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 28 lines · 390 tokens per session scan A b73e9e95e283
handelsregister-cli GEMINI.md is an instructions file published in the GitHub repository DespotB/handelsregister-cli (1 stars, last pushed 8d ago), licensed MIT. It adds 390 tokens to every session, about $0.0019 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
abfall-mcp-server AGENTS.md
AGENTS.md instructions for AlpayC/abfall-mcp-server, covering notes for coding agents, setup, commands, the one principle and traps.
kleinanzeigen-reader CLAUDE.md
Instructions for its-me-prash/kleinanzeigen-reader, covering claude.md — kleinanzeigen-reader, what this repo is, auto-load instructions for claude code, quick command reference and fetch a listing.
kleinanzeigen-reader AGENTS.md
Instructions for its-me-prash/kleinanzeigen-reader, covering agents.md — kleinanzeigen-reader, what this is, how an agent should use it, cli — machine-readable json for any system to consume and python api.
register-mcp CLAUDE.md
Claude Code instructions for malkreide/register-mcp, covering claude.md, teil 1 — portfolio-weite konventionen, vor der arbeit, tests and wenn etwas rot ist.
abfall-mcp-server CLAUDE.md
Claude Code instructions for AlpayC/abfall-mcp-server: Project instructions live in AGENTS.md, tool-neutral, and are imported here so there is only one source.
northdata-connectors CLAUDE.md
Claude Code instructions for p-meier/northdata-connectors, covering northdata-connectors — dev notes, repo-layout, sub-pakete, northdata-cli/ and northdata-mcp/.