sim-cli CLAUDE.md

Project instructions for sim-cli, a tool that reads engineering simulation files and turns them into structured text for an agent. It can also find local solver installations, check scripts and keep a solver session open across steps.

In plain words
What is it for?
Understanding the repository, scanning simulation files, discovering solver drivers, validating scripts and managing the project's tests and commands.
Why use it?
They explain which parts work without a solver installation and which require extra solver plugins. This helps an agent choose the right command and avoid assuming unavailable runtime features.

Instructions file

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 instructions/svd-ai-lab/sim-cli/claude-md
Clone the repo
git clone --depth 1 https://github.com/svd-ai-lab/sim-cli
Per session 4,423 This file is loaded in full into every session.
When invoked 4,423 The same file — it is already loaded in full.
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 $0.04423 $0.04423
Opus 5 $0.02211 $0.02211
Sonnet 5 $0.00885 $0.00885
Haiku 4.5 $0.00442 $0.00442

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

Security

Grade A, and why

sim-cli CLAUDE.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 3d 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.md · 239 lines

How it starts

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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

sim reads existing CAE files and turns them into structured text an agent can use, detects local solver installs, validates scripts, and can hold a live solver session open across steps. The pyproject.toml description — "Agent-native simulation asset parsing and CAD/CAE runtime" — states the priority correctly: parsing first, runtime second.

Know which tier you are working in, because their dependencies differ:

  • Asset parsing (sim scan) — pure core, no plugin, no solver, no license. Backed by the simparse native extension, a hard dependency of sim-cli-core. This is the most-used capability in practice: agents can already drive solver GUIs directly, so the highest-value thing sim does today is recover engineering context from historical case files (a preprocessing step, closer to a document-to-structured-text converter than to a solver driver).
  • Solver discovery and script validation (sim check, sim lint) — require the solver's plugin. With no plugins installed, check --all reports "scanned 0 drivers" and lint errors with No registered driver claims ....
  • Execution — requires a plugin, and comes in two modes:
    • One-shot (sim run script --solver=X): subprocess execution, result stored as a numbered run, sim logs to browse.
    • Persistent session (sim connect/exec/inspect/disconnect): a long-lived HTTP server holds a live solver session; agents send code snippets and inspect state without restarting the solver. sim connect auto-starts a local server when none is reachable (session.py:_auto_start_server), so sim serve is only needed explicitly for remote hosts — and sim stop is the counterpart that reaps that background process.

This tiering is load-bearing for docs and error messages: never imply sim scan needs a plugin, and never imply sim check works without one.

Read the full file on GitHub · 239 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. 3d ago First seen · 239 lines · 4,423 tokens per session scan A f265452b8fbb

Subscribe to this mod's changes

sim-cli CLAUDE.md is an instructions file published in the GitHub repository svd-ai-lab/sim-cli (213 stars, last pushed 5d ago), licensed Apache-2.0. It adds 4,423 tokens to every session, about $0.0221 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 instructions, from other repositories

awesome-ai-cae CLAUDE.md

Instructions for kimimgo/awesome-ai-cae, covering claude.md, project info, ci — lint & link check, awesome-lint: readme.md 포맷 검증 (push/pr 시 자동 실행) and lychee: 링크 깨짐 검사 (push/pr + 매주 월요일 06:00 utc).

kimimgo/awesome-ai-cae · 925 tokens

chrono AGENTS.md

AGENTS.md instructions for projectchrono/chrono, covering repository guidelines, developers vs. users, project structure & module organization, build, test, and development commands and physics manuals & demo-first workflow.

projectchrono/chrono · 1,321 tokens

Foam-Agent AGENTS.md

Instructions for csml-rpi/Foam-Agent, covering agents.md, what is foam-agent?, build and run, environment setup and run a simulation.

csml-rpi/Foam-Agent · 1,630 tokens

cad-cae-copilot AGENTS.md

Instructions for armpro24-blip/cad-cae-copilot, covering aieng workbench — agent guide, stop — read this first, first three calls every session, workflow priority matrix and workspace layout.

armpro24-blip/cad-cae-copilot · 33,450 tokens

omnisim AGENTS.md

Instructions for omnilink-tech/omnisim, covering agents.md — running omnisim as an ai coding agent, 0. for agents: read this first (60 seconds), run this first turn, first moves by task type and hard-won rules (don't relearn these).

omnilink-tech/omnisim · 49,325 tokens

viznoir CLAUDE.md

Instructions for kimimgo/viznoir, covering claude.md, viznoir, project info, development commands and install (editable with dev deps).

kimimgo/viznoir · 2,647 tokens