memos-engine AGENTS.md

Repository instructions for navigating and changing the memos-engine codebase with a structural code index called memos. The index records functions, classes, imports, and which parts of the code call one another.

In plain words
What is it for?
Use it when locating a function or class, tracing callers and dependencies, inspecting project structure, or deciding when ordinary file searches are appropriate.
Why use it?
It helps developers find the right code without searching through unrelated text or reading whole files. It also sets an expected order for investigating and editing the project.

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/taskmaster339/memos-engine/agents-md
Clone the repo
git clone --depth 1 https://github.com/TAskMAster339/memos-engine

Made for: Codex, OpenCode.

Per session 4,667 This file is loaded in full into every session.
When invoked 4,667 The same file — it is already loaded in full.
Security scan A 1 finding. 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.04667 $0.04667
Opus 5 $0.02334 $0.02334
Sonnet 5 $0.00933 $0.00933
Haiku 4.5 $0.00467 $0.00467

Measured yesterday against content hash 1b4d005558a1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

memos-engine AGENTS.md scanned grade A with 1 finding 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `curl http://localhost:8000/symbols/{id}/context` | API: get context for symbol |
AGENTS.md · 302 lines

How it starts

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

AGENTS.md

Этот репозиторий проиндексирован memos — используй MCP-инструменты memos для навигации по коду. Это быстрее grep/cat и точнее.

Code navigation policy (memos)

Этот проект проиндексирован memos — структурным индексом кода (symbols, call edges, imports) с episodic memory. Инструмент доступен через MCP-тулы. Прежде чем читать файл целиком или делать grep по коду — используй memos. Это быстрее, точнее и не тратит контекст на нерелевантные строки.

Обязательный порядок действий

  1. В начале сессии, если ещё не открыт проект — вызови open_project с абсолютным путём к корню репозитория. Это одноразовое действие на сессию, если проект уже открыт — не вызывай повторно.

  2. Чтобы найти определение функции/класса/переменной — используй find_symbol_tool(name, kind=None, file_path=None). Не используй grep/cat для этого — memos даёт точный результат (файл, строки, сигнатура, exported) без ложных совпадений по имени в комментариях/строках.

  3. Чтобы понять, кто вызывает функцию или что вызывает она — используй find_calls_tool(symbol_name, direction="callers"|"callees"). Это заменяет ручной grep по имени функции во всём репозитории.

  4. Перед тем как редактировать функцию — вызови get_context_tool(symbol_id). Он возвращает символ + всех callers + callees + episodic memory заметки + кэшированный LLM-summary (если есть). Это заменяет повторное чтение всего файла и всех зависимых файлов — не открывай их вручную, если get_context_tool уже дал нужную картину.

  5. Чтобы посмотреть всё содержимое файла структурно (какие символы, вызовы, импорты) — используй get_module_tool(path) вместо чтения файла целиком, если тебе не нужен именно raw-текст (форматирование, комментарии, точный синтаксис для правки).

  6. Для поиска по смыслу, а не по точному имени ("где у нас логика авторизации", "функция, которая парсит даты") — используй semantic_search_tool(query, top_k).

  7. После значимого решения, вывода или "гочи", которое стоит помнить в будущих сессиях (архитектурное решение, причина странного кода, TODO с контекстом) — сохрани заметку через memory_add_note(content, scope_type, scope_id, kind). Не полагайся только на свой ответ в чате — он не переживёт сессию, а memory_entries переживают.

Read the full file on GitHub · 302 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 First seen · 302 lines · 4,667 tokens per session scan A 1b4d005558a1

Subscribe to this mod's changes

memos-engine AGENTS.md is an instructions file published in the GitHub repository TAskMAster339/memos-engine (2 stars, last pushed 1mo ago), licensed MIT. It adds 4,667 tokens to every session, about $0.0233 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.