locus AGENTS.md

locus AGENTS.md is an instructions file for Codex, OpenCode from Magnifico4625/locus. It costs 1,092 tokens per session, scanned A, original, MIT.

Repository instructions for Locus, a persistent memory platform for AI coding tools such as Codex CLI and Claude Code.

In plain words
What is it for?
Use them when changing the Locus product, its coding-tool integrations, or its secondary IDE adapters.
Why use it?
They give coding agents a shared way to choose work, keep changes focused, collaborate, and check that tasks are complete.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions Claude Code; mentions Codex; built for cline.

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/magnifico4625/locus/agents-md
Clone the repo
git clone --depth 1 https://github.com/Magnifico4625/locus

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 locus AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/magnifico4625/locus/agents-md.svg)](https://agentmods.dev/instructions/magnifico4625/locus/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/magnifico4625/locus/agents-md"><img src="https://agentmods.dev/badge/instructions/magnifico4625/locus/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,092 This file is loaded in full into every session.
When invoked 1,092 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.01092 $0.01092
Opus 5 $0.00546 $0.00546
Sonnet 5 $0.00218 $0.00218
Haiku 4.5 $0.00109 $0.00109

Measured 6d ago against content hash 8e889d7e8088, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

locus 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 6d 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 · 154 lines

How it starts

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

AGENTS

This file defines the working contract for AI agents operating in the locus repository.

It is intentionally short, opinionated, and practical.


Mission

Build and maintain Locus as a persistent memory platform for AI coding tools, with the current primary product focus on:

  1. Codex CLI
  2. Codex desktop / extension surfaces
  3. Claude Code compatibility preservation

Secondary IDE adapters such as Cursor, Windsurf, Cline, and Zed matter, but they must not degrade the primary Codex path.


Core Working Style

  • Think before coding.
  • Surface wrong assumptions, hidden confusion, and missed trade-offs early.
  • Prefer simplicity first.
  • Avoid unnecessary abstraction and speculative complexity.
  • Make surgical changes.
  • Do not touch unrelated code without a clear reason.
  • Keep implementation goal-oriented.
  • Use tests and checkable success criteria as a competitive advantage, not as an afterthought.

Collaboration Contract

  • Work task-by-task when the user is driving an execution sequence.
  • Do not silently jump to the next major task if the user asked for approval gates.
  • Communicate directly and concisely.
  • Prefer facts, validation results, and concrete trade-offs over reassurance or filler.
  • Save important project decisions so they remain discoverable across sessions.

Product Rules

1. Keep one Locus, not separate products

  • Do not fork Locus into separate products for Codex, Claude Code, or other clients.
  • Reuse the shared storage, inbox, search, and ingest pipeline wherever possible.
  • Client-specific behavior should be implemented as thin adapters.

2. Codex is the current primary product line

  • Codex CLI and Codex desktop / extension are the primary validation path after v3.3.0.
  • Codex-first work should improve one or more of:
    • installation UX
    • conversational recall quality
    • diagnostics
    • packaging
    • user trust and privacy clarity

3. Claude Code must not regress casually

  • packages/claude-code/** should stay untouched unless a shared contract change truly requires it.
  • Codex work must not create incidental Claude regressions.

Read the full file on GitHub · 154 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. 6d ago First seen · 154 lines · 1,092 tokens per session scan A 8e889d7e8088

Subscribe to this mod's changes

locus AGENTS.md is an instructions file published in the GitHub repository Magnifico4625/locus (14 stars, last pushed 2mo ago), licensed MIT. It adds 1,092 tokens to every session, about $0.0055 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.