Charliehub · by A.N.D.Why

Sharing your work

Publish to the catalog

Publishing puts your extension in the catalog on the A.N.D.Why hub, where other people can find it and install it into their own copy of Charlie.

The catalog lives on the hub's home page at hub.andwhyproductions.net. Anyone with a hub account can submit an extension. Each one is reviewed before it appears for everyone.

Make the bundle

A bundle is a zip file of your extension, with manifest.json at the top level of the zip. Put in everything Charlie needs to run it: the manifest, your handlers folder, and any compiled files your manifest points to.

The most common mistake is zipping the folder itself. That puts the manifest one level down, at tea-time/manifest.json, and the hub rejects it. Zip what is inside the folder instead. On a Mac, in Terminal:

Terminal
cd ~/ClaudeShared/charlie/extensions/tea-time
zip -r ~/Desktop/tea-time.zip .

The zip should open to this:

tea-time.zip
manifest.json
handlers/
  suggest.js

What the hub checks

The hub checks your bundle the same way Charlie checks an extension when it loads. If anything is wrong, it tells you what and saves nothing.

Submit it

  1. Sign in to the hub

    On your hub's home page, choose Submit an extension.

  2. Fill in the form

    Upload your zip. The extension's name, description and version come from your manifest, so you don't type them again. You also add:

    • Icon: a square image for the catalog card. Required the first time.
    • One-line summary: plain English for people browsing.
    • Category: where it sits in the catalog.
    • What it does: a few short paragraphs for the extension's own page. Required.
  3. Wait for review

    Choose Submit for review. Your extension is saved as a draft. Once the A.N.D.Why team reviews and publishes it, it shows up in the catalog.

To fix something before it is published, upload a new zip with the same name from the same page. It replaces your draft. If the name is already taken by someone else's extension, or by one that is already published, you'll be asked to rename yours.

There is no button yet for updating your own extension after it is published. Contact the A.N.D.Why team to update it.

Where an extension can be

Only the A.N.D.Why team changes an extension's status.

How people install it

In Charlie, open the Extensions page in Settings and switch to the Browse tab. It shows the published catalog. Pick an extension and choose Install.

Before installing, Charlie runs the same checks it runs at startup, including tier. It refuses the bundle if the manifest's name doesn't match the catalog entry, or if one of its tools has the same name as a tool already installed. Then it puts the extension in ~/ClaudeShared/charlie/extensions/ under its own name, replacing any older copy.

Like any new extension, it starts working after Charlie restarts. Charlie says so when the install finishes.

Each extension's page in the catalog on the hub also offers the zip as a download, for anyone who wants to look inside first.