coc-toml

TOML language server extension for coc.nvim.

Powered by Tombi.

Breaking Changes in v2.0

v2.0 is a complete rewrite with the following breaking changes:

Language Server: Taplo → Tombi

The underlying language server has been replaced from Taplo to Tombi. Tombi runs as a native binary (tombi lsp) — WASM is no longer used.

The tombi binary is automatically downloaded when the extension activates. You can also specify a custom path via tombi.path setting.

Configuration namespace: toml.* → tombi.*

All settings have been renamed:

| v1.x (toml.*) | v2.0 (tombi.*) | |---|---| | toml.enabled | tombi.enabled | | toml.activationStatus | (removed) | | toml.taploConfig | (project-level tombi.toml instead now. global config will be implemented later) | | toml.taploConfigEnabled | (removed) | | toml.semanticTokens | (removed — handled by Tombi) | | toml.formatter.* | (project-level tombi.toml instead. global config will be implemented later) | | toml.schema.* | (project-level tombi.toml instead. global config will be implemented later) | | (new) | tombi.path | | (new) | tombi.args | | (new) | tombi.env |

Commands renamed

| v1.x | v2.0 | |---|---| | toml.syntaxTree | (removed) | | toml.downloadSchemas | tombi.refreshCache | | toml.tomlToJson | (removed) | | toml.jsonToToml | (removed) | | (new) | tombi.selectSchema | | (new) | tombi.showLanguageServerVersion | | (new) | tombi.restartLanguageServer |

Schema configuration

Schemas are now configured in project-level tombi.toml or .tombi.toml files, not in coc-settings.json. See Tombi documentation for details. Global config by coc-settings.json will be implemented later.

Install

Prerequisites

• coc.nvim >= 0.0.82

:CocInstall coc-toml

Or via plugin manager (e.g., dein.vim):

[[plugins]]
repo    = 'kkiyama117/coc-toml'
depends = 'coc.nvim'

Configuration

Add to your coc-settings.json (:CocConfig):

{
  "tombi.enabled": true,
  "tombi.path": null,
  "tombi.args": [],
  "tombi.env": {},
  "tombi.tomlVersion": "v1.1.0",
  "tombi.schemas": []
}

| Setting | Description | Default | |---|---|---| | tombi.enabled | Enable the extension | true | | tombi.path | Absolute path to the tombi executable. If not set, searches PATH. | null | | tombi.args | Additional arguments passed to tombi lsp | [] | | tombi.env | Environment variables passed to the tombi process | {} | | tombi.tomlVersion | Default TOML version ("v1.0.0" or "v1.1.0"). Sent to Tombi via workspace/didChangeConfiguration and used as fallback for tombi.schemas entries that omit tomlVersion. Schema/comment directives still take precedence. | "v1.1.0" | | tombi.schemas | Editor-level JSON schema associations registered on startup. Each entry calls tombi/associateSchema. | [] |

Formatter, linter, and project-wide schema settings are configured in project-level tombi.toml files. For editor-level schema overrides (similar to yaml.schemas in coc-yaml), use tombi.schemas:

{
  "tombi.schemas": [
    {
      "uri": "https://json.schemastore.org/cargo.json",
      "fileMatch": ["Cargo.toml"],
      "tomlVersion": "v1.1.0"
    },
    {
      "uri": "https://json.schemastore.org/pyproject.json",
      "fileMatch": ["pyproject.toml"]
    }
  ]
}

Commands

| Command | Description | |---|---| | tombi.refreshCache | Refresh schema cache | | tombi.selectSchema | Select schema for current file | | tombi.showLanguageServerVersion | Show Tombi version | | tombi.restartLanguageServer | Restart the language server |

Features

• Formatting and linting for TOML files
• Completion with schema validation
• Go-to-definition and hover
• Diagnostics
• Schema association

Develop

pnpm install --frozen-lockfile
pnpm build

Testing

Smoke tests run inside a container so they are reproducible across hosts. Both Docker and Podman work — the pnpm docker:* scripts use the docker CLI name, and Podman ships a docker alias by default.

# Build the image and run every scenario (build check + all fixtures).
pnpm test

# Or step through pieces:
pnpm docker:build                # build the test image
pnpm docker:test                 # build artifact + tombi binary check
pnpm docker:test:all             # all scenarios

# Interactive shell / nvim inside the image:
pnpm docker:shell
pnpm docker:nvim

A docker/compose.yaml is also provided for docker compose / podman compose users — see pnpm compose:test, compose:test:all, compose:shell, and compose:nvim.

License

MIT.

Dependencies

• Tombi — TOML language server
• coc.nvim