bandicot
Bandicot Docs
Chapter IIIWork · Available now

The marketplace: find and install plugins and extensions

Browse, review, install, update and remove plugins and extensions, add a marketplace by link, and see how an agent suggests an install.

Available now. A current user-facing path exists within the stated scope.

Where plugins and extensions live

Plugins and Extensions are two pages in Home, and each has an Installed tab for what this Mac has and a Marketplace tab for what you can add.

Open Home with a double-tap of ⌘, choose the Profile tile, then Plugins or Extensions.

Plugins give your agents new abilities: apps you reach over the internet, command-line apps on this Mac, and packages of skills, hooks and tools. Extensions change Bandicot itself: panes that sit beside an agent, and themes that restyle the whole window. A theme you install shows up in Settings under Appearance as one more choice, next to Dark, Light and Match macOS.

Bandicot's own marketplace is always there. You can add others by link; see Add a marketplace. For skills you write yourself, hooks and / commands, see Commands, skills, plugins and hooks.

  1. Double-tap ⌘ to open Home.
  2. Choose the Profile tile, then Plugins or Extensions.
  3. Switch between Installed and Marketplace at the top.

Browse the marketplace

The Marketplace tab lists everything your marketplaces offer, grouped by what an item is for, with a search box and one button per item.

Type in Search plugins or Search extensions. Every word you type must appear in the item's name, tags, category or description. A line under the box counts the items, the sections and the marketplaces being read, and says Reading the marketplaces while it loads.

Items sit in folding sections by category, in name order with Other last; a section you close stays closed next time. Each row shows the item's name, what kind it is and its version. Plugins are an App, a Command line program or a Package; extensions are a Pane or a Theme. When you read more than one marketplace, each row also says which one it comes from, and Bandicot's own carries an Official mark.

Click a row to open its facts: Kind, Marketplace, the Address of an app, Tags and Id. A command-line app also lists its verbs, the actions an agent can ask it to do. The button at the right says Connect for an app and Install for anything else, or Installed when you already have it.

If it goes wrong

It says Nothing matches.
Shorten the search. Every word has to be found in the same item, so fewer words match more.
It says No plugins in your marketplaces yet. or No extensions in your marketplaces yet.
No marketplace has anything of that kind. Check that Bandicot's own is listed under Marketplaces at the bottom, and press Check for updates.

Connect an app

An app is an online service your agents reach over the internet, and you connect it from its address or with one click from the marketplace.

On the Installed tab of Plugins, the box at the top reads Paste an app address to connect it. Paste the address and choose Connect. Beneath it, one-click buttons name well-known services such as Linear, Notion, Sentry, Vercel, Stripe and Asana, and leave out any you already connected. From the Marketplace tab, Connect on an app does the same.

If the app needs you to sign in, Bandicot says Finish signing in in your browser. and, on the row, offers Open the sign-in page. Each app shows its state: signed in, signed out, expired, signing in, unable or no sign-in. An app that is signed out or expired offers Sign in; one that could not sign in offers Try again. Open the row to see its address, how many tools, resources and prompts it offers, how many calls your agents made, and when it was last used.

To remove an app, choose Disconnect on its row, or open the row and choose Disconnect and forget the sign-in. Calls to an app pass through the same checks as every other tool; see Approvals.

  1. Open Plugins and stay on Installed.
  2. Paste the app's address into Paste an app address to connect it, or choose its name from the buttons beneath.
  3. Choose Connect.
  4. If your browser opens, sign in there, then return to Bandicot.

If it goes wrong

The row says signing in and nothing happens.
Open the row and choose Open the sign-in page, then finish in the browser.
The row says expired.
Choose Sign in on the row. Your connection stays; only the sign-in is renewed.
A link you pasted in the marketplace box answers but is not a catalog, and a button says Connect it as an app.
The address is an app, not a marketplace. Choose Connect it as an app.

Install a package

A package adds skills, hooks or tools, and Install first opens a review that shows what it is and what it asks for before anything is saved.

The review is titled Review plugin access. It shows the package's name and version, its description, its Type, the Catalog it came from, its Package path and its Fingerprint. If the package carries hooks, Commands it runs without asking lists each one. Requested capabilities lists what it wants, or says No capabilities requested. Bandicot can grant fewer than a package requests.

Choose Trust and install to go ahead, or Cancel. Trust is saved for that exact fingerprint. If the package changes later, its row says Changed since you approved it with the new fingerprint, it stays off, and Review again takes you back to the review. Nothing in a package runs while you review or install it.

