libra config
Command reference for `libra config`
libra config manages repository-local and user-global configuration stored in SQLite-backed
config_kv, including vault-backed secrets and key management.
Alias: cfg
Synopsis
libra config <subcommand> [options]
libra config set [--global | --system] [--add] [--encrypt] [--plaintext] [--stdin] <key> [<value>]
libra config get [--global | --system] [--all] [--reveal] [--regexp] [-d <default>] <key>
libra config list [--global | --system] [--name-only] [--show-origin] [--vault] [--ssh-keys] [--gpg-keys]
libra config unset [--global | --system] [--all] <key>
libra config import [--global]
libra config path [--global | --system]
libra config generate-ssh-key --remote <name>
libra config generate-gpg-key [--name <name>] [--email <email>] [--usage <usage>]
Git-compatible flag style is also supported (hidden from help):
libra config [--get | --get-all | --unset | --unset-all | -l | --add | --import | --get-regexp | --show-origin] [--local | --global | --system] [-z | --null] [--type <t> | --bool | --int | --path] [key] [value] [-d <default>]
libra config --remove-section <name>
libra config --rename-section <old-name> <new-name>
Description
libra config reads and writes configuration values across three scopes: local (repository-level, stored in .libra/libra.db), global (user-level, stored in ~/.libra/config.db), and system (machine-wide, stored in /etc/libra/config.db; lowest cascade precedence, plain config only — no vault). Each database uses SQLite with a config_kv table.
Unlike Git's plaintext INI files or jj's TOML files, Libra stores configuration in a transactional database with integrated vault encryption. Sensitive values (API keys, tokens, SSH private keys) are automatically encrypted at rest using AES-256-GCM.
The command supports two invocation styles:
- Subcommand style (preferred):
libra config set key value,libra config get key - Git-compatible flag style (hidden):
libra config --get key,libra config key value
When reading a value with get, Libra cascades through scopes in precedence order: local, then global, then system. The first match wins; an unreadable system scope is skipped. Remote/cloud commands perform the schema checks below before consuming these defaults.
Configuration schema compatibility
GlobalConfig and SystemConfig use the configuration-owned
configuration_schema_versions ledger, separate from Repository migrations.
Known Repository-only receipts (including 2026090801 in the current manifest)
do not make a configuration store future. Unknown or mismatched receipts and
true configuration future schemas remain unsupported; remote/cloud commands
that need the affected scope fail closed with LBR-CONFIG-001.
An explicit global/system configuration mutation writes the
configuration-owned legacy-reader barrier and its configuration changes in the
same transaction. The barrier is a reserved receipt in the legacy ledger so
older binaries, including the pinned 0.22.16 reader, refuse to write this
store. This build recognizes the exact barrier together with a valid
configuration base receipt. A failed transaction rolls back both the barrier
and the configuration change. Existing legacy receipts are retained.
Scoped get/list, default-value cascades and remote preflight never write the barrier. Cascaded configuration reads are read-only and do not bootstrap a missing store. The compatibility transition is forward-only: older binaries must upgrade; never delete receipts or edit SQLite to force a downgrade. Recognizing a supported Repository receipt is not permission for automatic repair. Unknown/unsupported state is upgrade-only in this release.
GlobalConfig uses LIBRA_CONFIG_GLOBAL_DB or ~/.libra/config.db;
SystemConfig uses LIBRA_CONFIG_SYSTEM_DB or /etc/libra/config.db.
Complete process/repo-local storage configuration may make GlobalConfig
unnecessary, but does not bypass SystemConfig compatibility for remote/cloud
defaults. Use --offline or LIBRA_READ_POLICY=offline|local only for
intentional local-only object access, not to bypass remote synchronization
safety checks.
Read-only global schema doctor
Run libra config doctor --global-schema (or libra --json config doctor --global-schema)
to inspect only global schema metadata. It works outside a repository, uses
LIBRA_CONFIG_GLOBAL_DB or ~/.libra/config.db, and does not read configuration
values, open the vault, inspect System/Repository databases, migrate a schema,
write a barrier, create a backup, or run automatic upgrade/recovery. A missing
target remains absent. --global is optional and redundant; --local,
--system and value/action flags are rejected. The paired --repair --confirm
options select the separate mutating workflow below; either option alone fails.
The JSON envelope's data.report_version is 1. The same report backs human
output: scope, role, path_source, configured/canonical paths, exists,
size_bytes, modified_at_utc, and configuration/legacy ledger metadata.
Each ledger reports observed_version, latest_version, readable, and
verified_name; versions are strings (including the barrier's i64::MAX) to
avoid JSON number precision loss. Null metadata means absent or unavailable,
not proof of a healthy store. Receipt names are displayed only after manifest
validation; arbitrary receipt text and configuration values are never output.
classification is absent, compatible, upgrade_required,
unsupported_future, unsupported_receipt, unreadable, or
changed_during_inspection. Diagnosis itself exits successfully even when the
store is unsupported; automation must inspect the classification, not just the
exit status. issue identifies a proven unsupported ledger/version without
untrusted text. Invalid invocations still fail with the existing CLI usage error.
producer_disposition distinguishes registered but unattested Repository
receipts, a recognized configuration barrier, and unattributed state. The
current manifest recognizes 2026090801 as operation_v2_branch_convergence;
that does not prove which process/binary wrote this file. Mtime is diagnostic
metadata, not producer attestation. The default doctor's repair_eligible
is always false, including compatible/known receipts. Upgrade to a
producer-compatible build for unsupported state; never manually edit SQLite
receipts. Doctor does not provide a remote-sync bypass.
The reader uses a normal read-only SQLite snapshot, never immutable on a live
database. It conservatively reports unreadable without opening SQLite when a
WAL-mode file lacks regular WAL/SHM sidecars. Do not create those files manually;
retry while the owning application maintains its normal sidecars, or diagnose
an independently obtained SQLite-consistent snapshot. Existing DB/WAL contents
and modification times are unchanged on a stable target. Before/after file
identity, size and mtime checks report observed concurrent changes as
changed_during_inspection. This is not a filesystem lock: external rotation
can race those checks and SQLite coordination files may change. OS access times
and SHM coordination are not invariant, and no repair authority follows from
passing the checks.
Confirmed legacy global schema repair
Requires Libra v0.22.26 or later; v0.22.25 provides only the read-only doctor.
The opt-in repair workflow is separate from the read-only doctor:
libra --json config doctor --global-schema
libra --json config doctor --global-schema --repair --confirm /absolute/canonical/path/config.db
Use the exact canonical_path from your own report, not the example path.
--confirm must be absolute and match byte-for-byte; symlink/noncanonical
configured paths and combinations with value operations or another scope are
refused. No repository preflight, system database access or auto-upgrade runs.
Repair currently supports only a narrowly registered v0.22.19 Linux amd64
producer-format cohort, not every database with receipt 2026090801. Its
source revision is b94bfe12f2ec2f039b88ddb5c6f8871787d60f17 and producer binary
SHA-256 is 03447eb983178433425b5afffba351edae4044e7ded5b9e35c956dddb2bb68a6.
All 293 schema objects (including SQLite internal structures), all 60 original
receipts and the runtime manifest must match. Repository data or storage paths,
unknown tables/triggers/receipts, and altered bootstrap metadata are ineligible.
Format attestation does not identify the historical writer/PID of your file.
Unknown states remain upgrade-only; never change receipts to make a file match.
Mutating repair is Unix-only with verified local filesystem semantics:
Linux ext-family, XFS, Btrfs, tmpfs and overlayfs; macOS APFS/HFS. Windows,
other/unrecognized filesystems and network filesystems fail closed before any
repair side effect. The file and its immediate directory must belong to the
current effective user and must not be group/world-writable; the file must have
one hard link. Unsafe ancestors and sidecars are refused. A fixed private
config.db.schema-repair.lock serializes repairs and is intentionally retained.
These checks do not defeat a malicious same-user/root process. Stop other
writers and file replacement/rotation tools before repair; observed replacement
or concurrent commits abort the operation.
Before schema changes, SQLite VACUUM INTO creates a consistent logical backup
without a source write transaction. It is flushed and reopened for integrity
and format checks. A private .libra-config-repair-<random>/ directory beside
the target retains backup.sqlite (0600) and recovery.json (inside a 0700
directory). The application does not enumerate/decrypt configuration values;
SQLite copies their logical contents. Treat the backup as sensitive. Failed or
interrupted copies are retained unverified, not silently deleted or reused.
After backup verification, a SQLite write lock protects a second manifest,
attestation and file-identity check. A connection-local nonce and data_version
reject a changed connection or a concurrent commit. One transaction initializes
configuration_schema_versions and appends the configuration-owned
configuration_legacy_reader_barrier to the legacy ledger. Original receipts,
configuration rows, encryption flags and sequence high-water marks are retained;
no Repository migration runs, and no journal-mode change or explicit checkpoint
is requested. Old Repository-only binaries refuse the barrier before writing;
use a compatible new binary thereafter. There is no automatic downgrade.
Successful JSON uses data.action="repair", report_version=1,
outcome="repaired", backup_path, backup_verified=true, and committed=true,
plus the registered format/source hashes. An already protected configuration
returns outcome="already_protected" with no backup, mutation or producer
attestation; this is not a full database health assessment. Default doctor
output and its repair_eligible=false remain unchanged.
Recovery is explicit, never automatic. Preserve both the current database and
its recovery directory. A valid recovery.json with backup_verified=true is
required before considering backup.sqlite; interrupted/missing/unverified
metadata is not proof of a usable backup. After a crash or uncertain commit,
run read-only doctor first: a stale status file cannot determine whether the
transaction committed. Stop every process using the database, verify the
backup's integrity and provenance, preserve the current DB and its sidecars for
forensics, then have the repository maintainer restore that verified consistent
backup as a unit with correct private permissions. Never overlay a live DB,
mix old WAL/SHM files with a restored main file, restore an unverified artifact,
or manually edit migration receipts. Keep a producer-compatible binary available.
Invalid confirmation uses LBR-CLI-002; unsupported format/path/permission
eligibility uses LBR-CONFIG-001; lock, backup and transaction failures use
LBR-IO-002. Failures never include configuration values or raw SQLite schema
errors. A retained backup is not proof that repair committed; check the reported
commit state and rerun diagnosis when the outcome is uncertain.
Options
Subcommands
set <key> [<value>]
Set a configuration value. If <value> is omitted and the key is sensitive, Libra prompts for interactive input (hidden echo). In non-interactive contexts (CI/CD), use --stdin to pipe the value.
| Flag | Description |
|---|---|
--add |
Add as an additional value for the key, allowing duplicates (like Git's multi-valued keys such as remote.origin.fetch) |
--encrypt |
Force vault encryption even if the key does not match sensitive-key heuristics |
--plaintext |
Force plaintext storage, skipping auto-encryption even for sensitive-looking keys |
--stdin |
Read the value from stdin instead of a positional argument (useful for piping secrets in CI/CD) |
# Basic set
libra config set user.name "Jane Doe"
# Set global config
libra config set --global user.email "jane@example.com"
# Force encryption
libra config set --encrypt custom.api_token "sk-abc123"
# Set from stdin (CI/CD)
echo "$SECRET" | libra config set --stdin vault.env.GEMINI_API_KEY
# Add multi-value key
libra config set --add remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
# Sensitive key prompts interactively when value omitted
libra config set vault.env.GEMINI_API_KEY
get <key>
Retrieve a configuration value. Cascades from local to global scope, returning the first match.
| Flag | Description |
|---|---|
--all |
Return all values for this key (multi-valued keys) |
--reveal |
Show the actual decrypted value for encrypted entries (blocked for internal vault credentials like vault.roottoken_enc) |
--regexp |
Treat <key> as a regex pattern and return all matching entries |
-d, --default <value> |
Return this value if the key is not found (instead of an error) |
# Simple get
libra config get user.name
# Get with default fallback
libra config get -d "unknown" user.name
# Get all values for a multi-value key
libra config get --all remote.origin.fetch
# Reveal an encrypted value
libra config get --reveal vault.env.GEMINI_API_KEY
# Regex search
libra config get --regexp "user\\..*"
list
List all configuration entries in the active scope.
| Flag | Description |
|---|---|
--name-only |
Show only key names, not values |
--show-origin |
Prefix each entry with its scope (local or global) |
--vault |
Show only vault.env.* entries |
--ssh-keys |
Show SSH key entries |
--gpg-keys |
Show GPG key entries |
# List all local entries
libra config list
# List with scope labels
libra config list --show-origin
# List only vault environment entries
libra config list --vault
# List only key names
libra config list --name-only
# List SSH keys
libra config list --ssh-keys
unset <key>
Remove a configuration entry.
| Flag | Description |
|---|---|
--all |
Remove all values for this key (for multi-valued keys) |
# Remove a key
libra config unset user.signingkey
# Remove all values for a multi-valued key
libra config unset --all remote.origin.fetch
import
Import configuration from the user's Git config (.gitconfig). Copies relevant entries into Libra's config database.
# Import from Git global config into Libra global config
libra config import --global
# Import into local config
libra config import
path
Print the filesystem path of the config database for the active scope.
# Show local config path
libra config path
# Output: /path/to/repo/.libra/libra.db
# Show global config path
libra config path --global
# Output: /home/user/.libra/config.db
edit
Not supported. Libra uses SQLite storage, which cannot be safely round-tripped through a text editor. See Design Rationale for details.
generate-ssh-key --remote <name>
Generate an SSH key pair for the named remote. The private key is stored encrypted in the vault (vault.ssh.<remote>.privkey); the public key is stored at vault.ssh.<remote>.pubkey.
libra config generate-ssh-key --remote origin
libra config get vault.ssh.origin.pubkey
generate-gpg-key
Generate a GPG key pair for commit signing or encryption.
| Flag | Description |
|---|---|
--name <name> |
User name for the key (defaults to user.name config) |
--email <email> |
User email for the key (defaults to user.email config) |
--usage <usage> |
Key usage: signing (default) or encrypt |
# Generate signing key
libra config generate-gpg-key
# Generate encryption key with explicit identity
libra config generate-gpg-key --name "Jane Doe" --email "jane@example.com" --usage encrypt
# Retrieve the public key
libra config get vault.gpg.pubkey
Scope Flags
These flags are global (apply to any subcommand):
| Flag | Description |
|---|---|
--local |
Use repository config (.libra/libra.db). This is the default for writes. |
--global |
Use global user config (~/.libra/config.db). |
--system |
Use system-wide config (/etc/libra/config.db, overridable via LIBRA_CONFIG_SYSTEM_DB). Lowest cascade precedence; writing it usually requires elevated privileges. Vault-encrypted secrets are not supported in this scope (see Design Rationale). |
Hidden Git-Compatible Flags
These flags provide backward compatibility with git config invocation patterns. They are hidden from --help. Most translate to the equivalent subcommand; --remove-section / --rename-section are flag-only section operations with no subcommand form.
| Flag | Equivalent Subcommand / Behavior |
|---|---|
--get |
get <key> |
--get-all |
get --all <key> |
--unset |
unset <key> |
--unset-all |
unset --all <key> |
-l, --list |
list |
--add |
set --add <key> <value> |
--import |
import |
--get-regexp |
get --regexp <key> |
--show-origin |
list --show-origin |
--type=<bool|int|path>, --bool, --int, --path |
Canonicalize a value when reading (--get/--get-all/--get-regexp) and when setting: bool variants → true/false; int with optional k/m/g (1024-based) multiplier; path expands a leading ~/~/. On a set the value is validated/canonicalized before storage (matching git config --type: yes → true, 1k → 1024), and an invalid value errors without storing. A non-get/non-set mode is rejected (exit 129). |
--remove-section <name> |
Delete the keys in section <name> in one transaction, using Git's section/subsection identity (so --remove-section branch removes branch.<key> but not the branch.feature.* subsection). Missing section → exit 128. |
--rename-section <old> <new> |
Move section <old>'s keys to <new>, preserving each value and its encryption flag. Missing source → exit 128; identical names → exit 2; an already-existing destination section is refused → exit 128. |
Other Flags
| Flag | Description |
|---|---|
-d, --default <value> |
Default value when key is not found (Git-compat positional mode) |
-z, --null |
NUL-terminate output records (git config -z): value\0 for --get/--get-all; key\nvalue\0 for --get-regexp/--list; key\0 with --name-only; origin\0 prefix with --show-origin. --json takes precedence. Applies to standard config output only; combining it with --ssh-keys/--gpg-keys/--vault is rejected (exit 129). |
--json |
Emit structured JSON output |
--quiet |
Suppress human-readable output |
Common Commands
libra config set user.name "Jane Doe"
libra config get user.name
libra config list
libra config list --show-origin
libra config unset user.signingkey
libra config import
libra config path
Human Output
get prints the value on a single line:
Jane Doe
list prints key-value pairs:
user.name=Jane Doe
user.email=jane@example.com
core.editor=vim
With --show-origin:
local user.name=Jane Doe
global user.email=jane@example.com
With --name-only:
user.name
user.email
core.editor
set prints nothing on success (exit code 0).
path prints the database path:
/home/user/repo/.libra/libra.db
Structured Output (JSON examples)
get:
{
"command": "config",
"data": {
"key": "user.name",
"value": "Jane Doe",
"origin": "local"
}
}
list:
{
"command": "config",
"data": {
"entries": [
{ "key": "user.name", "value": "Jane Doe", "origin": "local" },
{ "key": "user.email", "value": "jane@example.com", "origin": "global", "encrypted": false }
]
}
}
Secrets And Vault Entries
Sensitive keys are stored encrypted when they match Libra's sensitive-key rules, including:
vault.env.**.privkey- API keys, tokens, passwords, and similar secret-looking keys
Examples:
libra config set vault.env.GEMINI_API_KEY
echo "$SECRET" | libra config set --stdin vault.env.GEMINI_API_KEY
libra config set --encrypt custom.api_token "secret"
libra config get vault.env.GEMINI_API_KEY
libra config get --reveal vault.env.GEMINI_API_KEY
libra config list --vault
--reveal is blocked for internal vault credentials such as vault.roottoken_enc and
vault.ssh.<remote>.privkey.
Key Management
SSH keys are generated per remote and stored in config:
libra config generate-ssh-key --remote origin
libra config get vault.ssh.origin.pubkey
libra config list --ssh-keys
GPG public keys are exposed through config, while private signing material stays inside vault.db:
libra config generate-gpg-key
libra config generate-gpg-key --usage encrypt
libra config get vault.gpg.pubkey
libra config list --gpg-keys
Supported --usage values are signing and encrypt.
Scope
- Default scope is local (
.libra/libra.db) --globaluses~/.libra/config.db--systemuses/etc/libra/config.db(override withLIBRA_CONFIG_SYSTEM_DB); lowest cascade precedence, writes usually need elevated privileges, and vault-encrypted secrets are rejected in this scope (see Design Rationale)
Resolution order for runtime config-backed environment variables is:
- CLI arguments
- Local config (
vault.env.<NAME>) - Global config (
vault.env.<NAME>) - Process environment variables
If no Vault entry or process environment variable supplies a required API key,
Libra reports the missing key and asks you to set vault.env.<NAME> or export
<NAME>.
Design Rationale (Why different from Git/jj)
Why SQLite instead of text files?
Git uses INI-format text files; jj uses TOML. Libra uses SQLite because:
- Transactional writes. SQLite provides ACID guarantees. A crash mid-write cannot corrupt the configuration, unlike a partially-written text file. This is critical when multiple AI agents may write config concurrently.
- Structured queries. Multi-valued keys, prefix searches, and regex matching are SQL queries rather than text parsing. This eliminates an entire class of escaping and parsing bugs.
- Integrated encryption. Vault-encrypted values are stored as encrypted blobs alongside plaintext values in the same table. A text file format would need a separate encryption layer or inline encoding scheme.
Why vault encryption?
Git stores configurations in plaintext INI files, which is inherently insecure for storing API keys, access tokens, and SSH/GPG private keys. Libra integrates Vault-backed encrypted storage natively. Sensitive keys (like vault.env.*, *.privkey, or keys containing substrings like secret/token) are automatically encrypted at rest using AES-256-GCM in both local and global scopes. This eliminates the "redacted in CLI but plaintext on disk" false sense of security, allowing developers to safely store environment overrides directly within the configuration.
Why does --system reject vault-encrypted secrets?
--system reads and writes plain system-wide config at /etc/libra/config.db (override with LIBRA_CONFIG_SYSTEM_DB), at the lowest cascade precedence — like Git's /etc/gitconfig. Writing it usually requires elevated privileges, and a present-but-unreadable system DB is skipped during cascade reads rather than crashing other users' commands.
What it deliberately does not support is the vault: storing encrypted secrets (vault.* keys or --encrypt values) in the system scope is rejected with a usage error. In a multi-user OS environment, a system-level unseal key under root-owned /etc/libra would either be unreadable to regular users (breaking decryption) or world-readable (defeating the encryption). System-wide secrets should be handled at the OS/environment level; Libra keeps the vault to --global (user-level) and --local (repository) scopes.
Why no config edit?
Libra uses a SQLite database (config_kv table) instead of plaintext files. Exporting database rows to a text editor and parsing the unified diff back into SQL UPDATE/DELETE statements is dangerous. Specifically, for multi-value keys (e.g., remote.origin.fetch), the plaintext representation lacks row-level primary keys. Reordered, partially modified, or deleted lines would prevent Libra from accurately mapping text changes to database rows, inevitably leading to data loss or corruption. To guarantee data consistency, you must use the robust set, --add, unset, and list commands.
Why built-in SSH/GPG key management?
Instead of scattering SSH private keys as plaintext files on the filesystem, Libra stores them encrypted inside the config vault (vault.ssh.<remote>.privkey). When an SSH transport is invoked, the key is dynamically decrypted to a temporary file (chmod 600), passed to the SSH client, and deleted immediately afterward. GPG private keys are managed exclusively by the vault's internal PKI engine and are never exported to the filesystem.
Why subcommand style as the primary interface?
Git uses git config key value (implicit set) and git config key (implicit get), which is ambiguous: git config foo could be a get or an incomplete set. Libra follows jj's lead by requiring explicit subcommands (set, get, list, unset). The Git-compatible flag style (--get, -l, etc.) is preserved as hidden aliases for migration, but the subcommand style is the documented interface because it is unambiguous, discoverable via --help, and easier for AI agents to generate correctly.
Why --default instead of exit-code differentiation?
Git exits with code 1 when a key is not found, which is indistinguishable from other errors in scripts. Libra's --default flag provides an explicit fallback value, allowing scripts and agents to handle missing keys without error-code parsing.
Parameter Comparison: Libra vs Git vs jj
| Feature | Git | jj | Libra |
|---|---|---|---|
| Implicit set | git config key val |
No (requires set) |
libra config set key val plus compatible libra config key val |
| Subcommand style | No | Yes (set/get/list/edit/path) |
Yes (set/get/list/unset/import/path) |
| Get value | git config key |
jj config get key |
libra config get key |
| List | git config -l |
jj config list |
libra config list |
| Edit in editor | git config -e |
jj config edit |
Not supported (SQLite storage) |
| Regex search | git config --get-regexp |
No | libra config get --regexp |
| Show origin | git config --show-origin |
No | libra config list --show-origin |
| Type coercion | --type=bool|int|path |
No (TOML types) | --type=bool|int|path + --bool/--int/--path (canonicalize on both read and set) |
| Default fallback | --default value |
No | --default value |
| Null-delimited | -z |
No | -z / --null (value\0 for get/get-all; key\nvalue\0 for --get-regexp/--list; key\0 with --name-only) |
| Rename/remove section | Yes | No | --remove-section / --rename-section (Git section/subsection semantics; rename refuses an existing destination) |
| JSON output | No | No | --json |
| Secret redaction | No | No | Auto-detect |
| Import from Git | N/A | N/A | libra config import |
| Vault encryption | No | No | AES-256-GCM (local/global only; rejected in system scope) |
| Env var vault | No | No | vault.env.* |
| SSH key per remote | No | No | generate-ssh-key --remote |
| GPG key generation | No | No | generate-gpg-key |
| Env var resolution | No fallback | No fallback | CLI -> env -> repo -> global |
| Config file path | N/A | jj config path |
libra config path |
| Conditional config | includeIf |
[[when]] blocks |
Not supported |
| Worktree scope | --worktree |
--workspace |
Not supported |
| Arbitrary file | --file <path> |
No | Not supported |
| Storage format | INI text files | TOML text files | SQLite + vault |
| Scopes | system/global/local/worktree | user/repo/workspace | system/global/local (system: plain config only, no vault; no worktree scope) |
| Name-only listing | --name-only |
No | --name-only |
| Multi-value add | --add |
No | set --add |
| Stdin input | No | No | set --stdin |
| Force encrypt | No | No | set --encrypt |
| Force plaintext | No | No | set --plaintext |
Error Handling
| Code | Condition | Hint |
|---|---|---|
LBR-REPO-001 |
Not inside a libra repository (for local scope) | Initialize with libra init or use --global |
LBR-CLI-002 |
Vault-encrypted secret (vault.*/--encrypt) in --system scope |
Use --global or --local for vault secrets |
LBR-CLI-003 |
Key not found and no --default provided |
Check key name with libra config list |
LBR-CLI-002 |
edit subcommand used (not supported) |
Use set, get, unset, list subcommands |
LBR-IO-001 |
Failed to read config database | Check file permissions on .libra/libra.db |
LBR-IO-002 |
Failed to write config database | Check file permissions and disk space |
Compatibility Notes
libra vaulthas been removed. Uselibra config generate-ssh-key,libra config generate-gpg-key, andlibra config get vault.*instead.libra config editis not supported (see Design Rationale above).- Old repositories may still contain legacy
vault.gpg_pubkeyentries; new writes usevault.gpg.pubkey.