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.
npx agentmods add instructions/marclove/known/agents-mdgit clone --depth 1 https://github.com/marclove/knownWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.02316 | $0.02316 |
| Opus 5 | $0.01158 | $0.01158 |
| Sonnet 5 | $0.00463 | $0.00463 |
| Haiku 4.5 | $0.00232 | $0.00232 |
Grade A, and why
known 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 2d 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.
How it starts
The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
This file provides guidance to agentic coding agents like Claude Code, Gemini CLI, and Codex CLI when working with code in this repository. This is the place for documenting our product requirements and development guidelines.
Project Overview
"known" is a Rust library that provides functionality for managing agentic LLM instruction files and project rules directories. It creates and manages AGENTS.md files with automatic migration from CLAUDE.md and GEMINI.md files, creates symlinks for compatibility, and manages rules directories for various AI coding assistants.
Common Commands
- Build:
cargo build - Run tests:
cargo test - Run specific test:
cargo test test_name - Check code:
cargo check - Format code:
cargo fmt - Lint:
cargo clippy - Common development tasks:
just -l
Architecture
The project follows standard Rust library structure:
src/lib.rs- Main library file containing public functions and testssrc/main.rs- CLI interface using clap for command-line argument parsingsrc/agents.rs- AGENTS.md file creation and migration functionalitysrc/autostart.rs- Cross-platform autostart managementsrc/config/- Configuration file management for tracking watched directoriessrc/config/mod.rs- Public API and re-exportssrc/config/io.rs- File I/O operations for configurationsrc/config/path.rs- Configuration file path resolutionsrc/config/structure.rs-Configstruct and implementation
src/constants.rs- Shared constants used throughout the applicationsrc/daemon/- Modular file watching daemon with single instance enforcementsrc/daemon/mod.rs- Main daemon orchestration and lifecycle managementsrc/daemon/config_event.rs- Configuration file event detectionsrc/daemon/config_handler.rs- Configuration file change handling and hot-reloadingsrc/daemon/events.rs- File system event handling and processingsrc/daemon/file_event.rs- File system event handling logicsrc/daemon/symlinks.rs- Symlink management operationssrc/daemon/watchers.rs- File watcher setup and directory monitoring
src/single_instance/- PID file locking for single instance enforcementsrc/single_instance/mod.rs- Public API and testssrc/single_instance/lock.rs-SingleInstanceLockstruct and implementationsrc/single_instance/path.rs- System-wide lock file path functionalitysrc/single_instance/process.rs- Process management utilitiessrc/single_instance/stop.rs- Daemon stopping functionality
src/symlinks.rs- Symlink creation and rules directory managementCargo.toml- Project configuration and dependenciesjustfile- Just command runner for common development tasks
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.
- 2d ago First seen · 129 lines · 2,316 tokens per session scan A c95b172d9427
known AGENTS.md is an instructions file published in the GitHub repository marclove/known (3 stars, last pushed 10mo ago), licensed BSD-3-Clause. It adds 2,316 tokens to every session, about $0.0116 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-31.
Other instructions, from other repositories
obsidian-mind CLAUDE.md
Claude Code instructions for breferrari/obsidian-mind, covering obsidian mind, skills & capabilities, custom slash commands, vault structure and obsidian cli.
obsidian-mind AGENTS.md
AGENTS.md instructions for breferrari/obsidian-mind, covering obsidian mind, hooks, commands, memory and reaching this vault from another repo.
parallel-code CLAUDE.md
Instructions for johannesjo/parallel-code, covering parallel code, stack, commands, project structure and conventions.
ox AGENTS.md
Instructions for sageox/ox, covering human attention is the scarcest resource, what is ox?, quick start, terminology and required reviews.
switchback-running CLAUDE.md
Instructions for rlacombe/switchback-running, covering ultrarunning training companion, constitution, athlete data, training philosophy and core principles.
SubFrame AGENTS.md
Instructions for Codename-11/SubFrame, covering subframe - subframe project, core working principle, relationship to native ai tools, session start and concurrent work & worktrees.