agentmods.dev

pyenv-native AGENTS.md

Repository guidance for coding agents working on pyenv-native, a tool for managing Python versions, or using it in another project. It sets reading order, instruction priority, supported systems, and development rules.

In plain words
What is it for?
Use it when changing pyenv-native's Rust code or packaging, installing it, or using its agent-facing tools to manage Python environments.
Why use it?
It gives the agent the project context and constraints needed to make safe changes or use the tool correctly. This reduces guesswork about installation, packaging, platform support, and testing.

Instructions file for CodexOpenCode

2 15d ago A scan 716 tokens original MIT
View the source file ImYourBoyRoy/pyenv-native
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/imyourboyroy/pyenv-native/agents-md
Clone the repo
git clone --depth 1 https://github.com/ImYourBoyRoy/pyenv-native

Made for: Codex, OpenCode.

Per session 716 This file is loaded in full into every session.
When invoked 716 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.00716 $0.00716
Opus 5 $0.00358 $0.00358
Sonnet 5 $0.00143 $0.00143
Haiku 4.5 $0.00072 $0.00072

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

Security

Grade A, and why

pyenv-native AGENTS.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 2d 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.

AGENTS.md · 66 lines

How it starts

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

pyenv-native — Agent Instructions

Repo-local rules for AI agents working on pyenv-native or using it to manage Python on a workstation/project.

Read first (in order)

  1. README.md — product overview and install entry points
  2. docs/INSTRUCTIONS.md — full install, shell init, workflows, troubleshooting
  3. docs/MCP.md — agent-facing MCP tools and recommended tool order
  4. docs/CLI.md — human CLI reference
  5. docs/ARCHITECTURE.md — Rust crate layout when changing code
  6. docs/cursor-setup.md — install this repo's Cursor skill

Instruction precedence

  1. Explicit user request
  2. This AGENTS.md
  3. docs/MCP.md for environment/runtime tasks (prefer MCP over shell guessing)
  4. README.md / docs/INSTRUCTIONS.md
  5. Tool defaults

When working ON this repo (Rust / packaging)

  • Supported platforms: Windows, Linux, and macOS. Exercise install and resolution on the OS you touch. Android/Termux is experimental (source builds).
  • Use existing scripts: scripts/dev-cargo.ps1, scripts/build-release-bundle.ps1.
  • Every install path must ship both pyenv and pyenv-mcp.
  • Run cargo test in affected crates before claiming success.
  • Do not break the version-selection precedence: shell → local .python-version → parents → global → system.
  • Managed venvs live under PYENV_ROOT/venvs/<runtime>/<name>; prefer pyenv venv over ad-hoc .venv when documenting agent flows.

When USING pyenv-native on another project

  1. Prefer pyenv-mcp tools when MCP is configured (get_toolkit_guide → resolve_project_environment → ensure_runtime → ensure_project_venv).
  2. If MCP is unavailable, use CLI: pyenv local, pyenv install, pyenv venv create, pyenv which python.
  3. Never pip install into an unknown global Python without resolving the active interpreter first.
  4. On Windows, use PowerShell 7+ (pwsh); run pyenv doctor when PATH/shim issues appear.
  5. Orientation blob for smaller models: pyenv-mcp guide (JSON).

Read the full file on GitHub · 66 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. 2d ago First seen · 66 lines · 716 tokens per session scan A d55dbd5c0281

Subscribe to this mod's changes

pyenv-native AGENTS.md is an instructions file published in the GitHub repository ImYourBoyRoy/pyenv-native (2 stars, last pushed 15d ago), licensed MIT. It adds 716 tokens to every session, about $0.0036 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.

agentic-toolsagentic-workflowsai-agentai-agentsautomationcli
Related

Other instructions, from other repositories

nextclaw AGENTS.md

Instructions for Peiiii/nextclaw, covering nextclaw ai 常驻内核, 产品愿景, 沟通与推进, 深思与目标模式 and 协作与 git 安全.

Peiiii/nextclaw · 3,095 tokens

dotskills AGENTS.md

Instructions for vincentkoc/dotskills, covering agents.md, repository purpose, mandatory contribution flow, skill standards and openai metadata defaults.

vincentkoc/dotskills · 892 tokens

FMT-exocortex-template CLAUDE.md

Claude Code instructions for TserenTserenov/FMT-exocortex-template, covering инструкции для всех репозиториев, 1. архитектура репозиториев, 2. орз-фрактал (открытие → работа → закрытие), блокирующие правила and протокол работы (полный → memory/protocol-work.md).

TserenTserenov/FMT-exocortex-template · 4,800 tokens

asap-protocol AGENTS.md

AGENTS.md instructions for asap-protocol/asap-protocol, covering agents.md, project context, quick start, agent guidance (rules vs skills) and knowledge map.

asap-protocol/asap-protocol · 1,995 tokens

slipway AGENTS.md

Instructions for signalridge/slipway, covering slipway agent principles, user owns the process, investigate before clarifying, report, do not certify and maintain the whole surface.

signalridge/slipway · 470 tokens

ai-workflows AGENTS.md

Instructions for dryvist/ai-workflows, covering ai-workflows, architecture, directory structure, workflow types and consumer repo caller pattern.

dryvist/ai-workflows · 1,766 tokens