go-authcrunch: Skill for Codex

.codex/skills/runtime-state/SKILL.md

runtime-state is a skill for Codex from greenpau/go-authcrunch. It costs 49 tokens per session (3,291 once invoked), scanned A, original, Apache-2.0.

An implementation guide for retaining application runtime state across restarts. It covers local storage, encrypted records, generated keys, OAuth sessions, identity history, configuration parsing, and restart tests.

In plain words
What is it for?
Use it to add or maintain optional state persistence for portal-based or portal-free OAuth sessions, refresh and replay history, and local identity epochs.
Why use it?
Without persistent state, sessions and other runtime information can disappear when a service restarts. The guide also sets boundaries for storage location, permissions, validation, and lifecycle handling.

Skill for Codex

Written for Codex: agents/openai.yaml present.

This is greenpau/go-authcrunch's own configuration. It tells Codex how to work on go-authcrunch 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 go-authcrunch configures →

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is make test TEST_DIR='./pkg/state/... ./pkg/user ./pkg/kms ./pkg/authn ./pkg/authn/cache ./pkg/authn/token_refresh ./pkg/authz ./pkg/identity ./pkg/oidc . ./cmd/a.

Reuse

Borrowing it

Nothing to install: this file belongs to greenpau/go-authcrunch. 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/greenpau/go-authcrunch/main/.codex/skills/runtime-state/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/greenpau/go-authcrunch

Made for: Codex.

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 runtime-state

README.md
[![agentmods](https://agentmods.dev/badge/skills/greenpau/go-authcrunch/runtime-state/github.svg)](https://agentmods.dev/skills/greenpau/go-authcrunch/runtime-state)
Your own site
<a href="https://agentmods.dev/skills/greenpau/go-authcrunch/runtime-state"><img src="https://agentmods.dev/badge/skills/greenpau/go-authcrunch/runtime-state/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 runtime-state

Your own site · 80×15
<a href="https://agentmods.dev/skills/greenpau/go-authcrunch/runtime-state"><img src="https://agentmods.dev/badge/skills/greenpau/go-authcrunch/runtime-state.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,291 The whole file, excluding the scripts and references it only reads on demand.
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.00049 $0.03291
Opus 5.5 $0.00020 $0.01316
Sonnet 5.5 $0.00010 $0.00658
Haiku 4.5 $0.00005 $0.00329

Measured 12d ago against content hash ba1e8e988bf5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

runtime-state 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 12d 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.

.codex/skills/runtime-state/SKILL.md · 249 lines

How it starts

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

Runtime State

Configuration and ownership

authcrunch.Config.State (state) opts the root runtime into persistence with *state.Config. Omission keeps the previous volatile behavior unless a portal selects a managed refresh store, which requires root state. A present empty configuration is invalid. The only setting is Directory (directory), an absolute non-root path. Validation normalizes it without filesystem writes.

pkg/state/parser.NewStateConfigFromDirectives(statements) parses exactly one encoded directory PATH body statement. Hosts own traversal, placeholders and cfgutil.EncodeArgs; the public parser owns grammar and typed validation. Empty blocks, duplicates, unknown settings and extra arguments fail. Apply the result to Config.State before NewServer. There are no Docker, Caddy, HTTP, environment-variable or global-directory dependencies.

Read configuration and operations for retained state, restart guarantees, backups and deployment limits. Hosts adapt their configuration syntax to the public parser and coordinate runtime ownership. Do not change or run tooling in sibling repositories.

Storage invariants

pkg/state/{store,catalog,codec}.go owns Store and Record. state.Open creates private 0700 local storage, holds an exclusive advisory owner.lock, and reuses a private 0600 AES-256 key in master.key. Record filenames are SHA-256 hashes of trusted component names. AES-GCM authenticates the envelope version, binding and payload with the filename as associated data. A separately authenticated catalog detects missing committed records. Reject corruption, missing key/catalog, unsafe permissions, symlinks, and concurrent owners.

Use local Unix filesystems with reliable locks, atomic replacement and directory sync. Windows persistence fails closed: secure ACL and durable directory support are not implemented. Do not weaken commits to make an unsupported platform pass. When creating a state directory hierarchy, sync the containing directories too; syncing records alone does not persist newly created directory entries.

Read the full file on GitHub · 249 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 12d ago Changed · +51 lines ba1e8e988bf5
  2. 17d ago Changed · +10 lines b9112fee44e3
  3. 26d ago Changed · +10 lines 521b6d27669c
  4. 1mo ago Changed · +1 lines 04243bc3de4c
  5. 1mo ago First seen · 177 lines · 49 tokens per session scan A 708b352914e1

Subscribe to this mod's changes

runtime-state is a skill published in the GitHub repository greenpau/go-authcrunch (60 stars, last pushed 10d ago), licensed Apache-2.0. It adds 49 tokens to every session and 3,291 once invoked, about $0.0002 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-09-21.

Related

runtime-state compared with skills from other repositories

runtime-state next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
runtime-stategreenpau/go-authcrunchSkill6010d agoApache-2.0A49Codex
mem0-oss-to-platformmem0ai/mem0Skill68k2d agoApache-2.0A217Claude Code, Codex
azure-mgmt-botservice-dotnetmicrosoft/skillsSkill3.2kyesterdayMITA78Claude Code
fastapi-router-pymicrosoft/skillsSkill3.2kyesterdayMITA46Claude Code
dev-runtimelangwatch/langwatchSkill5.0kyesterdayApache-2.0A172Claude Code
api-designericrisco/rsc-harnessSkill5032d agoMITA105Claude Code, Codex
migrate-segw-to-raparc-mcp/arc-1Skill252yesterdayMITA106Claude Code