# agent0ai/dox

Self-documenting AGENTS.md

Repository: https://github.com/agent0ai/dox
Canonical: https://ross.abutalabs.com/products/agent0ai-dox
Homepage: https://agent-zero.ai
License: MIT
License Family: permissive
Topics: agents-md, ai, ai-agents, documentation
Last push: 2026-08-01T09:45:21+00:00

## Health v2 (maintenance only)
Score: 56/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 35, longevity 6
- inputs: {"age_days": 93, "days_push": 32, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1420, forks 191 (observed 2026-08-28T04:04:40.523275+00:00)

## What it is
DOX is a tiny Markdown-only framework built around AGENTS.md files that gives AI coding agents precise, hierarchical project context. Agents traverse a tree of root and child AGENTS.md files before editing, follow local guidelines, and keep the docs updated after meaningful changes.

## Use cases
- give my AI coding agent project-wide and local coding guidelines
- stop AI agents from editing the wrong files or drifting from conventions
- set up an AGENTS.md hierarchy for a large codebase
- make Claude Code or Codex follow per-directory rules
- keep agent instructions in sync as the project changes

## When to choose
- you use any agent that supports AGENTS.md (Codex, Claude Code, OpenCode) and want better edit precision
- you want a zero-install, zero-dependency convention that is just Markdown
- your codebase is large enough that a single instructions file causes drift or blind edits

## When to avoid
- you need a runtime, tooling, or enforcement mechanism rather than instructions the agent may ignore
- your project is tiny and a single AGENTS.md already suffices
- your agent does not read AGENTS.md files

## Facets
- artifact type: framework
- maturity: active
- function: documentation, agent-framework, developer-tools
- domain: documentation, developer-tools
- platform: cross-platform, cli
- tags: agents-md, ai-coding-agents, markdown, prompt-engineering, no-installation, code-editing-context, ai-agents, automation

## Member repositories
- agent0ai/dox (main) score 56

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:40.523275+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:48.087317+00:00, confidence not recorded.
  - readme: https://github.com/agent0ai/dox (fetched 2026-08-28T04:04:40.523275+00:00, sha d59813fa2094)
  - homepage: https://agent-zero.ai (fetched 2026-08-29T11:50:35.975986+00:00, sha 5242c8fe244c)
  - site_page: https://www.agent-zero.ai/p/docs (fetched 2026-08-29T11:50:35.985817+00:00, sha 09b8f34f4fdc)
  - site_page: https://www.agent-zero.ai/p/docs/installation (fetched 2026-08-29T11:50:35.987874+00:00, sha e71453a277dc)
  - site_page: https://www.agent-zero.ai/p/community/api-dashboard/about (fetched 2026-08-29T11:50:35.990463+00:00, sha 33c600f4f5e6)
  - site_page: https://www.agent-zero.ai/p/community/about/stakes (fetched 2026-08-29T11:50:35.992569+00:00, sha 6e7ab5789a41)
  - site_page: https://www.agent-zero.ai/p/community/about/rules (fetched 2026-08-29T11:50:35.994729+00:00, sha 5d0679a85da6)
  - site_page: https://www.agent-zero.ai/p/community/about/terms (fetched 2026-08-29T11:50:35.996447+00:00, sha 0b4ebf9a81fe)
  - site_page: https://www.agent-zero.ai/p/docs/launcher (fetched 2026-08-29T11:50:35.998114+00:00, sha 365b3117cd1b)
  - site_page: https://www.agent-zero.ai/p/use-cases/writing (fetched 2026-08-29T11:50:35.999832+00:00, sha b072d7c2231a)
- Data as of 2026-08-30T08:39:29.467469+00:00.