Configuration

lla configuration

Customizing lla

lla is configurable. Use these options to match your workflow.

theme

Quick Setup

Your configuration lives at ~/.config/lla/config.toml. Get started with:

lla init              # Create your config
lla config            # View current settings

Core Settings

Key settings:

# Essential Behaviors
default_sort = "name"          # name, size, or date
default_format = "default"     # default, long, tree, etc.
show_icons = true             # Enable file icons
include_dirs = false          # Show directory sizes
theme = "default"             # Your chosen theme
default_depth = 3             # Directory traversal depth
 
# Visual Organization
[sort]
dirs_first = false            # Directories before files
case_sensitive = false        # Case-sensitive sorting
natural = true               # Smart number sorting
 
# Search Preferences
[filter]
case_sensitive = false        # Case-sensitive search
no_dotfiles = false          # Hide hidden files
 
# Plugin Aliases (v0.5.0+)
[plugin_aliases]
j = "jwt"                    # lla plugin j decode
k = "kill_process"           # lla plugin k interactive
n = "npm"                    # lla plugin n search "react"
gs = "google_search"         # lla plugin gs "query"
yt = "youtube"               # lla plugin yt search "video"
 
# Performance Tuning
[formatters.tree]
max_lines = 20000            # Tree view limit
 
[listers.recursive]
max_entries = 20000          # Recursive listing limit
 
# Grid formatter configuration
[formatters.grid]
# Whether to ignore terminal width by default
ignore_width = false
# Maximum width for grid view when ignore_width is true
max_width = 200
 
[formatters.long]
hide_group = false        # Hide the group column
relative_dates = false    # Show dates like "2h ago"
 
[listers.fuzzy]
ignore_patterns = [          # Fuzzy search exclusions
    "node_modules",
    "target",
    ".git",
    ".idea",
    ".vscode"
]

Display Formats

Choose your default view:

  • default: Clean, efficient listing
  • long: Detailed metadata view
  • tree: Hierarchical structure
  • grid: Space-optimized layout
  • git: Repository insights
  • timeline: Time-based grouping
  • sizemap: Storage visualization
  • table: Structured data view

Command-Line Configuration

Quickly adjust settings without editing files:

# Core preferences
lla config --set default_sort size
lla config --set default_format long
lla config --set show_icons true
 
# Sorting behavior
lla config --set sort.dirs_first true
lla config --set sort.case_sensitive true
 
# Search preferences
lla config --set filter.case_sensitive true
lla config --set filter.no_dotfiles true

Plugin Aliases

Plugin aliases let you create short names for frequently used plugins (v0.5.0+).

Configuring Aliases

Add aliases to your config file:

[plugin_aliases]
j = "jwt"
k = "kill_process"
n = "npm"
gs = "google_search"
yt = "youtube"
gm = "google_meet"

Using Aliases

Aliases work with all plugin commands:

# Without alias
lla plugin jwt decode "token123"
lla plugin kill_process interactive
lla plugin npm search "react"
 
# With alias
lla plugin j decode "token123"
lla plugin k interactive
lla plugin n search "react"

Alias Benefits

  • Less Typing: j instead of jwt
  • Faster Workflow: Shorter commands for frequent tasks
  • Works Everywhere: Shortcuts, manual commands, all syntax styles
  • Personal Preference: Customize to your naming conventions

Common short aliases:

[plugin_aliases]
# Development
j = "jwt"                     # JWT operations
n = "npm"                     # Package search
cc = "code_complexity"        # Code analysis
sn = "code_snippet_extractor" # Snippets
 
# System
k = "kill_process"            # Process management
fd = "flush_dns"              # DNS flush
 
# Search & Web
gs = "google_search"          # Web search
yt = "youtube"                # YouTube search
gm = "google_meet"            # Meetings
 
# File Operations
fm = "file_mover"             # Move files
fc = "file_copier"            # Copy files
fr = "file_remover"           # Remove files
fo = "file_organizer"         # Organize files
ft = "file_tagger"            # Tag files

Aliases in Shortcuts

Aliases automatically work in shortcuts:

# Create shortcut using alias
lla shortcut add decode-jwt j decode -d "Decode JWT"
 
# Or use full name (equivalent)
lla shortcut add decode-jwt jwt decode -d "Decode JWT"

Both create the same shortcut. The alias is resolved when you run the command.

Performance Considerations

Defaults for large directory operations:

  • Tree view: 20,000 entries maximum
  • Recursive listing: 20,000 entries maximum
  • Directory sizes: Optional for performance
  • Fuzzy search: Smart pattern exclusions

Adjust these based on your system.