See your schema.
Keep the TOML.

The TOML Schema Editor turns .tosd documents into a visual map inside the GitHub Copilot App—while the canonical TOML stays visible, inspectable, and yours.

Open the repository How to open the editor
Project canvas extension Visual structure. Live source. One workspace.
TOML Schema Editor with the config schema visualized as connected nodes, a selected field's properties on the right, and generated TOML below
Navigate the shape Follow tables, arrays, collections, and reusable type references as a connected schema map. Edit with context Change type, constraints, documentation, and children from focused property controls. Trust the source Watch the canonical TOML update and resolve structural issues before saving.

Every route into a schema, in one canvas.

Start from an existing definition, a representative TOML file, or a plain-language description.

01

Open and map

Load an existing .tosd document and move between elements and reusable types without losing its hierarchy.

02

Infer from TOML

Use a representative TOML document to infer an editable starting structure, then refine the constraints that matter.

03

Generate with Copilot

Describe sections, fields, and rules in natural language. Copilot drafts the schema for review before anything is saved.

04

Preview and validate

Inspect generated TOML and structural issues together. Save only after the editor's model validation passes.

Generate schema with Copilot dialog asking for a description of the configuration file

Describe the configuration. Review the schema.

Copilot generation is deliberately reviewable: the draft replaces the in-memory model, the live preview exposes the resulting TOML, and the file is not written until you choose Save.

  • Undo and redo preserve meaningful editing steps.
  • Validation issues stay beside the generated TOML.
  • Revert reloads the checked-in file from disk.

Author visually. Validate in the terminal.

The editor and the canonical tosd CLI work on the same .tosd source. Save the schema, then run the check locally or in CI without converting formats.

Open the complete CLI documentation
  1. 1
    Install the release The verified installer supports Linux and Apple Silicon macOS and writes to $HOME/.local/bin.
  2. 2
    Save the schema Use the editor to review the live TOML, resolve structural issues, and save the canonical .tosd file.
  3. 3
    Validate the document Pass the schema explicitly or let tosd discover it from [toml-schema].location.
Install version 1.0.0-rc.2 
curl --proto '=https' --tlsv1.2 -sSfL \
  https://github.com/brunoborges/toml-schema/releases/download/rust-v1.0.0-rc.2/install-tosd.sh |
  bash -s -- --version 1.0.0-rc.2
Explicit schema
tosd validate config.tosd config.toml
Schema discovery
tosd validate config.toml

Windows users install from the release archive. Checksums, destination overrides, extraction, and all supported commands are covered in the Rust reference implementation guide.

Open the canvas in three moves.

The editor is a project extension in this repository and loads automatically when the project is opened in the GitHub Copilot App.

  1. 1Open the repositoryClone or open brunoborges/toml-schema in the GitHub Copilot App.
  2. 2Choose a schemaUse config.tosd, toml-schema.tosd, or another .tosd file.
  3. 3Ask CopilotSay: “Open config.tosd in the TOML Schema Editor.”
View the repository on GitHub Inspect the extension source

Community tooling

The third-party TOML Schema LSP and VS Code extension provides real-time validation using local .tosd schemas.