waggle-memory

waggle-memory is a skill for Claude Code, Codex from hashgraph-online/awesome-codex-plugins. It costs 31 tokens per session (805 once invoked), scanned A, original, Apache-2.0.

A local project memory system that stores durable decisions and constraints for a coding project and retrieves them when needed.

In plain words
What is it for?
Use it at the start of meaningful project work to retrieve relevant context, and after important work to save decisions, constraints, bugs, or outcomes.
Why use it?
It reduces repeated explanations and helps keep work aligned with earlier project decisions across coding sessions.

Skill for Claude CodeCodex

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 skills/hashgraph-online/awesome-codex-plugins/waggle-memory
Any agent
npx skills add hashgraph-online/awesome-codex-plugins --skill waggle-memory
Clone the repo
git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins

Made for: Claude Code, 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 waggle-memory

README.md
[![agentmods](https://agentmods.dev/badge/skills/hashgraph-online/awesome-codex-plugins/waggle-memory.svg)](https://agentmods.dev/skills/hashgraph-online/awesome-codex-plugins/waggle-memory)
Your own site
<a href="https://agentmods.dev/skills/hashgraph-online/awesome-codex-plugins/waggle-memory"><img src="https://agentmods.dev/badge/skills/hashgraph-online/awesome-codex-plugins/waggle-memory.svg" alt="Measured on agentmods" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 805 The whole file, excluding the scripts and references it only reads on demand.
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.00031 $0.00805
Opus 5 $0.00015 $0.00402
Sonnet 5 $0.00006 $0.00161
Haiku 4.5 $0.00003 $0.00081

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

Security

Grade A, and why

waggle-memory 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 4d 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:

plugins/Abhigyan-Shekhar/Waggle-mcp/skills/waggle-memory/SKILL.md · 56 lines

How it starts

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

Waggle project memory

Treat Waggle as memory owned by the project, not as a transcript archive or generic personal chat memory.

Establish a stable scope

Before the first Waggle call in a task, choose one stable project value:

  1. Prefer the repository's canonical remote identity without credentials or a trailing .git, such as github.com/acme/api.
  2. If there is no remote, use the canonical absolute Git root path.
  3. Outside Git, use the canonical absolute workspace path.

Reuse that value across sessions. Do not use only a directory basename because unrelated repositories can share it. Pass agent_id: "codex" and the current task/session identifier when one is available. Never mix remembered context from a different project into the answer.

Retrieve selectively

  • At the beginning of a new task that involves meaningful project work, call prime_context once with the narrowest known scope.
  • Skip priming for greetings, trivial formatting, or questions fully answerable from the current prompt with no project-history dependency.
  • Before answering anything that may depend on earlier decisions, preferences, constraints, failed attempts, bugs, experiments, unresolved questions, or project state, call query_graph with the stable project scope. Start with max_nodes: 10, max_depth: 1, and retrieval_mode: "hybrid".
  • Use get_related when a returned node ID needs graph context, and graph_diff when the user asks what changed.
  • Treat retrieved memories as historical evidence, not current repository truth. Verify changeable facts against the working tree. If retrieval is empty or conflicts with current evidence, say so and do not invent history.

Store durable knowledge only

Use this threshold for every write:

Store information when forgetting it would likely cause duplicated work, a wrong future decision, or violation of an established constraint. Do not store something merely because it happened.

After a completed turn, call observe_conversation only when the turn crosses that threshold and contains durable project knowledge, such as:

Read the full file on GitHub · 56 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. 4d ago First seen · 56 lines · 31 tokens per session scan A 2e074f96f9a0

Subscribe to this mod's changes

waggle-memory is a skill published in the GitHub repository hashgraph-online/awesome-codex-plugins (859 stars, last pushed 6d ago), licensed Apache-2.0. It adds 31 tokens to every session and 805 once invoked, about $0.0002 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 skills, from other repositories

search

Search 2500+ curated ChatGPT and LLM open-source repositories. Use when the user asks to find tools, libraries, or repos related to ChatGPT, LLMs, RAG, agents, langchain, NLP, AI development, or any open-source AI tooling.

taishi-i/awesome-ChatGPT-repositories · 57 tokens

agentscope-developer

Expert-level AgentScope developer skill for building production-ready LLM agents. Transforms AI into an experienced AgentScope architect with deep knowledge of ReAct agents, multi-agent orchestration, memory modules, voice agents, MCP/A2A integrations, and model fine-tuning. Use when: building agents, agent framework…

theneoai/awesome-skills · 86 tokens

bio-clip-seq-clip-alignment

Align preprocessed CLIP-seq reads (eCLIP, iCLIP, iCLIP2, PAR-CLIP) to genome with STAR or bowtie2 using crosslink-preserving parameters, choosing between unique-mapper-only and multi-mapper-aware alignment for repeat-binding RBPs, deciding STAR vs HISAT2 memory trade-offs, and applying ENCODE-compatible filters. Use…

BioTender-max/awesome-bio-agent-skills · 117 tokens

detecting-fileless-malware-techniques

Detects and analyzes fileless malware that operates entirely in memory using PowerShell, WMI, .NET reflection, registry-resident payloads, and living-off-the-land binaries (LOLBins) without writing traditional executable files to disk. Activates for requests involving fileless threat detection, in-memory malware…

adriannoes/awesome-agentic-ai · 83 tokens

detecting-process-injection-techniques

Detects and analyzes process injection techniques used by malware including classic DLL injection, process hollowing, APC injection, thread hijacking, and reflective loading. Uses memory forensics, API monitoring, and behavioral analysis to identify injection artifacts. Activates for requests involving process…

adriannoes/awesome-agentic-ai · 78 tokens

performing-memory-forensics-with-volatility3

Analyze volatile memory dumps using Volatility 3 to extract running processes, network connections, loaded modules, and evidence of malicious activity.

adriannoes/awesome-agentic-ai · 36 tokens