Charlie extensions
Teach Charlie a new trick.
An extension is a folder with a short description file. Your first one takes about fifteen minutes, and you don't have to be a programmer to build it.
What an extension can give Charlie
Every extension is built from the same small set of pieces. Most people start with one or two and add more later. Each piece has a matching line in your extension's description file, shown at the bottom of each card.
1Tools
Things Charlie can do, like search your email, run a command or draw a chart.
"tools"
2Connections
Sign in once to Slack, Gmail, Jira or your hub, and Charlie can use it.
"connections"
3Instructions
Plain-English guidance Charlie follows, with longer guides it reads when needed.
"instructions" "guide"
4Settings
A panel where people choose how your extension behaves.
"settings"
5Surfaces
Where your extension appears: a window, a pop-up, the sidebar or the top bar.
"ui" "sidebar" "topBar"
6Roles
Fill a job like "email" so people can swap providers and nothing else changes.
"role"
7Live state
Charlie starts each conversation knowing the latest, and your windows talk back.
"boot" "channels"
8Personality
Shape Charlie's voice and the way it opens a conversation.
"systemPrompt"
9Data & storage
Keep records in the person's own hub or database, not in your extension.
"persistence" "rdbms"
10Sharing outward
Let other AI apps, like Claude Code, use your tools too.
"mcp": true
How it fits together
Charlie has ten sockets, numbered like the pieces above. Pick a real extension that ships with Charlie to see which sockets it plugs into and where each one shows up.
Your first extension
This one gives Charlie a standing instruction. There's no code involved, only a single file. The full walkthrough goes on to add a tool.
Make a folder
Create
~/ClaudeShared/charlie/extensions/tea-time/. Using the same name as your extension keeps things easy to find.Describe it
Add a file called
manifest.jsonlike the one shown here. It says what the extension is, who made it and what it adds.Restart Charlie
Charlie looks for new extensions when it starts up. New ones are switched on right away.
Try it
Start a new conversation and ask Charlie to plan your afternoon.
{
"name": "tea-time",
"description": "Reminds Charlie that 4pm is for tea.",
"version": "0.1.0",
"tier": "core",
"developer": {
"name": "Your Name",
"contact": "you@example.com"
},
"instructions": "When planning the operator's afternoon, keep 4:00 to 4:20pm free for tea."
}
Every line above the instructions is required. If one is missing, Charlie skips the extension.