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.

typeStore categoryRequired in contributesRuns in
themeThemesthemesIngot
rulesRules packsrulesIngot
habitsHabits packshabitsIngot
mcpMCP serversmcpServersIngot
rex-templateRex templatesrexTemplatesZaprex

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" }]
}
  • uiTheme is dark or light; 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
}
FieldNotes
idlowercase words joined with -
titlewhat the pattern catches, up to 120 characters
matcha JavaScript regular expression, tested against the rejected lines
rulethe rule text Habits suggests (up to 2,000 characters)
thresholdoptional: 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.
  • env lists 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 try prints which ones to set). Never put a real key in the package.
  • Code the server needs must be listed in files (only referenced files and files entries are packaged).
  • The starter from ingot init --type mcp is a dependency-free stdio server with one tool; run node server/index.mjs to 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 files
  • habits: extra Habits patterns
  • commands: slash commands, Markdown prompts that become /<name> in agent chat
  • mcpServers: 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.