Astrona logs export

astrona logs export

Copy one or more run logs out of ~/.astrona to a file or directory

Synopsis

Copy run logs out of ~/.astrona.

Exporting a single log writes --output as a file (or, if --output is an existing directory, a file inside it). --all, or any multi-log filter, writes one file per log into the --output directory.

--format raw copies the log verbatim; json / yaml write the parsed log ({meta, lines:[{kind,text}]}).

astrona logs export [ref] [flags]

Options

      --all              Export every matching log into the --output directory
      --command string   Only logs for this command (run, test, submit, destroy)
      --force            Overwrite existing destination files
      --format string    Exported content format: raw, json, yaml (default "raw")
  -h, --help             help for export
      --lab string       Only logs for this lab
      --last int         Keep only the N newest logs after the other filters
  -o, --output string    Destination file, or directory for multiple logs (required)
      --since duration   Only logs started within this window (e.g. 24h, 90m)

Options inherited from parent commands

      --accept-terms      Accept this CLI's usage terms and data-loss risk notice; required on each operational CI command (read: astrona terms)
  -c, --config string     Path or URL to the lab config directory (with --git: a subdirectory within the cloned repo) (default ".")
  -f, --file string       Configuration file name override (default "config.yaml")
      --git string        Git repository URL to clone/pull (https://, git@host:, or ssh://) — --config then selects a subdirectory within it
      --git-ref string    Git branch, tag, or commit to check out (used with --git; default: the repo's default branch)
      --headless          Disable the terminal UI and CLI prompts; run/reset skip login reminders and new account sessions
      --install-version   If the lab needs another astrona release (astronaVersion) that isn't installed, install it without asking — for CI
      --trust             Approve running a remote (--git / URL) lab without asking — for CI; review the lab first
      --update-check      Check for new CLI releases (disabled in CI, without a terminal, or by ASTRONA_NO_UPDATE_CHECK) (default true)
      --verbose           Stream the full output of every underlying command instead of the compact step view

SEE ALSO

• astrona logs - Inspect the per-run logs astrona writes under ~/.astrona/logs

Auto generated by spf13/cobra on 20-Oct-2026