Building blocks
Building blocks
Every extension is made from the same ten pieces. Most start with one or two of the basics and add more later. Each piece is a line or two in your extension's manifest.json.
The basics
- Tools: things Charlie can do, like search your email or run a command.
- Connections: sign in once to a service, and Charlie can use it.
- Instructions: plain-English guidance Charlie follows, plus longer guides it reads when needed.
- Settings: a panel where people choose how your extension behaves.
- Surfaces: where your extension appears, from a pop-up to its own window or a page in the top bar.
Going further
- Roles: fill a job like email or remote storage, so people can swap providers and nothing else changes.
- Live state: tell Charlie what exists at the start of each conversation, and let your windows talk back.
- Personality: shape Charlie's voice and how it opens and closes a conversation.
- Data & storage: keep records on this computer, in the person's hub, or in their own database.
- Sharing outward: let Claude Code on the same computer use your tools too.
Also worth a look
Three more things come up only briefly in these pages.
- Publishing. When your extension is ready for other people, you publish it to the catalog, where they can find and install it from Charlie. The catalog checks your manifest the same way Charlie does. See Publishing.
- Safety controls. Mark a destructive tool with
"confirm": trueand Charlie shows the person what the tool is about to do and asks Allow or Deny. In a top-bar view's own thread it always asks. In ordinary conversations it asks only if the person turns on Ask before running them in Talk under Settings > Tool use. An extension can also remember a person's choices itself: the bash extension asks before running a new command and can remember that allow or deny for next time. - Depending on another extension. If your extension relies on another one, list its name in
"dependsOn". If that extension is missing or switched off, Charlie skips yours, so nothing half-works. Don't mention another extension in your instructions or tool descriptions unless it's listed here.