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 workspace contain a social.json file?

Nothing inside social.json is read. A reel whose platforms are all still drafts and a reel already posted everywhere both report social, because both have the file. 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¶

• reel new · reel plan