Extension types
The Ingot store takes five kinds of extensions. Each ingot.json has one type, which decides the store category and which contributes entry is required; a package can add rules, habits, commands and MCP servers on top.
type | Store category | Required in contributes | Runs in |
|---|---|---|---|
theme | Themes | themes | Ingot |
rules | Rules packs | rules | Ingot |
habits | Habits packs | habits | Ingot |
mcp | MCP servers | mcpServers | Ingot |
rex-template | Rex templates | rexTemplates | Zaprex |
Create any of them with ingot init <folder> --type <type>, then follow the creator guide.
Color theme
A color theme in the standard theme JSON format, with colors (workbench) and/or tokenColors (syntax). Ingot shows it under Settings › Appearance › Theme.
"contributes": {
"themes": [{ "id": "acme-dark", "label": "Acme Dark", "uiTheme": "dark", "path": "themes/acme-dark.json" }]
}
uiThemeisdarkorlight; Ingot uses it for everything the theme doesn't color.- One package can hold a dark and a light variant: add two entries.
- Test:
ingot try <project>, then pick the theme in Settings.
Rules pack
Markdown (.md) or .mdc files for the project's .ingot/rules/ folder. The agent reads them on every request that matches (see Rules).
---
description: React conventions
globs: "**/*.{ts,tsx}"
alwaysApply: false
---
- Prefer named exports over default exports.
- Co-locate a test with every component.
Add more files with ingot add rule <name>. Keep each rule short and concrete: the agent follows "Use zod for request validation" better than "Validate input properly".
Habits pack
Habits watches the agent edits you reject. When the same pattern shows up often enough, it suggests a rule. A Habits pack ships ready-made patterns, one JSON file each:
{
"id": "no-console-log",
"title": "Rejected edits that add console.log calls",
"match": "console\\.log\\(",
"rule": "- Don't add console.log calls. Use the project's logger instead.",
"threshold": 3
}
| Field | Notes |
|---|---|
id | lowercase words joined with - |
title | what the pattern catches, up to 120 characters |
match | a JavaScript regular expression, tested against the rejected lines |
rule | the rule text Habits suggests (up to 2,000 characters) |
threshold | optional: how many rejections before Habits suggests the rule, 1 to 20 |
Add one with ingot add habit <id> --match "<regex>" --rule "<text>". The store rejects a habit whose match isn't a valid regular expression.
MCP server
An MCP server gives the agent new tools. A package declares one or more servers under mcpServers; Ingot writes them into .ingot/mcp.json (see MCP servers).
A local server shipped in the package:
"files": ["server"],
"contributes": {
"mcpServers": {
"word-tools": { "command": "node", "args": ["${extensionDir}/server/index.mjs"] }
}
}
A server from npm that needs an API key:
"mcpServers": {
"acme": { "command": "npx", "args": ["-y", "@acme/mcp-server"], "env": { "ACME_API_KEY": "Your Acme API key (Settings › API)" } }
}
A remote server: { "url": "https://mcp.acme.dev/sse" }.
${extensionDir}is replaced with the folder the extension is installed in.envlists variable names with a description of what to enter, never the value. The values stay empty when the server is installed and the user fills them in (ingot tryprints which ones to set). Never put a real key in the package.- Code the server needs must be listed in
files(only referenced files andfilesentries are packaged). - The starter from
ingot init --type mcpis a dependency-free stdio server with one tool; runnode server/index.mjsto try it.
Rex template
Work that Rex, the Zaprex cloud agent, runs for you in a sandbox: a Markdown file with optional frontmatter (title, schedule as a cron expression) and the instructions as the body.
---
title: Nightly test fix
schedule: "0 3 * * 1-5"
---
Run the test suite. If a test fails, fix the cause with the smallest change and open a pull request.
Rex templates are listed in the Zaprex part of the store. Running them needs a Zaprex plan with Rex (pricing).
Mix and match
Every type can also carry:
rules: extra rules fileshabits: extra Habits patternscommands: slash commands, Markdown prompts that become/<name>in agent chatmcpServers: servers the extension needs
For example, a rules pack for a framework can add a /migrate command and the framework's MCP server. See Manifest for every field.