Skip to main content

List, get, pull, and unpublish

These commands round out the publish lifecycle.

List​

opendocs list

Useful flags:

opendocs list --page 2 --limit 50
opendocs list --tag roadmap
opendocs list --json

The list response includes the current page, limit, total count, and tags.

Get​

opendocs get <postId>

This is the quickest way to inspect a single post's:

  • URL
  • slug
  • visibility
  • version number
  • timestamps
  • tags

Pull​

opendocs pull <postId>

By default, the CLI saves the current Markdown as {slug}.md.

Useful options:

opendocs pull <postId> --stdout
opendocs pull <postId> --output docs/current-spec.md

--stdout is especially useful in scripts and agent workflows.

Unpublish​

opendocs unpublish <postId>

This removes the post from published access without deleting your local file.

Common round-trip workflow​

opendocs list --json
opendocs pull abc123 --output draft.md
# edit draft.md
opendocs update draft.md --post-id abc123

Tips for agents​

  • Use list --json to look up the correct post.
  • Use pull --stdout when an agent needs the current body in-memory.
  • Use get when you need the current URL or visibility before making a change.