Skip to content

Nocode 96/cmd runner - #459

Open
nocode-96 wants to merge 3 commits into
noctalia-dev:mainfrom
nocode-96:nocode-96/cmd-runner
Open

Nocode 96/cmd runner#459
nocode-96 wants to merge 3 commits into
noctalia-dev:mainfrom
nocode-96:nocode-96/cmd-runner

Conversation

@nocode-96

@nocode-96 nocode-96 commented Aug 24, 2026

Copy link
Copy Markdown

Plugin

  • Id: nocode-96/cmd-runner
  • New plugin
  • Update to an existing plugin (version bumped in plugin.toml)

What it does

Command Runner adds a top-bar widget that lets users save custom CLI commands and execute them silently in the background with a single click — no terminal window pops up. Commands that require sudo store the password once at save time so subsequent runs are one-click. Completed runs show their stdout/stderr and exit code inside a collapsible log view directly in the panel.

External dependencies

None. Command Runner is self-contained and uses only Noctalia's built-in noctalia.runAsync API for background execution. Sudo commands are dispatched via the standard sudo -S pattern using the cached password.

Testing

  • How it was exercised:

    • Widget left-click opens/closes the panel.
    • Added, edited, and deleted commands via the Add/Edit form.
    • Ran a non-sudo command (echo hello) and verified stdout appeared in the log view.
    • Ran a sudo command and confirmed the password is cached and not re-prompted on subsequent runs.
    • Toggled show_label and show_toast settings and confirmed the widget and notifications respond correctly.
    • Verified that the sudo password field is empty (not pre-filled) when opening the Edit form for an existing command.
    • Confirmed commands.json stores passwords obfuscated (prefixed with enc:) and not as plain text.
  • Tested on Niri

  • Tested on Hyprland

  • Tested on Sway

  • Tested on another compositor:

  • Noctalia version tested against: v5.0.0 (beta9-4-g7fd9f7bfa960)

  • Plugin API level: 9

Screenshots / Videos

Checklist

  • The directory name matches the part of id after the / in plugin.toml exactly.
  • It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
  • README.md follows the README template, documents every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
  • I created thumbnail.webp with the thumbnail generator.
  • version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
  • Every non-English translation in this PR uses a locale supported by Noctalia core, and I can read, write, and understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
  • I did not edit catalog.toml; CI generates it.
  • This PR touches exactly one plugin directory.

Code review attestation

  • The code is readable and not obfuscated, minified, or generated.
  • It does not download and execute remote code.
  • Every network call, filesystem write, and spawned process is something the description above accounts for.
  • I have the right to publish this code under the license declared in plugin.toml.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant