PUBLISH
The marketplace
The marketplace is where people find plugins: the Marketplace tab of Kiri’s Plugins view, and kiri plugin search in a terminal. It lives in Kiri Cloud and keeps a copy of every version it lists, so what someone installs is exactly what you published. You list a plugin with kiri plugin publish; this page is what happens to it after that, and what people see.
What a listing shows
Most of a listing is built from the plugin itself, so it can’t say something the plugin doesn’t do. The permission lines are the install prompt’s own words, from your kiri-plugin.toml.
| On the listing | Comes from |
|---|---|
| Name, mark, description | name, mark and description in kiri-plugin.toml |
| Publisher and rank | publisher, and the rank of that publisher: Kiri, Verified or Community. See Review |
| Price | price: Free, or Paid · needs an account with the maker for "account". Installing is always free |
| Shows in | The places in [adds] and [window], such as Checks · Status bar |
| Asks to and Reaches | Every permission line of the prompt, or No internet |
| Installs, stars and reviews | People who have it installed |
| About, logo, screenshots, What’s new | The listing/ folder, below |
In Kiri’s window your plugin is its mark: the icon from mark in white on your colour, the same everywhere it shows. The listing’s logo is the full-colour picture for the marketplace page.
The listing folder
Add the rest of the listing in a listing/ folder beside kiri-plugin.toml. kiri plugin build packs it into the plugin’s image, and the marketplace reads it from there, so the listing changes only when you publish a new version.
| File | What it’s for |
|---|---|
listing/about.md |
A longer description, in plain Markdown: headings, lists, links, no pictures. |
listing/logo.png |
A logo for the marketplace, 512 by 512. The window uses the plugin’s mark instead. |
listing/screenshots/*.png |
Up to five, 1600 by 1000, in the order of their names. |
listing/whats-new.md |
One ## heading per version, newest first. The top one shows on the What’s new tab, and in the update prompt when permissions grow. |
$ tree no-latest
no-latest
├── kiri-plugin.toml
├── lang
│ └── de.toml
├── listing
│ ├── about.md
│ ├── logo.png
│ ├── screenshots
│ │ ├── 1-blocked-pull.png
│ │ └── 2-note.png
│ └── whats-new.md
├── src
│ └── main.ts
└── tests
└── no-latest.tomlFinding plugins
People browse by category, or by where a plugin shows. The categories are Share, Deploy, Scanners, Checks, Registries, CI and Agent tools. A way to share is under Share, a place to deploy under Deploy, a scanner under Scanners and a check under Checks, from what your [adds] lists. The Shows in filter narrows the list to plugins that use a place, such as only those with a note in the status bar.
kiri plugin search WORDS searches the same list from a terminal, and kiri plugin install NAME installs from it, with the same prompt as the window. Every kiri plugin command takes --json for scripts.
Stars and reviews come only from people who have the plugin installed.
Updates
Publish a higher version from the same folder. Kiri checks for plugin updates once a day, with its own update check, and what happens next depends on what the new version asks for.
An update that asks for more waits for review before it’s listed, then for each person. Until they say yes, they keep the version they have, and its permissions stay as they were. So add a permission in its own version, with a line in listing/whats-new.md saying why: that’s the text people read when they decide.
Taking a version back
If a version is wrong, kiri plugin publish --withdraw 1.2.0 --reason "…" stops new installs of it, and computers that have it go back to the version before at their next daily check, with a notice that shows your reason. The version number stays used. If a plugin turns out to be harmful, Kiri can take it off the marketplace, and every computer that has it switches it off at its next check. Review has both.
What people see when they find, install and update your plugin will be in the Kiri docs when 1.0 ships: Find and install and Update and remove.
© 2026 Kiri · The SDK is open source under the Apache License 2.0 · Docs · runkiri.com