ras-commander-api-expert

ras-commander-api-expert is an agent for Claude Code from gpt-cmdr/ras-commander. It costs 122 tokens per session (2,498 once invoked), scanned A, original, MIT.

An expert guide to the ras-commander programming library for working with HEC-RAS projects. HEC-RAS is software for modelling rivers, floods, and waterways.

In plain words
What is it for?
Use it to discover API methods, understand project tables and return values, find integration examples, and identify gaps in the library’s API documentation.
Why use it?
It helps developers find the right library methods and understand the data structures returned by them without reading the entire codebase or using unsuitable shortcuts.

Agent for Claude Code

Install

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.

agentmods
npx agentmods add agents/gpt-cmdr/ras-commander/ras-commander-api-expert
Clone the repo
git clone --depth 1 https://github.com/gpt-cmdr/ras-commander

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ras-commander-api-expert

README.md
[![agentmods](https://agentmods.dev/badge/agents/gpt-cmdr/ras-commander/ras-commander-api-expert.svg)](https://agentmods.dev/agents/gpt-cmdr/ras-commander/ras-commander-api-expert)
Your own site
<a href="https://agentmods.dev/agents/gpt-cmdr/ras-commander/ras-commander-api-expert"><img src="https://agentmods.dev/badge/agents/gpt-cmdr/ras-commander/ras-commander-api-expert.svg" alt="Measured on agentmods" height="20"></a>
Per session 122 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,498 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00122 $0.02498
Opus 5 $0.00061 $0.01249
Sonnet 5 $0.00024 $0.00500
Haiku 4.5 $0.00012 $0.00250

Measured 5d ago against content hash ff9718c3fe9f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

ras-commander-api-expert 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 5d ago.

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.

.claude/agents/ras-commander-api-expert.md · 328 lines

How it starts

The opening of the file, as written. The whole thing — 328 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Exception Status: Exploration Permitted

This agent IS the designated exception to the API-First Principle.

Why This Agent Can Use Explore/Bash/Grep

  1. Purpose is API discovery: This agent's job is to find and document API methods, not extract HEC-RAS model data
  2. Library is large: ras-commander has ~50+ modules that don't fit in context
  3. Spawns exploration subagents: Explicitly designed to use Haiku subagents for codebase search
  4. Does NOT extract model data: Never uses exploration to bypass API for data extraction

What This Agent Does

  • Searches codebase for method signatures
  • Documents DataFrame structures
  • Finds example usage patterns
  • Identifies API gaps
  • Coordinates API documentation

What This Agent Does NOT Do

  • Extract HEC-RAS model data (WSE, velocity, geometry)
  • Bypass DataFrames to read project files
  • Use h5py directly instead of HdfResultsPlan
  • Parse .g## files instead of GeomCrossSection

This Exception Does NOT Extend To

The following agents MUST use the API-First Principle and MUST NOT use Explore/Bash for data extraction:

  • hecras-project-inspector - Must use DataFrames
  • hdf-analyst - Must use HdfResults* classes
  • hecras-results-analyst - Must use HdfResultsPlan/HdfResultsMesh
  • geometry-parser - Must use Geom* classes
  • hecras-general-agent - Must include API-first context in dispatches

See .claude/rules/python/api-first-principle.md for the complete API-First Principle.


RAS Commander API Expert Subagent

Navigate the ras-commander Python library API. The library is large and sprawling -- it does NOT fit in a single context window. Spawn lightweight subagents to explore the codebase and coordinate findings via markdown files.

Your Mission

Help users integrate with ras-commander by:

  1. Finding the right functions/classes for their use case
  2. Explaining dataframe structures and column meanings
  3. Demonstrating end-to-end workflows
  4. Coordinating research via agent_tasks/ras-commander-api-research/

Read the full file on GitHub · 328 lines

Changes

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.

  1. 5d ago First seen · 328 lines · 122 tokens per session scan A ff9718c3fe9f

Subscribe to this mod's changes

ras-commander-api-expert is an agent published in the GitHub repository gpt-cmdr/ras-commander (79 stars, last pushed today), licensed MIT. It adds 122 tokens to every session and 2,498 once invoked, about $0.0006 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-30.

Related

Other agents, from other repositories

Geoprocessing Specialist

ArcPy and Python toolbox expert who automates spatial workflows — builds .pyt toolboxes, Model Builder processes, batch geoprocessing automation, and custom analysis scripts for ArcGIS Pro.

SHAdd0WTAka/Zen-Ai-Pentest · 45 tokens

coder

Specialized sub-agent for the AI co-mathematician system. Implements Python code for computational exploration, numerical verification, and search — with mandatory tests and golden values. Cannot mark its work complete until tests pass and a reviewer accepts the golden values. Use when the project-coordinator…

morankor/theorist-toolbox · 78 tokens

proof-decomposer-prompt

You are a specialized agent for decomposing long Lean 4 proofs to mathlib quality standards.

CBirkbeck/mathlib-quality · 0 tokens

pymc-specialist

Expert in current PyMC for Bayesian modeling in Python. Creates and debugs PyMC models using modern syntax, understands distribution parameterizations, sampling methods, and ArviZ diagnostics integration.

choxos/BiostatAgent · 43 tokens

iris-hep-coder

This agent will write python code that will access ATLAS data, extract some items, and then make one or more plots. If the user's prompt doesn't fit that request, please complain. Generate code using ServiceX to fetch the data, Awkward array to manipulate the data that comes back (with vector for doing any physics…

iris-hep/marketplace · 0 tokens

SciTeXTranslatorAgent

Knows SciTeX usage with proper formats. Translates existing codebase, including scripts contents and file organization, into SciTeX structures. Not applicable to src or tests but to ./scripts and ./examples. For examples development, please call at the final stage as this agent can translate working python code to be…

scitex-ai/claude-code-telegrammer · 84 tokens