docs-cli - coding-agent project state in Markdown

Name: docs-cli - coding-agent project state in Markdown
Availability: InStock
Author: ArtRichards

by ArtRichards·May 25, 2026·6 points·0 comments

Visit Project View on HN

AI Analysis

●●SolidBig BrainNiche Gem

Treats Markdown files as a database so fresh agents don't need to read 70k token chat logs.

Strengths

•Solves the specific 'state drift' problem where agents lose context between sessions.
•Uses simple Markdown metadata blocks instead of complex vector databases or external services.
•Dogfooded on the project's own documentation, proving the workflow is viable.

Weaknesses

•Requires agents to be explicitly taught to use the CLI, adding setup friction.
•Manual record management might feel bureaucratic compared to auto-summarization tools.

Post Description

Hi HN

I recently published docs-cli to pypi. I created this tool because I noticed that my docs kept getting out of sync: I've been using markdown to track the project's implementation and progress, and it became really hard to keep track of everything. This is a simple tool for your agents to ensure that links and indexes are kept fresh.

I included the agent-playbook-suite marketplace since this is how I use it. The docs repo was actually built also using it, so dogfooding since day one :) The Agent Playbook Suite includes everything needed to create a project from start to finish.

Linked is the blog post where I lay out my rationale and the use cases :)

Try docs-cli out with:

python3 -m pip install --upgrade docs-cli

I would love feedback, issues, and PRs.

This is my first Show HN after lurking for over 15 years. Happy to hear any constructive (or other) criticism