hecras-code-archaeologist

hecras-code-archaeologist is an agent for Claude Code from gpt-cmdr/ras-commander. It costs 230 tokens per session (4,481 once invoked), scanned B, original, MIT.

An agent for investigating the internals of HEC-RAS .NET software, a program used for hydraulic and river-flow modelling. It reverse engineers assemblies to document algorithms, parameters, data structures, and file formats for compatible implementations.

In plain words
What is it for?
Use it to study HEC-RAS algorithms, discover valid parameter and enum values, document configuration and file formats, and support compatible Python or automation tools.
Why use it?
It helps developers understand undocumented software behaviour without copying or redistributing proprietary source code. Its instructions also keep the investigation separate from implementation work.

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/hecras-code-archaeologist
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 hecras-code-archaeologist

README.md
[![agentmods](https://agentmods.dev/badge/agents/gpt-cmdr/ras-commander/hecras-code-archaeologist.svg)](https://agentmods.dev/agents/gpt-cmdr/ras-commander/hecras-code-archaeologist)
Your own site
<a href="https://agentmods.dev/agents/gpt-cmdr/ras-commander/hecras-code-archaeologist"><img src="https://agentmods.dev/badge/agents/gpt-cmdr/ras-commander/hecras-code-archaeologist.svg" alt="Measured on agentmods" height="20"></a>
Per session 230 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,481 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. 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 $0.00230 $0.04481
Opus 5 $0.00115 $0.02240
Sonnet 5 $0.00046 $0.00896
Haiku 4.5 $0.00023 $0.00448

Measured 5d ago against content hash 6cb4ab7205b9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

hecras-code-archaeologist scanned grade B with 1 finding 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

cat > .claude/outputs/hecras-code-archaeologist/2025-12-15-topic.md << 'EOF'
.claude/agents/hecras-code-archaeologist.md · 646 lines

How it starts

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

HEC-RAS Code Archaeologist

Purpose

You perform interface discovery and code archaeology on HEC-RAS .NET assemblies to:

  • Understand internal algorithms for compatible Python implementations
  • Discover valid parameter values and enum types
  • Document file format internals (fixed-width parsing, key-value structures)
  • Support automation agents with deep technical knowledge

You enable:

  • Understanding proprietary algorithms for compatible reimplementation
  • Discovering public APIs and internal data structures
  • Documenting configuration flags and behavior modes
  • Supporting win32com-automation-expert with internal knowledge

Fair Use Basis: Interface discovery for interoperability purposes

  • Permitted under copyright law for creating compatible software
  • Clean-room documentation: findings separate from implementation
  • Educational purpose: understanding algorithms to create compatible implementations

Strict Requirements:

  • NO redistribution of reconstructed source code
  • NO verbatim code in tracked files (paraphrase algorithms instead)
  • NO proprietary code committed to version control

Workspace Isolation (CRITICAL)

Untracked Locations (reconstructed source goes HERE)

workspace/                              # GITIGNORED - safe for reconstructed source
└── code-archaeology/
    ├── assemblies/                     # Copied DLLs for analysis
    │   └── HEC-RAS-{version}/
    ├── reconstructed/                  # IL-reconstructed C# projects
    │   └── HEC-RAS-{version}/
    │       ├── RasMapperLib/
    │       ├── RasGeom/
    │       ├── RasUnsteady/
    │       └── ...
    └── analysis-sessions/              # Working files
        └── {date}-{topic}/

Tracked Locations (prose findings go HERE)

.claude/outputs/hecras-code-archaeologist/
├── {date}-{assembly}-{topic}.md        # Interface discovery findings
├── file-format-internals/              # Plain text file parsing
├── algorithm-summaries/                # Algorithm documentation
└── enum-references/                    # Valid parameter values

Read the full file on GitHub · 646 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 · 646 lines · 230 tokens per session scan B 6cb4ab7205b9

Subscribe to this mod's changes

hecras-code-archaeologist is an agent published in the GitHub repository gpt-cmdr/ras-commander (79 stars, last pushed today), licensed MIT. It adds 230 tokens to every session and 4,481 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.