Skip to content

Public content CLI

agentdd

The read-only command line for agentdrivendevelopment.com. It turns public posts, briefs, decks, transcripts, and executive maxims into agent-ready Markdown and JSONL.

Install

One package. One binary. No auth.

Use it when an agent needs the site’s public writing without learning the WordPress REST API, post meta conventions, or where each companion artifact lives.

Requires Node 20 or newer.

npm install -g @agentdrivendevelopment/cli
npx @agentdrivendevelopment/cli posts list --limit 5

Why it exists

Your agent should spend tokens on the argument, not the plumbing.

It should not have to know that executive briefs, decks, audio, and transcripts are stored behind different WordPress fields and routes. That is not reasoning. That is busywork.

agentdd gives the agent the shape it actually wants: clean Markdown for reading, JSON for lists and search, JSONL for structured ingestion, source URLs for attribution, and one command for the full executive package.

What it returns

The public archive, shaped for agents.

01

Read the post

Fetch a published article as Markdown with normalized title, date, slug, link, and body.

agentdd posts get <slug>
02

Pull the brief

Get the 400-600 word executive brief built for CxO-level decision context.

agentdd brief get <slug>
03

Assemble the package

Bring back the post, brief, deck, short podcast, and transcript in one agent-friendly document or structured record stream.

agentdd package get <slug> --jsonl
04

Search the archive

Run full-text search across public posts and return parseable results with source links.

agentdd search "query" --jsonl
05

Stream the deck

Print the deck URL by default, or stream the full HTML with the inline flag.

agentdd deck get <slug> --inline
06

Load the maxims

Fetch the executive talking-point library as agent-readable Markdown.

agentdd maxims list

Command path

A normal agent run is three lines.

Find the material. Pull the bundle. Keep the source URL attached. The attribution rule travels with the output.

agentdd search "token economics" --limit 3
agentdd package get find-the-ceiling
agentdd posts get find-the-ceiling --agent --jsonl
  • get commands default to Markdown.
  • list and search default to JSON.
  • --json, --jsonl, --markdown, and --base-url work across commands.

Contract

Read-only by design. Attribution required.

No auth. No writes. Public posts only. Update prompts appear only in interactive terminals, so agent runs and piped output stay quiet. Use --no-update-check or NO_UPDATE_NOTIFIER=1 when you want silence everywhere.

Any agent output that quotes, paraphrases, summarizes, or cites material fetched through the CLI must credit agentdrivendevelopment.com and link to the source post URL returned by the command.

Use the archive without scraping the archive.

Source lives in the cli/ directory of this repository. The package is MIT licensed and built to be boring in the places agent infrastructure needs boring: stable commands, predictable output, clean attribution.