micro-plugins

A collection of Micro editor plugins: format for code formatting, configdel for deleting YAML/JSON keys, and jsonschema for JSON Schema validation.

Installation

Add the channel to your Micro settings (~/.config/micro/settings.json):

{
  "pluginchannels": [
    "https://raw.githubusercontent.com/aaronflorey/micro-plugins/main/channel.json"
  ]
}

Then install plugins from within Micro:

> plugin install format
> plugin install configdel
> plugin install jsonschema

Or from the command line:

micro -plugin install format
micro -plugin install configdel
micro -plugin install jsonschema

Micro installs plugins from downloadable zip archives referenced by each plugin's repo.json.

Plugins

format

Formats the current buffer using a formatter matched to the file type. Prefers project-local binaries, falls back to $PATH.

Formatters by file type:

Language	Formatter
JavaScript, TypeScript, JSX, TSX, JSON, YAML, TOML, HTML, CSS, SCSS, Less, Markdown, MDX, GraphQL, Vue, Handlebars	oxfmt
PHP	ecs
Go	gofmt
Python	ruff format then black
Lua	stylua
Shell	shfmt
Rust	rustfmt

The buffer must be saved to disk first. Format-on-save is enabled by default; disable it:

> set format.onsave false
> setlocal format.onsave false

configdel

Deletes the YAML or JSON key at the cursor position. Requires yq v4+.

Supported filetypes: .yml, .yaml, .json

Place the cursor on or near a key and press Alt-d, or run:

> del-key

jsonschema

Validates .json files against their $schema using the Sourcemeta jsonschema CLI. Failures appear as buffer diagnostics.

Install the CLI:

mise use jsonschema

Validation runs on save by default. Disable it:

> set jsonschema.onsave false
> setlocal jsonschema.onsave false

Disable remote $schema resolution:

> set jsonschema.http false

Development

This repo uses release-please for versioning and GitHub releases, and mise for local tooling.

mise install

Plugin releases are driven by Conventional Commits. release-please opens per-plugin release PRs and tags releases as format-vX.Y.Z, configdel-vX.Y.Z, or jsonschema-vX.Y.Z.

plugins/<name>/version.txt is the canonical release version. The workflow runs bun scripts/sync-plugin-versions.ts to update each plugin's VERSION constant and repo.json before packaging and uploading release assets.

If you want to build the release artifact locally, run:

bun scripts/package-plugin-releases.ts

The script writes release assets to dist/plugin-releases/.

The release-please workflow builds and uploads the matching zip file to each GitHub release in the same workflow run using GITHUB_TOKEN.

License

MIT

Contributing

See CONTRIBUTING.md. By participating, you agree to the Code of Conduct.

Security

See SECURITY.md.