GitHub - pshirshov/magen

Magen

Magen (MApping GENerator) generates consistent keyboard mappings across multiple editors from a single source of truth.

Supported Editors

• IntelliJ IDEA (and other JetBrains IDEs)
• VSCode / VSCodium
• Zed

How It Works

Magen reads YAML mapping files from mappings/ that define keyboard shortcuts in an editor-agnostic format. Each mapping specifies a binding and editor-specific actions:

- id: "editor.action.rename"
  binding:
    - "${group.transform} ctrl+[KeyR]"
  vscode:
    action: 'editor.action.rename'
  zed:
    action: 'editor::Rename'
    context: [ "Editor" ]
  idea:
    action: 'RenameElement'

Installation

# Run directly with Nix
nix run github:pshirshov/magen

# Or build locally
nix build
./result/bin/magen

Configuration

Additional installation paths can be configured in ~/.config/magen/magen.json:

{
  "installer-paths": {
    "vscode": [],
    "idea": [],
    "zed": []
  }
}

Default installation paths:

• VSCode: ~/.config/VSCodium/User/keybindings.json
• IDEA: ~/.config/JetBrains/*/keymaps/Magen.xml
• Zed: ~/.config/zed/keymap.json

Development

# Enter dev shell
nix develop

# Run
sbt run

# Build fat JAR
sbt assembly

# Regenerate dependency lockfile
nix develop -c bash -c "nix run github:7mind/squish-find-the-brains -- lockfile-config.json 2>/dev/null" > deps.lock.json

Mapping Files