{
  "name": "services",
  "kind": "bundled",
  "title": "Services",
  "description": "systemd units on Linux (user and system), launchd agents on macOS: start, stop, restart, enable, logs.",
  "version": "0.1.0",
  "icon": "󰒓",
  "author": "pal",
  "spec": "github:zcag/pal/extensions/services",
  "source": "https://github.com/zcag/pal/tree/HEAD/extensions/services",
  "commit": "a84c75d8e1ff65aae49fd8acc1cf888a84c8a465",
  "manifest": {
    "name": "services",
    "title": "Services",
    "description": "systemd units on Linux (user and system), launchd agents on macOS: start, stop, restart, enable, logs.",
    "version": "0.1.0",
    "icon": "󰒓",
    "author": "pal",
    "repo": "bundled",
    "license": "MIT",
    "settings": [
      {
        "kind": "number",
        "id": "ttl",
        "label": "Refresh after",
        "description": "Seconds a listing stays good for: the palette lists again on show only once the rows are older than this. Read when the extension loads.",
        "min": 0,
        "max": 3600,
        "unit": "s",
        "default": 10
      },
      {
        "kind": "boolean",
        "id": "confirm_user",
        "label": "Confirm user units",
        "text": "Ask before stopping or restarting a user unit",
        "default": false,
        "description": "System units always ask first; a user unit acts at once unless this is on."
      },
      {
        "kind": "list",
        "id": "agent_dirs",
        "label": "Agent folders (macOS)",
        "description": "Where the launchd agent plists are read from; the first is yours, the second every user's.",
        "default": [
          "~/Library/LaunchAgents",
          "/Library/LaunchAgents"
        ]
      }
    ],
    "store": {
      "tagline": "systemd units and launchd jobs: start, stop, restart, logs",
      "category": "system",
      "features": [
        "Linux: every systemd unit of the user and the system manager, filters User, System, Failed and Running; the unit file's state (`enabled`) and a coloured active-state tag (`running` green, `failed` red) on the right",
        "`enter` stops an active unit or starts an inactive one; a system unit asks first and goes through `systemctl`, then `sudo -n`, then `pkexec`, whichever is allowed",
        "`cmd+l` opens `journalctl -u \u003cunit\u003e -n 200` in the panel; `cmd+e` enables or disables the unit file",
        "macOS: the agent plists in `~/Library/LaunchAgents` and `/Library/LaunchAgents`, everything `launchctl list` knows, and the jobs with a pid, tagged `running`, `loaded`, `exit N` or `not loaded`",
        "`enter` unloads a loaded job (`launchctl bootout`, after a confirm) or loads one from its plist (`bootstrap`); `cmd+shift+r` kickstarts it; `cmd+l` shows the plist as XML",
        "Live: listed again when the panel shows once the rows are older than `ttl`"
      ],
      "permissions": [],
      "platforms": [
        "macos",
        "linux"
      ],
      "screenshots": [
        {
          "file": "1-units.png",
          "caption": "systemd units under the User filter, the unit file's state and the active state on the right"
        },
        {
          "file": "2-failed.png",
          "caption": "The Failed filter: units of both managers, in a User and a System section"
        },
        {
          "file": "3-logs.png",
          "caption": "journalctl for a unit, the last 200 lines in the panel"
        },
        {
          "file": "4-agents.png",
          "caption": "macOS: launchd agents by folder, with pid and state"
        }
      ],
      "actions": [
        {
          "title": "Stop",
          "description": "systemctl stop on an active unit; a system unit asks first.",
          "keys": "enter"
        },
        {
          "title": "Start",
          "description": "systemctl start on an inactive unit.",
          "keys": "enter"
        },
        {
          "title": "Logs",
          "description": "journalctl -u \u003cunit\u003e -n 200 in the panel.",
          "keys": "cmd+l"
        },
        {
          "title": "Restart",
          "description": "systemctl restart, or launchctl kickstart -k on macOS.",
          "keys": "cmd+shift+r"
        },
        {
          "title": "Enable",
          "description": "systemctl enable on a disabled unit file.",
          "keys": "cmd+e"
        },
        {
          "title": "Disable",
          "description": "systemctl disable; a system unit asks first.",
          "keys": "cmd+e"
        },
        {
          "title": "Copy unit name",
          "description": "name.service.",
          "keys": "cmd+c"
        },
        {
          "title": "Unload",
          "description": "macOS: launchctl bootout; asks first.",
          "keys": "enter"
        },
        {
          "title": "Load",
          "description": "macOS: launchctl bootstrap from the plist.",
          "keys": "enter"
        },
        {
          "title": "Show plist",
          "description": "macOS: the plist as XML in the panel.",
          "keys": "cmd+l"
        },
        {
          "title": "Open plist file",
          "keys": "cmd+o"
        },
        {
          "title": "Copy label",
          "keys": "cmd+c"
        }
      ]
    },
    "palettes": {
      "services": {
        "kind": "live",
        "description": "Every service unit (Linux) or launchd job (macOS), with its state.",
        "keys": [
          {
            "keys": "enter",
            "title": "Stop or start (unload or load on macOS)"
          },
          {
            "keys": "cmd+l",
            "title": "Logs (the plist on macOS)"
          },
          {
            "keys": "cmd+shift+r",
            "title": "Restart"
          },
          {
            "keys": "cmd+e",
            "title": "Enable or disable the unit file (Linux)"
          },
          {
            "keys": "cmd+o",
            "title": "Open the plist file (macOS)"
          },
          {
            "keys": "cmd+c",
            "title": "Copy the unit name or label"
          },
          {
            "keys": "tab",
            "title": "Next filter: User, System, Failed, Running"
          }
        ]
      }
    }
  },
  "updated_at": "2026-09-16T16:45:33Z",
  "url": "https://pal.cagdas.io/extensions/services",
  "tagline": "systemd units and launchd jobs: start, stop, restart, logs",
  "category": "system",
  "screenshots": [
    "https://pal.cagdas.io/extensions/services/screenshots/1-units.png",
    "https://pal.cagdas.io/extensions/services/screenshots/2-failed.png",
    "https://pal.cagdas.io/extensions/services/screenshots/3-logs.png",
    "https://pal.cagdas.io/extensions/services/screenshots/4-agents.png"
  ],
  "panel_screenshots": [
    "https://pal.cagdas.io/extensions/services/screenshots/1-units.png",
    "https://pal.cagdas.io/extensions/services/screenshots/2-failed.png",
    "https://pal.cagdas.io/extensions/services/screenshots/3-logs.png",
    "https://pal.cagdas.io/extensions/services/screenshots/4-agents.png"
  ],
  "bar_screenshots": [],
  "has_bar": false,
  "bar_items": [],
  "has_readme": true
}