GitHub

lct

Local configuration tool

Overview

Demo of the lct gather command

LCT helps you capture, share, and restore local configuration in a repeatable
way. Use it to bootstrap machines and gather dotfiles with a stable CLI you
can script against.

Checkout the Quick Start guide to get started!

Highlights

  • Predictable CLI output — Designed for automation-friendly, repeatable workflows.
  • Pluggable configuration — Organize config libraries and plugin collections cleanly.
  • Safe defaults — Lean on dry-runs and explicit prompts before destructive actions.

Usage

lct [OPTIONS] COMMAND

Dependencies

  • gum: Checkout the installation section of gum’s README.md
  • yq: Checkout the install section of yq’s README.md

Environment Variables

SOFTWARE_DIR

Base directory for downloaded libraries managed on this machine.

Attributes  
Default Value: $HOME/software

CONFIG_DIR

Base directory for local configuration files.

Attributes  
Default Value: $HOME/.config

SHARE_DIR

Base directory for local shared application data.

Attributes  
Default Value: $HOME/.local/share

CODE_DIR

Base directory for local code projects.

Attributes  
Default Value: $HOME/code

STATE_DIR

Base directory for persistent local state data.

Attributes  
Default Value: $HOME/.local/state

CACHE_DIR

Base directory for local cache data.

Attributes  
Default Value: $HOME/.cache

Options

–verbose, -V

Enable verbose debug logs


Want more? Visit the README for the full workflow and support links.