Installed packages sit under Packages on the Installed tab, each with a switch to turn it on or off and a count of its tools and calls. Some kinds of package Bandicot cannot run yet. The review says so, disables Trust and install, and says that agent, skill and hook packages are supported.

  1. Open the Marketplace tab of Plugins and find the package.
  2. Choose Install and read the review.
  3. Choose Trust and install.
  4. Find the package under Packages on the Installed tab and check its switch is on.

If it goes wrong

The row says Bandicot cannot run this kind yet.
That kind of package is not supported. Choose Remove on the row, and look for an agent, skill or hook package instead.
The row says Changed since you approved it and the package is off.
Choose Review again, read what changed, then Trust and install to switch it back on, or leave it off.
A package fails to install and the message names a size or an unsafe file.
Bandicot refused it on purpose; see What Bandicot checks. Ask the publisher for a corrected package.

Install a command-line app

A command-line app is a program already on this Mac that agents can run through named verbs, and you confirm its command and every verb before it is added.

On the Marketplace tab, Install on a command-line app opens Install with its name. The dialog says Nothing is installed until you confirm. It runs only when an agent or you call one of its verbs. It shows Runs on this Mac with the exact command, whether it needs a Sign-in, how many Verbs it has, who it is From, and the verbs with the arguments each takes.

Choose Trust and install. Bandicot says Added with the app's name, and Sign in from Installed to use it when it needs an account. Command-line apps live under Command-line apps on the Installed tab, with their state (signed in, signed out, unavailable, ready or not on this Mac), a Sign in button, a count of verbs and runs, and Remove.

You can also add one that is not in any marketplace: Add from a manifest opens a box for its manifest, reads it, and shows the same review before Trust and add.

If it goes wrong

The row says not on this Mac.
The program the app runs is not installed here. Install that program first, then check the row again.
The dialog says Reading the manifest… and stays there, or shows a red message.
The manifest could not be read. Choose Cancel, and tell the publisher what the message says.

Install an extension

An extension is a pane or a theme, and Install shows what it adds and what it may read before you choose Install and turn on.

The dialog says It runs in a sealed frame: no network, no files, and only the reads listed here. It lists the Version, what it Adds (a pane, a number of colours, or nothing visible), what it Reads, its Size and who it is From. A theme shows a row of its colours. Reads are in plain words: your agents' titles and messages, your usage and spend, your model list, and your plans and agents' notes. An extension that asks for nothing says nothing.

Choose Install and turn on. The extension is installed and switched on with exactly the reads you saw. On the Installed tab of Extensions, each one has a switch, Turn <name> on, and a May read list of tickboxes you can change at any time. A theme appears under Appearance in Settings.

Open Open the extensions folder to see them as files.

  1. Open Extensions and choose the Marketplace tab.
  2. Choose Install on the extension and read the reads and size.
  3. Choose Install and turn on.

If it goes wrong

The row says Changed since you turned it on. It keeps what you allowed until you approve.
It asks for something it did not before. Read the list under May read, then choose Approve, or turn the extension off.
The dialog shows a red message after Downloading and checking….
Bandicot could not download it or it did not match what the marketplace promised. Nothing was installed; try again later or ask the publisher.

Bandicot Workspace, for company plans

Bandicot Workspace is a plugin on the Business plan that lets you manage your own profile, and the company's if your role allows, by asking an agent.

Find it in the Marketplace tab of Plugins. The first time you use it, your browser opens a page named Connect Bandicot Workspace that says what your role can do. Press Accept once. To end the connection, press Disconnect on the Connected apps card of your account page.

See the Workspace plugin for what each role can ask it to do.

What Bandicot checks before it installs

Every install is pinned, reviewed and refused if the download differs from what the marketplace promised, so nothing runs before you say so.

A marketplace item must name a download that is pinned: Bandicot checks the pin before it opens the file, refuses anything that is not a secure web address, refuses a private address, and installs only when the package equals the fingerprint you reviewed. A package with links, absolute paths or repeated files is refused as unsafe. Nothing in a package runs during review or install.

A marketplace file with a faulty item skips that item and still loads the rest; the count of skipped items shows when you add it. A marketplace that is wrongly built, or whose name imitates Bandicot's own, is refused as a whole.

Limits on a package
LimitValue
Download64 MiB
Unpacked128 MiB
One file32 MiB
Files in a package4096

When an agent suggests an install

An agent installs an item from your marketplaces when your request needs it and the safety check agrees; a card asks you only when your company keeps approvals with people.

Every install is checked first, by the Decisions model or, when that is off, by the agent's own model, and it runs only when your request asks for it; see Approvals. When your company keeps approvals with people, the card reads The agent suggests an install, with a Plugin or Extension tag. It names the item, its version, who offers it (Bandicot or the marketplace's name), a short description, and the agent's own one-line reason. Choose Install and it goes through the same download and checks as the Marketplace tab; choose Not now and the agent carries on with what you have. The card also says Remove it any time in Plugins or Remove it any time in Extensions.

