A-IForgeEngineDocsGetting-started3. Command Map

All Forge commands are available from the Obsidian command palette.


Forge Commands

Core Setup Commands

CommandWhat it doesWrites files?
Forge: Install DocumentationInstalls bundled docs and examples into the Forge folderYes, skips existing files
Forge: Validate SchemaChecks whether A-I/Forge/Schema/schema.md is a valid Forge schemaNo
Forge: Run Vault LintScans notes against schemas, lint rules, and structure checksYes, lint reports and history

Repair and Cleanup Commands

CommandWhat it doesWrites files?
Forge: Normalize TagsCleans, sorts, and deduplicates tags across notesYes, modifies notes
Forge: Normalize FrontmatterReorders frontmatter fields into a consistent structureYes, modifies notes
Forge: Vault RepairOpens an interactive repair workflow for malformed frontmatter and metadata issuesYes, confirmed repairs only
Forge: Vault MaintenanceCleans generated reports, history, and operational files using retention settingsYes, removes old generated files

In Vault Health, cleanup commands that modify notes or remove generated operational files are shown with destructive action styling. This is visual emphasis only; it does not add a new confirmation step.


Patch and Migration Commands

CommandWhat it doesWrites files?
Forge: Apply Vault PatchDry-runs, confirms, and applies operations from A-I/Forge/Engine/Patches/vault-patch.mdYes, changed notes, backups, reports, archives
Forge: Restore Patch RunRestores notes from a previous patch backup manifestYes, restored notes and files

Patch Engine

Export Commands

CommandWhat it doesWrites files?
Forge: Export Vault OverviewGenerates inventory, metadata, and markdown overview exportsYes, export files
Forge: Export Ontology IndexGenerates relationship indexes for selected note groupsYes, per-type JSON and markdown indexes

Vault Export

Shape Commands

CommandWhat it doesWrites files?
Forge: Refine Shape TemplatesBuilds or refreshes shape templates from shape notesYes, template notes
Forge: Run Shape Repair (Dry Run)Previews heading repairs without changing note contentNo
Forge: Run Shape RepairRepairs heading structures using shape templatesYes, backups, repaired notes, reports, history

Shape Validation

Utility Commands

CommandWhat it doesWrites files?
Forge: Rename Dataview FolderUpdates Dataview folder references after folder renamesYes, renamed references and files where applicable

Recommended First Commands

If you are starting with an existing vault, begin with these:

  1. Validate Schema
  2. Run Vault Lint
  3. Run Shape Repair (Dry Run), if using Shapes
  4. Export Vault Overview

These commands are low-risk and help you understand the current state of the vault before making larger changes.


Commands That Modify Notes

Commands that modify notes generally include:

  • previews
  • confirmations
  • dry runs
  • backups
  • reports
  • restore support

Forge is intentionally conservative about vault changes.

Most write operations are designed to be reviewable and reversible.


Typical Workflow

A common Forge workflow looks like this:

  1. Validate schema
  2. Run lint
  3. Review findings
  4. Normalize metadata
  5. Repair inconsistencies
  6. Apply patches if needed
  7. Export summaries and dashboards

Over time, this helps the vault become:

  • easier to query
  • easier to maintain
  • more consistent
  • more reliable for Dataview and Bases
  • easier to use with AI workflows
Built with LogoFlowershow