DOX: Self-documenting layer for coding agents

agentzero1 pts0 comments

GitHub - agent0ai/dox: Self-documenting AGENTS.md · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

agent0ai

dox

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star<br>46

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>3 Commits<br>3 Commits

AGENTS.md

AGENTS.md

LICENSE

LICENSE

README.md

README.md

banner.jpg

banner.jpg

View all files

Repository files navigation

How DOX works

DOX is a tiny AGENTS.md framework that gives an AI agent precise project context.

The agent keeps a hierarchy of AGENTS.md files as the project changes:

root AGENTS.md contains project-wide instructions and the top-level index

child AGENTS.md files contain local instructions for specific areas

before any edit, the agent walks the docs tree from the root to the area it will touch

the relevant docs give it exact local guidelines, so it does not edit blindly

after meaningful changes, it updates the affected AGENTS.md files

The result is simple: traverse the docs, understand the local rules, make precise edits, keep the docs current. Less guessing. Less drift. Less "why did it touch that file?"

How to use

Copy the contents of AGENTS.md into your project's AGENTS.md file.

That's it. No installation, no dependencies, no package, no runtime. DOX is just a Markdown instruction for AI agents.<br>It works with any AI agent that supports AGENTS.md files, including Codex, Claude Code, OpenCode, and similar tools.

No AGENTS.md yet? Copy the file into your project root. The agent will see these instructions and will start building the DOX tree.

For an existing project, you can tell your agent: Initialize DOX tree for this project now. It will create all the child AGENTS.md files and indexes.

Credits

Created by Agent Zero

Open-source agentic AI framework

Website · GitHub repository

About

Self-documenting AGENTS.md

agent-zero.ai

Topics

documentation

ai

ai-agents

agents-md

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Custom properties

Stars

46<br>stars

Watchers

watching

Forks

forks

Report repository

Contributors

Uh oh!

There was an error while loading. Please reload this page.

You can’t perform that action at this time.

agents files agent project search reload

Related Articles