gh-axi AGENTS.md

gh-axi AGENTS.md is an instructions file for Codex, OpenCode from kunchenguid/gh-axi. It costs 3,787 tokens per session, scanned A, original, MIT.

Repository-specific instructions for gh-axi, a command-line tool that uses the Axi software development kit.

In plain words
What is it for?
They guide dependency bumps, frozen-lockfile checks, use of the SDK-provided update command, releases, and changes to the installable skill.
Why use it?
They document project memory, dependency-update details, lockfile formatting, and the release process, reducing maintenance errors.

Instructions file for CodexOpenCode

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/kunchenguid/gh-axi/agents-md
Clone the repo
git clone --depth 1 https://github.com/kunchenguid/gh-axi

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 gh-axi AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/kunchenguid/gh-axi/agents-md.svg)](https://agentmods.dev/instructions/kunchenguid/gh-axi/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/kunchenguid/gh-axi/agents-md"><img src="https://agentmods.dev/badge/instructions/kunchenguid/gh-axi/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,787 This file is loaded in full into every session.
When invoked 3,787 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.1 $0.03787 $0.03787
Opus 5 $0.01894 $0.01894
Sonnet 5 $0.00757 $0.00757
Haiku 4.5 $0.00379 $0.00379

Measured yesterday against content hash 9e9bd42206b1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

gh-axi 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 yesterday.

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 · 121 lines

How it starts

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

Project agent memory

This file is the project's committed home for project-intrinsic agent knowledge: build, test, release, architecture, and sharp-edge notes that should travel with the code.

  • Add durable project-specific notes here as they are discovered through real work.

Dependency bumps and the lockfile

The committed pnpm-lock.yaml is Prettier-formatted (multi-line resolution: and engines: blocks), which is not pnpm's native output format. A plain pnpm install rewrites those blocks inline and produces a ~1000-line cosmetic churn even when only one dependency actually changed. After bumping a dependency, run pnpm exec prettier --write pnpm-lock.yaml so the diff collapses to just the real change. CI uses pnpm install --frozen-lockfile, which parses the YAML structurally and accepts the Prettier-formatted lockfile, so the formatting does not break the frozen-install check.

The SDK-provided update command

gh-axi runs its CLI through runAxiCli from axi-sdk-js (src/cli.ts) and registers no update command of its own. Since [email protected] ships update as a RESERVED_COMMANDS built-in, gh-axi inherits gh-axi update for free, and the SDK auto-resolves the npm package name (gh-axi) by walking up to the nearest package.json. The SDK also appends a "built-in": section to the top-level --help output at runtime, so src/cli.ts's TOP_HELP constant is a prefix of the rendered help rather than the whole thing.

Release process

Releases are cut by release-please from conventional commit messages on main; merging the bot's release PR triggers npm publish via .github/workflows/release-please.yml. Do not hand-edit CHANGELOG.md or .release-please-manifest.json (a guard workflow blocks PRs that touch them), and regenerate skills/gh-axi/SKILL.md with pnpm run build:skill instead of editing it directly.

Every pull_request workflow (ci.yml, guard-generated-files.yml, no-mistakes-required.yml) uses paths-ignore for the release-please output set (.release-please-manifest.json, CHANGELOG.md, package.json) so release PRs create zero runs. Job-level bot ifs stay as defense in depth. test/release-ci-exclusions.test.ts derives that set from release-please-config.json and fails if a workflow drifts; update the ignore lists when adding extra-files or changing release-type.

Read the full file on GitHub · 121 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. yesterday Changed · +14 lines · +487 tokens per session 9e9bd42206b1
  2. 5d ago First seen · 107 lines · 3,300 tokens per session scan A 8db08a74531a

Subscribe to this mod's changes

gh-axi AGENTS.md is an instructions file published in the GitHub repository kunchenguid/gh-axi (276 stars, last pushed 2d ago), licensed MIT. It adds 3,787 tokens to every session, about $0.0189 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

planning-with-files AGENTS.md

AGENTS.md instructions for OthmanAdi/planning-with-files, covering agents.md — planning-with-files agent reference card, commit rules, release checklist (12 steps), version bump scope and changelog format.

OthmanAdi/planning-with-files · 2,236 tokens

openrouter-mcp-multimodal AGENTS.md

AGENTS.md instructions for stabgan/openrouter-mcp-multimodal, covering agent instructions, before you ship, releasing (read this before publishing), short version and version files (must all match package.json).

stabgan/openrouter-mcp-multimodal · 793 tokens

OpenMicro AGENTS.md

Instructions for stephenleo/OpenMicro, covering openmicro — project conventions and releases.

stephenleo/OpenMicro · 123 tokens

ai-usagebar CLAUDE.md

Claude Code instructions for akitaonrails/ai-usagebar, covering claude.md, release checklist — must do all of these, hard invariants — never break these, secret-discipline rules (learned the hard way) and live api smoke discipline.

akitaonrails/ai-usagebar · 4,263 tokens

living-manual CLAUDE.md

Instructions for dougstanford/living-manual, covering living-manual, start of every session, how work lands — non-negotiable, user's manual (living-manual) and releasing.

dougstanford/living-manual · 1,108 tokens

yandex360-mcp CLAUDE.md

Claude Code instructions for pa1ch/yandex360-mcp, covering claude.md — гайд для ассистента, как устроен релиз (всё автоматически по тегу), процедура релиза (шаги ассистента), гарды and архитектура (кратко).

pa1ch/yandex360-mcp · 1,005 tokens