Jeden/Docs

CLI command

jeden artifact

Read one UTF-8 session artifact or copy it to a requested output file.

Exact invocation#

Shell
jeden artifact <session-id-or-path> <name> [output]

Inputs and options#

  • Required: session identifier or path and artifact name.
  • Optional: an output path. Without it, artifact text is printed and normalized to end with a newline.

Output and state effect#

Canonicalizes the session artifact root and selected file, reads the artifact as text, and either prints it or writes the same text to the output path.

Refusals and boundaries#

  • Missing selectors are refused as artifact requires a session id or path or artifact requires an artifact name.
  • A canonical artifact path outside the session root is refused as artifact path escapes session: &lt;name&gt;.
  • Missing, non-UTF-8, or unwritable files return their filesystem error.