{
  "id": "lf",
  "name": "lf",
  "homepage": "https://github.com/gokcehan/lf",
  "description": "A terminal file manager written in Go with a heavy inspiration from ranger file manager.",
  "executables": [
    "lf"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/lf/lfrc",
      "[configHome]/lf/colors",
      "[configHome]/lf/icons"
    ],
    "exclude": [
      "~/.local/share/lf/",
      "%LOCALAPPDATA%/lf/"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Open lf",
    "description": "Start the lf file manager in a directory, optionally with extra startup commands, a config file, or shell-integration output. Remote control, profiling and server flags are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "doc",
        "kind": "manual",
        "url": "https://github.com/gokcehan/lf/blob/master/doc.md",
        "revision": "2026-10",
        "evidence": "**-command** *command*\n**-config** *path*\n**-last-dir-path** *path*\n**-log** *path*\n**-print-last-dir**\n**-print-selection**\n**-selection-path** *path*\n**-single**\n[*path*]\nExecute *command* during client initialization (i.e. after reading configuration, before `on-init`). To execute more than one command, you can either use the **-command** flag multiple times\nUse the config file at *path* instead of the normal search locations.\nPrint the last directory to stdout when lf exits.\nSame as **-print-last-dir**, but write the directory to *path* instead of stdout.\nPrint selected files to stdout when opening a file in lf.\nSame as **-print-selection**, but write the newline-separated list to *path* instead of stdout.\nStart a stand-alone client without a server. Disables remote control.\nAppend runtime log messages to *path*.\n"
      }
    ],
    "field": [
      {
        "id": "start_dir",
        "label": "Start directory",
        "type": "path",
        "position": 0,
        "path": {
          "kind": "any",
          "role": "input"
        },
        "sources": [
          "doc"
        ]
      },
      {
        "id": "command",
        "label": "Startup command",
        "description": "lf command run after the config is read; repeat for several.",
        "type": "string",
        "option": [
          "-command"
        ],
        "multiple": true,
        "effect": "exec",
        "sources": [
          "doc"
        ]
      },
      {
        "id": "config",
        "label": "Config file",
        "type": "path",
        "option": [
          "-config"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "doc"
        ]
      },
      {
        "id": "print_selection",
        "label": "Print selection on exit",
        "type": "boolean",
        "option": [
          "-print-selection"
        ],
        "sources": [
          "doc"
        ]
      },
      {
        "id": "selection_path",
        "label": "Write selection to file",
        "type": "path",
        "option": [
          "-selection-path"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "doc"
        ]
      },
      {
        "id": "print_last_dir",
        "label": "Print last directory on exit",
        "type": "boolean",
        "option": [
          "-print-last-dir"
        ],
        "sources": [
          "doc"
        ]
      },
      {
        "id": "last_dir_path",
        "label": "Write last directory to file",
        "type": "path",
        "option": [
          "-last-dir-path"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "doc"
        ]
      },
      {
        "id": "single",
        "label": "Stand-alone (no server)",
        "type": "boolean",
        "option": [
          "-single"
        ],
        "sources": [
          "doc"
        ]
      },
      {
        "id": "log",
        "label": "Log file",
        "type": "path",
        "option": [
          "-log"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "sources": [
          "doc"
        ]
      }
    ],
    "task": [
      {
        "id": "browse",
        "label": "Browse a directory",
        "fields": [
          "start_dir"
        ]
      },
      {
        "id": "pick_files",
        "label": "Use as a file picker",
        "fields": [
          "start_dir",
          "print_selection",
          "selection_path"
        ],
        "required": [
          "print_selection"
        ]
      },
      {
        "id": "cd_on_exit",
        "label": "Record last directory",
        "fields": [
          "start_dir",
          "last_dir_path"
        ],
        "required": [
          "last_dir_path"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "start_dir",
          "print_selection",
          "print_last_dir",
          "command"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "config",
          "selection_path",
          "last_dir_path",
          "single",
          "log"
        ]
      }
    ]
  }
}