Show HN: Docs-CLI – coding-agent project state in Markdown

Category: cli-tool

Tags: markdown, cli-tool, documentation-management

Score: 6.0/10 (Innovation: 5, Technical: 6, Documentation: 7, Utility: 6)

Docs-CLI is a lightweight Python tool that manages trees of Markdown files as structured records, using metadata blocks to derive indexes, validate consistency, and enable querying without manual cross-references. It is interesting because it addresses the problem of project state drift in coding agent workflows by providing a simple, file-based record system that makes agent work resumable and reduces reliance on chat transcripts.

Target audience: backend devs, devops, technical writers

Repository: https://artrichards.github.io/agent-playbook-suite/blog/ · Python · MIT

View on Hacker News