`agent-md` - A CLI tool that helps you write Markdown friendly for LLM

```bash

agent-md AGENTS.md

agent-md lint README.md

```

## Why does this tool exist?

Many Markdown files today are written by LLM or AI agents that waste a lot of tokens. When another LLM reads these files, it continues to spend unnecessary tokens.

The reason is that Markdown is designed to be easy for humans to read, so it often contains elements like bold text, decorative characters, whitespace... These are helpful for humans, but unnecessary for LLM.

In fact, LLM/agents do not need to read the entire file. They only need to access the relevant content parts (e.g., ## Development) instead of processing the whole document.

## The problem

- Token waste: Formats like bold, tables, decorative characters increase the number of tokens without helping AI

- Inefficient reading: LLM still has to process presentation elements like *bold*, ASCII art...

- Redundant structure: Many components are only useful for humans (complex tables, nice layouts) but are not needed for AI

- Increased costs: Each time an LLM reads a document it has to "pay" for these formatting parts

## Solution

agent-md offers a minimal, AI-friendly way of writing markdown that helps:

- Reduce unnecessary tokens

- Keep content clear and easily accessible in parts

- Ensure that humans can still read it when needed

The goal is: write once, optimized for both humans and AI, but without wasting resources.