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:
cd ~/ClaudeShared/charlie/extensions/tea-time zip -r ~/Desktop/tea-time.zip .
The zip should open to this:
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.
- The file is a real zip with
manifest.jsonat the top level. manifest.jsonis valid JSON.- It has a
name, adescription, aversionlike1.0.0, and adeveloperwithnameandcontact. - The
nameuses only lowercase letters, numbers and hyphens, and starts with a letter or number. - If the extension claims a role, it provides every tool that role requires, marked
roleScoped.
Submit it
Sign in to the hub
On your hub's home page, choose Submit an extension.
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.
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
- Draft: saved and waiting for review. Not in the catalog.
- Published: in the catalog for everyone to find and install.
- Unpublished: taken out of the catalog. It can be published again.
- Archived: put away. Also not in the catalog, and it can be brought back.
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.