A set of expansions and tools for Claude Code that enable AI agents to work at a high level with ADIOS2 data and files. Provides 5+ tools, 1 skill.
The ADIOS2 sibling of agentic-hdf5.
Claude Code must be installed. The MCP server is fetched and run via uvx, so uv must also be installed — all Python dependencies (adios2, numpy, matplotlib, etc.) are resolved automatically.
Run these slash commands inside a Claude Code session to register the plugin marketplace and install the plugin:
# Add the marketplace (one-time)
/plugin marketplace add ornladios/agentic-ADIOS2
# Install the plugin
/plugin install aadios2-plugin@agentic-adios2This gives you all 1 skill and 5+ MCP tools automatically. After installing, restart your Claude Code session for the plugin to take effect.
For development/testing, clone the repo and load the plugin directly:
git clone https://github.com/ornladios/agentic-ADIOS2.git
claude --plugin-dir ./agentic-ADIOS2/pluginAgentic ADIOS2 is composed of two complementary layers — tools and skills — that can be used independently or together.
Tools are Python functions that agents call to perform concrete operations on ADIOS2 files. They handle the actual file I/O: reading metadata, rewriting files with different engines or compression operators, and generating visualizations. Tools live in the tools/ directory and are registered in tools/tool_catalog.json.
| Tool | Description |
|---|---|
get_object_metadata |
Inspect files/variables (shape, dtype, steps, min/max, attributes) — like bpls |
reorganize_file |
Rewrite a file with a different engine (BP4→BP5) or engine parameters (aggregation) |
apply_operator_dataset |
Apply or remove compression operators (bzip2, blosc2, zfp, sz, mgard, png) |
visualize |
Generate plots from variables at any step (line, heatmap, histogram, contour, etc.) |
markdown_to_pdf |
Convert Markdown (with LaTeX math) to PDF via pandoc |
Skills are curated knowledge documents that teach the agent how and when to apply ADIOS2 best practices. They are loaded on-demand when a user's request matches the skill's domain. Skills live in plugin/skills/.
| Skill | Domain |
|---|---|
adios2-gpu-aware |
Device buffers (CUDA/HIP/SYCL/Kokkos) |
- Skills alone — An agent can use skill knowledge to advise on ADIOS2 best practices (e.g., recommending an aggregation setup) without modifying any files.
- Tools alone — An agent can call tools to inspect, optimize, or annotate files using the tool's built-in logic, without loading any skill context.
- Skills + Tools — The most powerful mode. A skill provides expert knowledge (e.g., which compression operator fits the data), and the agent then uses tools to apply that knowledge to specific files.
python -m pytest tests/