Skip to content

keryx reel list

List the project's reel workspaces with a coarse status.

Usage

keryx reel list

It takes no flags and no arguments.

What the output means

$ keryx reel list
my-post  [social]  theme=editorial  bundle=content/posts/my-post
other    [draft]

One line per workspace, ordered by slug. theme= and bundle= appear only when workspace.yaml records them.

With no workspaces at all:

$ keryx reel list
no reels (create one with `keryx reel new <slug>`)

A directory under the reel root without a readable workspace.yaml is skipped silently rather than reported as broken.

How the status is decided

By exactly one test: does the reel's article have copy for it on any platform? The announcement set lives in the article's bundle (spec 0060, 0061), so a reel with no bundle: is always draft.

The article's social.json Status
no copy for this reel, or no article draft
copy for this reel on any platform social

The outlets' own status is not read. A reel whose outlets are all still drafts and a reel already posted everywhere both report social. A posted status is intended but not implemented.

For real per-platform state โ€” draft, approved, posted, scheduled โ€” use social show.

Where it looks

Under the reel root, which is reels/ unless workspace.root says otherwise. reel list is one of the two commands that honours workspace.root; most do not โ€” see the note on that key.

See also