Beta Coming soon. This feature is still being built, so names and details may change before it ships.

.ingot folder

.ingot is where Ingot keeps everything for a project: rules, core rules, habits, knowledge, agents, skills, commands and workflows. Everything in it is a plain file. The agent reads the files on its own, and it writes new habits and knowledge when it learns something. Each save shows up in the chat with Undo and Open. You can see and change the files from the chat with slash commands, so you never need a Settings page for this.

The agent chat: /ingot lists the folders in .ingot with a file count for eachThe agent chat: /ingot lists the folders in .ingot with a file count for each
The agent chat: /ingot lists the folders in .ingot with a file count for each

.ingot is primary

.ingot replaces the existing editor's folder inside Ingot. It is the source of truth, and the agent reads it first. Rules from the existing editor's folder are imported into .ingot on first open and then kept in sync for teams that still use both. Settings › Sync existing editor rules turns the sync off. Ingot never deletes or changes the other folder. It writes back to that folder's format only when you ask.

Automatic and by hand

  • Automatic: when you open a project that has no .ingot, Ingot creates the base tree: core, agents, skills, habits, mcp-flow, workflows, knowledge (with decisions and dependencies), context, quality, integrations, telemetry, commands and rules. You don't have to set anything up. The setting is ingot.ingotFolder.createOnOpen.
  • By hand: .ingot is a normal, visible folder in the Explorer. Edit, add or delete any file in it. A new rule in rules/ or a changed one is used on the next turn, with no reload or registration.
  • Your edits win: the agent never rewrites a habit or knowledge file you changed, or an entry you wrote. Instead, the chat shows Kept your version.

Slash commands

Type / in the agent chat to see these commands:

CommandWhat it does
/ingotAn overview: each folder in .ingot that has files, with a count. Click a folder to show it in the Explorer.
/rulesThe rules in .ingot/rules and .ingot/core, with their description. Click one to open it.
/habitsThe habits in .ingot/habits, by folder and class.
/knowledge [words]The knowledge entries by kind, with version and confidence. Add words to search.
/remember <text>Saves a habit, or a fact (see below).
/forget <name>Deletes a habit, knowledge entry or rule by name. Undo brings it back.

These commands only read and write files. Nothing goes to the model.

Remember and forget

The agent chat: /remember saved a habit, then /habits lists it with its classThe agent chat: /remember saved a habit, then /habits lists it with its class
The agent chat: /remember saved a habit, then /habits lists it with its class
  • /remember Use named exports saves a habit in .ingot/habits/coding/ as a project convention. The agent follows it from the next turn.
  • To save the habit in another folder, start with workflow: or architecture:, as in /remember workflow: Run scripts with pnpm.
  • To save a knowledge entry instead, start with decision:, dependency:, history: or project:, as in /remember decision: Totals are kept in cents | Floats broke rounding. The part before | is the title.
  • Every save is checked for secrets first. A token, a private key or a password is never written.
  • /forget run scripts with pnpm deletes the file, and the chat shows Forgot … · Undo.
    • If more than one thing matches, Ingot lists the matches and asks you to use more of the name.
    • If you forget a habit the agent learned, the agent won't learn it again.

Settings

SettingDefaultWhere
ingot.ingotFolder.slashCommandsonSettings › .ingot Folder, Settings › Features › .ingot slash commands

Open .ingot Folder (on the same Settings page, or in Find Action) shows the folder in the Explorer. If the project has no .ingot folder yet, it creates one first. When the switch is off, the commands are not listed, and typing one sends it to the agent as plain text.

Commit .ingot to share it with your team. See also Habit classes, Knowledge and Slash commands.