onekeymap-cli xinnjie

Use this command to install onekeymap-cli with WinGet:

winget install --id=xinnjie.onekeymap-cli -e

OneKeymap CLI is a command-line tool designed to manage and synchronize keyboard shortcuts across multiple code editors. It streamlines the process of importing, exporting, and maintaining consistent keybindings between popular editors such as VSCode, IntelliJ IDEA, Zed, Helix, and more.

Key Features:

Import editor-specific keymaps into a universal format for easy management.
Export your unified keymap to supported editors with one command.
Synchronize shortcuts across multiple editors to maintain consistency.
View and inspect your keymap in a structured format before deployment.
Supports a growing list of editors, including VSCode, IntelliJ IDEA, Zed, Helix, and more.

Audience & Benefit:
Ideal for developers and coders who use multiple editors and seek to avoid repetitive configuration. By maintaining one universal keymap, users can deploy shortcuts across all supported editors seamlessly, enhancing productivity and reducing friction when switching tools.

Available via winget, OneKeymap CLI is a reliable solution for managing keyboard shortcuts in a cross-platform environment.

OneKeymap CLI

Sync your keyboard shortcuts across all your code editors.

OneKeymap CLI is a powerful command-line tool that lets you import, export, and synchronize keyboard shortcuts between VSCode, IntelliJ IDEA, Zed, Xcode, Helix, and more. Stop reconfiguring keybindings every time you switch editors—maintain one universal keymap and deploy it everywhere.

Import Keymap	View Keymap	Export Keymap

Auto-detects your editor's keymap file and lets you know keybindings to import.	View keybindings by category and navigate with arrow keys.	Shows a diff of your target keymap file before exporting.

🚀 Quick Start

Installation

macOS

Homebrew

brew tap xinnjie/onekeymap
brew install onekeymap-cli

Linux

Debian/Ubuntu (.deb)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.8.0_x86_64.deb

Fedora/RHEL/CentOS (.rpm)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.8.0_x86_64.rpm

Alpine (.apk)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.8.0_x86_64.apk

Windows

Scoop

scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cli

Winget
```
winget install xinnjie.onekeymap-cli
```

Zip Archive Download onekeymap-cli_Windows_.zip from GitHub Releases, extract it, and add the directory to your PATH, or run:

Expand-Archive -Path .\onekeymap-cli_*.zip -DestinationPath "$Env:USERPROFILE\onekeymap-cli"
setx PATH "$Env:USERPROFILE\onekeymap-cli;$Env:PATH"

Cross-platform (Linux/MacOS/Windows)

Go Install

go install github.com/xinnjie/onekeymap-cli/cmd/onekeymap-cli@latest

From Release: Download the latest binary from GitHub Releases.

Basic Usage

Import from editors interactively:

onekeymap-cli import

Export to editors interactively:

onekeymap-cli export

Useful Commands

The following commands help you get the most from the OneKeymap CLI:

onekeymap-cli help Quick summary of all subcommands and available flags.
onekeymap-cli import Convert editor-specific shortcuts into the universal onekeymap.json format.
onekeymap-cli export Generate editor keymap files from your universal keymap.
onekeymap-cli migrate Chain import and export in one step to move between editors.
onekeymap-cli view Inspect the actions and bindings stored in an existing universal keymap.

You can append -h or --help to any subcommand for detailed flag descriptions and examples.

Configuration

OneKeymap can be configured via a config file at ~/.config/onekeymap/config.yaml:

# Default path for universal keymap
onekeymap: ~/.config/onekeymap/keymap.json

# Editor-specific config paths (optional, auto-detected by default)
editors:
  vscode:
    keymap_path: ~/Library/Application Support/Code/User/keybindings.json
  zed:
    keymap_path: ~/.config/zed/keymap.json
  intellij:
    keymap_path: ~/Library/Application Support/JetBrains/IntelliJIdea2024.1/keymaps/custom.xml

🧩 Supported Editors

Editor	Import	Export	Notes
VSCode	✅	✅
Zed	✅	✅
IntelliJ IDEA	✅	✅
Xcode(experimental)	✅	✅	shortcut coverage is still limited (see Action Support Matrix)
Helix(experimental)	❌	✅	TOML configuration support; shortcut coverage is still limited (see Action Support Matrix)
Vim/Neovim	🚧	🚧	Planned, upvote this issue
Emacs	🚧	🚧	Planned, upvote this issue