The Install advice switch in the Decisions settings controls when Bandicot offers these. With it on, the Decisions model looks through your marketplaces at an agent's first request and when it starts a new goal, and suggests an item only when nothing you have installed fits. With it off, agents use what you have installed, and can still ask you. See Decisions. For a skill, /find-skill searches, vets and installs one on request; see Commands, skills, plugins and hooks.

If it goes wrong

The card shows only a name and no description.
Bandicot could not find the item in your marketplaces just now. Choose Not now and ask the agent again, or look for it on the Marketplace tab.

Update an item

An extension with a newer version shows Update to and its version, and a package that changed asks for a new review before it runs again.

On the Installed tab of Extensions, a button reads Update to with the new version, and the same button appears on the Marketplace tab. Choose it to see what changed in the dialog, then Update. The dialog shows the old and new version side by side, for example 1.0 → 1.1.

A package shows a small arrow and the newer version beside its name when one exists, and the newer version in its details under Newer. A package that changed on disk since you approved it stays off until Review again.

Check for updates under Marketplaces reads every marketplace again. Bandicot also does this when you open a view and the last read is over an hour old, and an older copy of a catalog never replaces a newer one.

Remove an item

Disconnect an app, switch a package off, remove a command-line app, or remove an extension from its row.

An app has Disconnect, and Disconnect and forget the sign-in in its details. A package has a switch that turns it off. A command-line app has Remove. An extension has Remove, which says Moved and the name to the Trash, so you can put it back from the Trash.

Removing a marketplace does not remove what you installed from it; see Remove a marketplace.

Add a marketplace

Paste a link to a marketplace file, or owner/repo for one in a GitHub repository, into the Marketplace link box under Marketplaces and choose Add.

The Marketplaces card sits at the bottom of the Marketplace tab of both Plugins and Extensions. It lists every marketplace this Mac reads, how many plugins and extensions each brings, its version, and when it was last checked. The box reads owner/repo or https://… link to a marketplace. For owner/repo, Bandicot looks for marketplace.json in the repository, or in its .bandicot-plugin folder. A link must start with https://.

When it works, a message says Added and the marketplace's name with how many items it brought and how many it skipped, and its items show at once. Adding the same marketplace again says Updated. You can link up to thirty-two marketplaces.

A link that is refused tells you why. Common reasons are a link that is not secure or not a link, a marketplace whose name imitates a reserved one, a link that cannot be reached, and a link that answers but is not a catalog. In that last case, if it is an https:// address, Connect it as an app offers to connect it as an app instead.

  1. Open Plugins or Extensions and choose the Marketplace tab.
  2. Scroll to Marketplaces and paste the link or owner/repo into Marketplace link.
  3. Choose Add and read the message.

If it goes wrong

The link is refused as not secure or not a link.
Start the link with https://, or write owner/repo.
The link is unreachable.
Check the address and your connection. A private repository cannot be read.
You hit the limit on linked marketplaces.
Remove one you no longer use under Marketplaces, then add the new one.

Remove a marketplace

Choose Remove on a linked marketplace's row to stop reading it, and what you installed from it stays.

Bandicot says Removed with the name and What you installed from it stays. Bandicot's own marketplace, marked Official, is always present and has no Remove button. If it cannot be reached, Bandicot uses the copy that came with the app.

Publish your own marketplace

A marketplace is one file you host anywhere, and bandicot marketplace validate names each problem in it in plain words before you share it.

The file lists items, each with a name, a description, a kind (skill, tool, plugin or extension) and a pinned source. Downloads must be pinned so Bandicot can check them, and names that imitate Bandicot's own are refused. See the command line for how to run the check.

Questions

Where do I find Plugins and Extensions?

Double-tap ⌘ for Home, choose the Profile tile, then Plugins or Extensions. See Where plugins and extensions live.

Can a plugin or extension install itself?

No. Everything is reviewed first, and an agent's install runs only when your request needs it and the safety check agrees. See When an agent suggests an install.

What does Trust and install trust?

That exact package, by its fingerprint. If the package changes, it stays off until you review it again. See What Bandicot checks before it installs.

What is the difference between a plugin and an extension?

Plugins give agents abilities: apps, command-line programs and packages. Extensions change Bandicot's own window with panes and themes.

Does removing a marketplace remove what I installed from it?

No. The items stay, and you can remove them one by one. See Remove a marketplace.

How do I stop agents suggesting installs?

Turn off Install advice in the Decisions settings. Agents then use what is installed and can still ask. See Decisions.

Can I add a marketplace from a company or friend?

Yes. Paste its link or owner/repo into Marketplace link. See Add a marketplace.