LibraLibra
LibraLibra
DocsBlogLibra
Getting Started
Architecture
Design
Commands
libra addlibra agentlibra alternateslibra applylibra archivelibra authlibra automationlibra bisectlibra blamelibra branchlibra bundlelibra cachelibra cat-filelibra check-attrlibra check-ignorelibra check-mailmaplibra checkoutlibra cherry-picklibra cleanlibra clonelibra cloudlibra code-controllibra codelibra commit-treelibra commitlibra completionslibra configlibra credentiallibra depslibra describelibra diff-fileslibra diff-indexlibra diff-treelibra difflibra dirtylibra fast-exportlibra fast-importlibra fetchlibra filelibra for-each-reflibra format-patchlibra fscklibra gclibra graphlibra greplibra hash-objectlibra hookslibra hydratelibra index-packlibra initlibra investigatelibra layerlibra lfslibra loglibra logfilelibra loginlibra logoutlibra ls-fileslibra ls-remotelibra ls-treelibra maintenancelibra medialibra merge-baselibra merge-filelibra mergelibra metadatalibra mvlibra noteslibra oplibra openlibra pack-objectslibra packagelibra prunelibra publishlibra pulllibra pushlibra read-treelibra rebaselibra refloglibra remotelibra repacklibra replacelibra rererelibra resetlibra restorelibra rev-listlibra rev-parselibra revertlibra reviewlibra revisionlibra rmlibra sandboxlibra servicelibra shortloglibra show-reflibra showlibra sparse-viewlibra stashlibra statslibra statuslibra switchlibra symbolic-reflibra taglibra update-indexlibra update-reflibra usagelibra verify-packlibra whoamilibra worktreelibra write-tree
API Reference
Policy
Commands

libra logfile

Command reference for `libra logfile`

Inspect Libra's tracing log-file configuration. Mirrors Lore's logfile command. This is a diagnostic helper for the file-logging sink controlled by the LIBRA_LOG_FILE, LIBRA_LOG_ROTATION, and LIBRA_LOG / RUST_LOG environment variables.

Synopsis

libra logfile info

Description

logfile info reports how the current process would configure file logging, resolved from the environment:

  • enabled — whether tracing is on (a filter directive was resolved).
  • file — the LIBRA_LOG_FILE path, or stderr when unset.
  • rotation — the rolling strategy (never / minutely / hourly / daily).
  • filter — the resolved LIBRA_LOG / RUST_LOG directive (or the libra=debug fallback used when only LIBRA_LOG_FILE is set).
  • size — the total size and count of the log file(s) on disk (the single file under never, or every rolled file otherwise).

It needs no repository.

Log-file environment variables

VariableMeaning
LIBRA_LOG_FILEPath of the append/rolled tracing sink. When unset, logs go to stderr (only if a filter is set).
LIBRA_LOG_ROTATIONnever (default), minutely, hourly, or daily. When rolling, each active file is written as <file>.<date-suffix> so no single file grows without limit. Rotation only splits logs by time — it does not delete old files, so total disk usage still needs external retention (e.g. logrotate, or point LIBRA_LOG_FILE at a dedicated directory).
LIBRA_LOG / RUST_LOGtracing-subscriber env filter. Falls back to libra=debug when only LIBRA_LOG_FILE is set.

Options

OptionDescriptionExample
infoShow the resolved log configuration.libra logfile info
--json / --machineStructured { enabled, file, rotation, filter, size_bytes, file_count }.libra --json logfile info

Exit codes

CodeMeaning
0Configuration was reported.

Examples

# Show where logs would go with the current environment.
libra logfile info

# Roll the log daily and inspect the resolved config.
LIBRA_LOG_FILE=/var/log/libra/libra.log LIBRA_LOG_ROTATION=daily libra logfile info

# Structured output for tooling.
libra --json logfile info

Comparison with Git

Git has no equivalent; this is a Libra diagnostic extension (like Lore's logfile), classified intentionally-different in COMPATIBILITY.md.

libra log

Command reference for `libra log`

libra login

Command reference for `libra login`

On this page

SynopsisDescriptionLog-file environment variablesOptionsExit codesExamplesComparison with Git