Modules

Extend luvus in any language

A module is a plain GitHub repo with a manifest and some commands. Bash, Python, Lua, Rust, Node, anything your machine can run. No SDK, no plugin runtime, no registry to sign up for.

  1. 1

    Find one

    Browse below, or search from the terminal. Both read the sameluvus-module GitHub topic.

    luvus module search
  2. 2

    Review, then install

    Install prints every command the module declares and waits for your confirmation before anything runs.

    luvus module install owner/repo
  3. 3

    Use it

    It shows up in Settings → Modules with its own settings, and wherever it declared itself: a dock, a pane, a right-click.

    luvus module list

Community modules

Browse the topic →
opscope★ 4
stealth-factory

Hollywood called. They want their terminal back. Sci-fi terminal widgets that show only real data — latency, deployments, tailnet peers, GitHub, agents and clocks. Fifteen single-binary Rust widgets, nothing to install alongside them.

Rustupdated 1h ago
clidashboardhacker
luvus module install stealth-factory/opscope
mondary

Stack Monitor : RAM/CPU du stack terminal (widget barre, dock lateral, TUI) pour Luvus

Shellupdated 14d ago
luvusmonitoringsystem-monitoring
luvus module install mondary/luvus-stackmon
ridhomujizat

luvus module: macOS Now Playing in the Luvus Bar and sidebar, with a real-time FFT spectrum of the system audio.

Perlupdated 23d ago
luvus module install ridhomujizat/luvus-media-playback-control
luvlink★ 2
DavidCarliez

Private, mobile-first control for Luvus agents over Tailscale.

HTMLupdated 14d ago
coding-agentsluvusmobile
luvus module install DavidCarliez/luvlink
pixtui★ 1
RizRiyz

Pixel Art Editor on Terminal

Pythonupdated 1mo ago
bohay-moduleeditorherdr-plugin
luvus module install RizRiyz/pixtui
RizRiyz

Sample bohay ping module

Pythonupdated 1mo ago
bohaybohay-module
luvus module install RizRiyz/bohay-agent-ping
AsahiArt

Luvus module that publishes human titles onto resumable AGENTS sidebar rows

Pythonupdated 3d ago
luvus module install AsahiArt/agent-titles
johnkattenhorn

STOPGAP Luvus module: IMAGES dock + local browser gallery until RizRiyz/luvus#324 and #236. Not Luvus's image viewer.

Pythonupdated 1d ago
luvus
luvus module install johnkattenhorn/luvus-image

Start from a working example

iSee all samples →

Three complete modules ship in the repo, one per language, each covering a different part of the surface. Copy one, change its id, and you have a module.

branch-dockexample
luvus/examples

A sidebar dock listing the active node's git branches. Click one to check it out.

Shell3 files132 lines
dockstartupsettings
luvus module link ./examples/modules/branch-dock
agent-pingexample
luvus/examples

Posts a webhook when an agent goes blocked, so you know without watching it.

Python2 files131 lines
eventssecretsright-click
luvus module link ./examples/modules/agent-ping
scratch-paneexample
luvus/examples

Right-click a pane to open a scratch notepad beside it, and stash the selected text into it.

JavaScript4 files139 lines
panesselectiontabs
luvus module link ./examples/modules/scratch-pane
esp-idfexample
luvus/examples

Build, flash and monitor ESP32 boards. Flashing stops the serial monitor and brings it back in the same pane, so the log from before the flash is still there.

Shell12 files755 lines
dockpanessettings
luvus module link ./examples/modules/esp-idf
deckexample
luvus/examples

Present a Markdown file as slides in a pane. Split on a rule, arrow keys to move, r to reload.

Python5 files821 lines
panessettings
luvus module link ./examples/modules/deck
Publishing

Getting listed takes one click

There is no submission, no review queue, and no account. Push a public repo with aluvus-module.toml at its root, then add theluvus-module topic to it on GitHub. This page andluvus module search both pick it up on their next run.

  1. Put luvus-module.toml in the repo root (or a subdirectory).
  2. On GitHub: About → ⚙︎ → Topics, add luvus-module.
  3. Tell people to run luvus module install you/your-module.

What makes a good listing

  • A one-line repo description: it is the card text here.
  • A README showing what it adds, with a screenshot.
  • Any tools it needs (jq, node, …) stated up front.
  • A min_luvus_version you have actually tested.

A note on trust

A module is ordinary code that runs on your machine as you, with your environment and your full luvus CLI. That openness is the point, and a little judgment keeps it safe. Install from people you trust, and skim the manifest first:luvus module install shows you every command a module declares and asks before running anything. Builds run with a scrubbed environment, and a manifest cannot change between the preview and the install. luvus validates and isolates, but it does not sandbox: third-party modules come from their authors, not from luvus.

Read the full trust model →