> See all supported actions: docs/action-support-matrix.md

Want support for more editors? Open an issue and upvote existing requests

Key Features

Keymap configure once, use everywhere
Importing default keybindings of VSCode, Zed, Intellij IDEA, Xcode
Non-destructive export: exporting keymaps to editors while preserving user's existing custom keybindings

Contributing

Contributions are welcome! Check out the Contributing Guide for more details on how to get started. Here are some ways you can help:

Add Editor Support: Implement a new editor plugin
Improve Mappings: Enhance the action mapping configuration
Report Bugs: Open an issue with reproduction steps
Documentation: Improve docs and examples

For development setup and building from source, see the Development section in CONTRIBUTING.md.

Support

Issues:
Discussions:

How It Works

OneKeymap uses a universal keymap format that represents keyboard shortcuts in an editor-agnostic way. Here's the workflow:

┌─────────────┐
│   VSCode    │──┐
│  Keybindings│  │
└─────────────┘  │
                 │  Import
┌─────────────┐  │    ↓
│  IntelliJ   │──┼──────────────┐
│   Keymap    │  │              │
└─────────────┘  │    ┌─────────▼──────────┐
                 │    │  Universal Keymap  │
┌─────────────┐  │    │   (onekeymap.json) │
│     Zed     │──┘    └─────────┬──────────┘
│   Keymap    │                 │
└─────────────┘       Export    ↓
                 ┌───────────────────────┐
                 │  Any Supported Editor │
                 └───────────────────────┘

Universal Keymap Format

Your keymap is stored in a clean, human-readable JSON format:

{
  "keymaps": [
    {
      "action": "actions.edit.copy",
      "keys": "ctrl+c"
    },
    {
      "action": "actions.view.showCommandPalette",
      "keys": "ctrl+shift+p"
    },
    {
      "action": "actions.editor.quickFix",
      "keys": "ctrl+."
    }
  ]
}

Action Mappings

OneKeymap maintains a comprehensive mapping that translates between editor-specific commands and universal actions. For example:

actions.edit.copy maps to:
- VSCode: editor.action.clipboardCopyAction
- IntelliJ: $Copy
- Zed: editor::Copy

This mapping layer handles context-specific behaviors, stateful toggles, and editor quirks automatically.

✨ Companion App: OneKeymap GUI

Prefer a polished interface? Take a look at OneKeymap.app—a paid GUI companion built on top of the CLI. onekeymap-cli will always remain free and open; the app is simply an optional bonus for those who enjoy visual workflows.

OneKeymap CLI

Sync your keyboard shortcuts across all your code editors.

Import Keymap	View Keymap	Export Keymap

Auto-detects your editor's keymap file and lets you know keybindings to import.	View keybindings by category and navigate with arrow keys.	Shows a diff of your target keymap file before exporting.

🚀 Quick Start

Installation

macOS

Homebrew

brew tap xinnjie/onekeymap
brew install onekeymap-cli

Linux

Debian/Ubuntu (.deb)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.8.0_x86_64.deb

Fedora/RHEL/CentOS (.rpm)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.8.0_x86_64.rpm

Alpine (.apk)

wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.8.0/onekeymap-cli_0.8.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.8.0_x86_64.apk

Windows

Scoop

scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cli

Winget
```
winget install xinnjie.onekeymap-cli
```

Zip Archive Download onekeymap-cli_Windows_.zip from GitHub Releases, extract it, and add the directory to your PATH, or run:

Expand-Archive -Path .\onekeymap-cli_*.zip -DestinationPath "$Env:USERPROFILE\onekeymap-cli"
setx PATH "$Env:USERPROFILE\onekeymap-cli;$Env:PATH"

Cross-platform (Linux/MacOS/Windows)

Go Install

go install github.com/xinnjie/onekeymap-cli/cmd/onekeymap-cli@latest

From Release: Download the latest binary from GitHub Releases.

Basic Usage

Import from editors interactively:

onekeymap-cli import

Export to editors interactively:

onekeymap-cli export

Useful Commands

The following commands help you get the most from the OneKeymap CLI:

onekeymap-cli help Quick summary of all subcommands and available flags.
onekeymap-cli import Convert editor-specific shortcuts into the universal onekeymap.json format.
onekeymap-cli export Generate editor keymap files from your universal keymap.
onekeymap-cli migrate Chain import and export in one step to move between editors.
onekeymap-cli view Inspect the actions and bindings stored in an existing universal keymap.

You can append -h or --help to any subcommand for detailed flag descriptions and examples.

Configuration

OneKeymap can be configured via a config file at ~/.config/onekeymap/config.yaml:

# Default path for universal keymap
onekeymap: ~/.config/onekeymap/keymap.json

# Editor-specific config paths (optional, auto-detected by default)
editors:
  vscode:
    keymap_path: ~/Library/Application Support/Code/User/keybindings.json
  zed:
    keymap_path: ~/.config/zed/keymap.json
  intellij:
    keymap_path: ~/Library/Application Support/JetBrains/IntelliJIdea2024.1/keymaps/custom.xml

🧩 Supported Editors

Editor	Import	Export	Notes
VSCode	✅	✅
Zed	✅	✅
IntelliJ IDEA	✅	✅
Xcode(experimental)	✅	✅	shortcut coverage is still limited (see Action Support Matrix)
Helix(experimental)	❌	✅	TOML configuration support; shortcut coverage is still limited (see Action Support Matrix)
Vim/Neovim	🚧	🚧	Planned, upvote this issue
Emacs	🚧	🚧	Planned, upvote this issue

> See all supported actions: docs/action-support-matrix.md

Want support for more editors? Open an issue and upvote existing requests

Key Features

Keymap configure once, use everywhere
Importing default keybindings of VSCode, Zed, Intellij IDEA, Xcode
Non-destructive export: exporting keymaps to editors while preserving user's existing custom keybindings

Contributing

Contributions are welcome! Check out the Contributing Guide for more details on how to get started. Here are some ways you can help:

Add Editor Support: Implement a new editor plugin
Improve Mappings: Enhance the action mapping configuration
Report Bugs: Open an issue with reproduction steps
Documentation: Improve docs and examples

For development setup and building from source, see the Development section in CONTRIBUTING.md.

Support

Issues:
Discussions:

How It Works

OneKeymap uses a universal keymap format that represents keyboard shortcuts in an editor-agnostic way. Here's the workflow:

┌─────────────┐
│   VSCode    │──┐
│  Keybindings│  │
└─────────────┘  │
                 │  Import
┌─────────────┐  │    ↓
│  IntelliJ   │──┼──────────────┐
│   Keymap    │  │              │
└─────────────┘  │    ┌─────────▼──────────┐
                 │    │  Universal Keymap  │
┌─────────────┐  │    │   (onekeymap.json) │
│     Zed     │──┘    └─────────┬──────────┘
│   Keymap    │                 │
└─────────────┘       Export    ↓
                 ┌───────────────────────┐
                 │  Any Supported Editor │
                 └───────────────────────┘

Universal Keymap Format

Your keymap is stored in a clean, human-readable JSON format:

{
  "keymaps": [
    {
      "action": "actions.edit.copy",
      "keys": "ctrl+c"
    },
    {
      "action": "actions.view.showCommandPalette",
      "keys": "ctrl+shift+p"
    },
    {
      "action": "actions.editor.quickFix",
      "keys": "ctrl+."
    }
  ]
}

Action Mappings

OneKeymap maintains a comprehensive mapping that translates between editor-specific commands and universal actions. For example:

actions.edit.copy maps to:
- VSCode: editor.action.clipboardCopyAction
- IntelliJ: $Copy
- Zed: editor::Copy

This mapping layer handles context-specific behaviors, stateful toggles, and editor quirks automatically.

onekeymap-cli xinnjie

README

OneKeymap CLI

🚀 Quick Start

Installation

macOS

Linux

Windows

Cross-platform (Linux/MacOS/Windows)

Basic Usage

Useful Commands

🧩 Supported Editors

Key Features

Contributing

Support

Universal Keymap Format

Action Mappings

✨ Companion App: OneKeymap GUI

onekeymap-cli xinnjie

README

OneKeymap CLI

🚀 Quick Start

Installation

macOS

Linux

Windows

Cross-platform (Linux/MacOS/Windows)

Basic Usage

Useful Commands

🧩 Supported Editors

Key Features

Contributing

Support

Universal Keymap Format

Action Mappings

✨ Companion App: OneKeymap GUI