EverMe AGENTS.md

Repository instructions for EverMe that define one goal per pull request, build and test commands, checks before submission, and commit and pull-request rules.

In plain words
What is it for?
Building and testing the CLI and plugins, running pre-submission checks, and preparing commits and pull requests.
Why use it?
They give an AI a clear checklist for validating changes and help prevent failed checks, unwanted generated files, or unclear commits.

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/evermind-ai/everme/agents-md
Clone the repo
git clone --depth 1 https://github.com/EverMind-AI/EverMe

Made for: Codex, OpenCode.

Per session 938 This file is loaded in full into every session.
When invoked 938 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.00938 $0.00938
Opus 5 $0.00469 $0.00469
Sonnet 5 $0.00188 $0.00188
Haiku 4.5 $0.00094 $0.00094

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

Security

Grade A, and why

EverMe 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 3d 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 · 91 lines

How it starts

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

AGENTS.md

Goal (pick one per PR)

  • Make CLI better: improve UX, error messages, help text, flags, and output clarity.
  • Improve plugin reliability: fix host integration bugs, edge cases, and regressions with tests.
  • Improve developer velocity: simplify code paths, reduce complexity, keep behavior explicit.
  • Improve quality gates: strengthen tests, packaging checks, and security checks without adding heavy process.

Build & Test

cd cli && make build
cd cli && make test
cd plugins && npm ci
cd plugins && npm test --workspaces --if-present

Pre-PR Checks (match CI gates)

  1. cd cli && go test ./... -count=1
  2. cd cli && go vet ./...
  3. cd cli && gofmt -l . — must produce no output.
  4. cd cli && go mod tidy — must not change go.mod / go.sum.
  5. cd plugins && npm ci
  6. cd plugins && npm test --workspaces --if-present
  7. cd plugins && npm audit --audit-level=moderate
  8. Verify no generated artifacts are present: cli/_output, cli/dist, plugins/node_modules, *.tar.gz, *.zip, .env*.

Commit & PR

  • Conventional Commits in English: feat:, fix:, docs:, test:, refactor:, chore:, ci:.
  • PR title should use the same format.
  • Fill .github/pull_request_template.md completely.
  • Never commit secrets, tokens, private URLs, internal logs, or generated build artifacts.

Source Layout

Path What it does
cli/cmd/ Cobra command surface for auth, plugin install, import, and doctor.
cli/internal/client/ EverMe gateway HTTP client and envelope handling.
cli/internal/output/ CLI output contract, exit codes, and redaction.
cli/internal/plugin/ Host config writers for Codex, Claude Code, Claude Desktop, Cursor, OpenClaw, Hermes, and MCP.
cli/internal/importer/ Cold-start memory import scanning and upload flow.
plugins/agent-sdk/ Shared JavaScript client and host-agnostic helpers.
plugins/memory-mcp/ Generic MCP server for memory recall and writes.
plugins/claude-code/ Claude Code native plugin: hooks, slash commands, skill, and MCP server.
plugins/openclaw/ OpenClaw ContextEngine plugin.
plugins/cli/ npm wrapper that downloads and runs the platform-native evercli binary.
plugins/everme/ Codex marketplace plugin and memory skill.

Read the full file on GitHub · 91 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. 3d ago First seen · 91 lines · 938 tokens per session scan A 825bcb5e9c01

Subscribe to this mod's changes

EverMe AGENTS.md is an instructions file published in the GitHub repository EverMind-AI/EverMe (57 stars, last pushed 5d ago), licensed Apache-2.0. It adds 938 tokens to every session, about $0.0047 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.