aspens: Instructions file for Codex

AGENTS.md

aspens AGENTS.md is an instructions file for Codex, OpenCode from aspenkit/aspens. It costs 1,046 tokens per session, scanned A, original, MIT.

Repository instructions for aspenkit/aspens, a project for managing agent instructions, skills, commands, releases, and conventions.

In plain words
What is it for?
Use them when working on aspens features such as agent customization, command-line behavior, documentation sync, import graphs, or multi-target output.
Why use it?
They give coding agents the project-specific context needed to change the repository consistently and use its documented workflows.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions CLAUDE.md; mentions Claude Code; mentions Codex.

This is aspenkit/aspens's own configuration. It tells Codex and OpenCode how to work on aspens itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything aspens configures →

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/MV/aspenkit/dev/release.md.

Reuse

Borrowing it

Nothing to install: this file belongs to aspenkit/aspens. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/aspenkit/aspens/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/aspenkit/aspens

Made for: Codex, OpenCode.

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 aspens AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/aspenkit/aspens/agents-md/github.svg)](https://agentmods.dev/instructions/aspenkit/aspens/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/aspenkit/aspens/agents-md"><img src="https://agentmods.dev/badge/instructions/aspenkit/aspens/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for aspens AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/aspenkit/aspens/agents-md"><img src="https://agentmods.dev/badge/instructions/aspenkit/aspens/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,046 This file is loaded in full into every session.
When invoked 1,046 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.01046 $0.01046
Opus 5.5 $0.00418 $0.00418
Sonnet 5.5 $0.00209 $0.00209
Haiku 4.5 $0.00105 $0.00105

Measured 1mo ago against content hash 9986f2cf185f, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

aspens 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 1mo 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 51 lines

How it starts

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

aspens

Skills

  • .agents/skills/base/SKILL.md — Base repo skill; load whenever working in this repo.
  • .agents/skills/agent-customization/SKILL.md — LLM-powered injection of project context into installed agent templates via aspens customize agents
  • .agents/skills/claude-runner/SKILL.md — Claude/Codex CLI execution layer — prompt loading, stream-json parsing, file output extraction, path sanitization, skill file writing, and skill rule generation
  • .agents/skills/cli-shell/SKILL.md — Top-level Commander wiring, welcome screen, missing-hook warning, CliError exit handling, and the public programmatic API surface
  • .agents/skills/codex-support/SKILL.md — Multi-target output system — target abstraction, backend routing, content transforms for Codex CLI and future targets
  • .agents/skills/doc-impact/SKILL.md — Context health analysis — freshness, domain coverage, hub surfacing, drift detection, LLM-powered interpretation, and auto-repair for generated agent context
  • .agents/skills/doc-sync/SKILL.md — Incremental skill updater that maps git diffs to affected skills and optionally auto-syncs via a post-commit hook
  • .agents/skills/import-graph/SKILL.md — Static import analysis that builds dependency graphs, domain clusters, hub files, git churn hotspots, and file priority rankings
  • .agents/skills/repo-scanning/SKILL.md — Deterministic repo analysis — language/framework detection, structure mapping, domain discovery, health checks, and import graph integration
  • .agents/skills/save-tokens/SKILL.md — Token-saving session automation — statusline, prompt guard, precompact handoffs, session rotation, and handoff commands for Claude Code
  • .agents/skills/skill-generation/SKILL.md — LLM-powered generation pipeline for Claude Code skills and CLAUDE.md — doc-init command, prompt system, context building, and output parsing
  • .agents/skills/template-library/SKILL.md — Bundled agents, commands, hooks, and settings that users install via aspens add, aspens doc init, and aspens save-tokens into their .claude/ directories
  • .agents/skills/architecture/SKILL.md — Import graph and code-map reference for structural changes.

Read the full file on GitHub · 51 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. 1mo ago First seen · 51 lines · 1,046 tokens per session scan A 9986f2cf185f

Subscribe to this mod's changes

aspens AGENTS.md is an instructions file published in the GitHub repository aspenkit/aspens (103 stars, last pushed 1mo ago), licensed MIT. It adds 1,046 tokens to every session, about $0.0042 per session on Opus 5.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

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,786 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens