Modules

Extend artuditu 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.

Write a module → How installing works
  1. 1

    Find one

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

    artu module search
  2. 2

    Review, then install

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

    artu 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. 

    artu module list

Community modules

Browse the topic →

No modules published yet

The topic is brand new, so this list is empty. That also means the first module published here is going to be very easy to find.

Write the first one → Check the topic

Start from a working example

i See 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-dock example
artuditu/examples

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

Shell 3 files 132 lines
dockstartupsettings
artu module link ./examples/modules/branch-dock
agent-ping example
artuditu/examples

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

Python 2 files 131 lines
eventssecretsright-click
artu module link ./examples/modules/agent-ping
scratch-pane example
artuditu/examples

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

JavaScript 4 files 139 lines
panesselectiontabs
artu module link ./examples/modules/scratch-pane
esp-idf example
artuditu/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.

Shell 12 files 755 lines
dockpanessettings
artu module link ./examples/modules/esp-idf
deck example
artuditu/examples

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

Python 5 files 821 lines
panessettings
artu 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 a artuditu-module.toml at its root, then add the artuditu-module topic to it on GitHub. This page and artu module search both pick it up on their next run.

  1. Put artuditu-module.toml in the repo root (or a subdirectory).
  2. On GitHub: About → ⚙︎ → Topics, add artuditu-module.
  3. Tell people to run artu 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_artuditu_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 artuditu CLI. That openness is the point, and a little judgment keeps it safe. Install from people you trust, and skim the manifest first: artu 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. artuditu validates and isolates, but it does not sandbox: third-party modules come from their authors, not from artuditu.

Read the full trust model →