Releases: xinnjie/onekeymap-cli
Release list
onekeymap-cli 0.8.0
- Improve export summary
- Add export fallback fallback logic
- Fix issues on Windows/Linux
Changelog
- 55bd7c4 doc: update readme
- 2c33cd9 feat: add VSCodeVariant test
- 42a032b feat: add export summary when exporting
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
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.debFedora/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.rpmAlpine (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.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.7.2
Changelog
- 620c9f3 bump version to v0.7.2
- f501f88 chore(deps): bump github.com/hashicorp/go-version from 1.7.0 to 1.8.0
- 799b502 doc: add design doc
- 8e9cf2b doc: add docs/conflict-resolution-design.md docs/vscode-import-behavior-design.md
- 29e5802 doc: add docs/non-destructive-export.md
- 87e8488 feat: action mapping
childrensupport - d84b61a feat: add more config
- 8716cd7 feat: add support for Cursor and Windsurf custom keybindings
- e02933a feat: split UI children and fallback logic
- 71d0e81 fix: fix test across linux
- c4cf3c4 fix: remove device id
- b738053 fix: use standard OTEL environment
- 8617f7e fix: vscode & zed default to macos earlier, now default to right platform
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.2/onekeymap-cli_0.7.2_x86_64.deb
sudo dpkg -i onekeymap-cli_0.7.2_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.2/onekeymap-cli_0.7.2_x86_64.rpm
sudo rpm -i onekeymap-cli_0.7.2_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.2/onekeymap-cli_0.7.2_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.7.2_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.7.1
Remove telemetry
Changelog
- 2b70f23 chore(deps): bump golang.org/x/term from 0.34.0 to 0.36.0 (#18)
- 992d0a1 chore(deps): bump golang.org/x/term from 0.36.0 to 0.37.0 (#20)
- cf770e7 default to disable telemetry
- 733751b feat(TUI): show import skip view when importing
- e43da8f feat: add import skip report
- f33f9fd feat: remove telemetry
- aef2cb6 fix: backslash formating in xcode plugin
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.1/onekeymap-cli_0.7.1_x86_64.deb
sudo dpkg -i onekeymap-cli_0.7.1_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.1/onekeymap-cli_0.7.1_x86_64.rpm
sudo rpm -i onekeymap-cli_0.7.1_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.1/onekeymap-cli_0.7.1_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.7.1_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.7.0
OneKeymap CLI now presents Skipped Actions for Export when exporting keybindings
Changelog
- c8d8a3f add more xcode action mapping
- d436b3a feat: add SkipReport for helix, intellij, vscode, zed
- 3b5997b feat: add SkipReport for xcode
- d23256e feat: support compount text actions for xcode
- fd0e1ae fix: xcode generated
U+0003-ish keybinding, change it to f20 for now.
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.0/onekeymap-cli_0.7.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.7.0_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.0/onekeymap-cli_0.7.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.7.0_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.7.0/onekeymap-cli_0.7.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.7.0_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.6.0
Xcode keybindings exporting is usable after this release.
Changelog
- c39189c feat: add more xcode action
- 60f2a9f feat: unprintable key code support in xcode plugin
- 55e8368 fix: add missing version number in xcode config
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.6.0/onekeymap-cli_0.6.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.6.0_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.6.0/onekeymap-cli_0.6.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.6.0_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.6.0/onekeymap-cli_0.6.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.6.0_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.5.3
Changelog
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.3/onekeymap-cli_0.5.3_x86_64.deb
sudo dpkg -i onekeymap-cli_0.5.3_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.3/onekeymap-cli_0.5.3_x86_64.rpm
sudo rpm -i onekeymap-cli_0.5.3_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.3/onekeymap-cli_0.5.3_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.5.3_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.5.2
Changelog
- 7a9e748 feat: add dev command lookup & mapping
- 7f4d795 feat: add some xcode action mapping config
- 5c2be8b feat: integrate ko build
- 1557b78 feat: xcode initial support
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.2/onekeymap-cli_0.5.2_x86_64.deb
sudo dpkg -i onekeymap-cli_0.5.2_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.2/onekeymap-cli_0.5.2_x86_64.rpm
sudo rpm -i onekeymap-cli_0.5.2_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.2/onekeymap-cli_0.5.2_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.5.2_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.5.1
Changelog
- de8b417 fix: fix failed to save when config is full of comments
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.1/onekeymap-cli_0.5.1_x86_64.deb
sudo dpkg -i onekeymap-cli_0.5.1_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.1/onekeymap-cli_0.5.1_x86_64.rpm
sudo rpm -i onekeymap-cli_0.5.1_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.1/onekeymap-cli_0.5.1_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.5.1_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.5.0
What's Changed
Import Base Keymap of VSCode/Intellij/Zed
🎉Now OneKeymap CLI provides base keymaps for VSCode/Intellij/Zed to import. Then you can get "full" keymap without editor builit-in keymap dependency.

Unknown Actions & Usage Metrics
OneKeymap CLI collects anonymous telemetry data to help improve the tool and is disabled by default. When you first run the CLI in interactive mode, you'll be prompted to opt-in to telemetry. You can also enable or disable it manually in your configuration.
Metrics is mainly to identify missing keymap mappings that should be added. Please see https://github.com/xinnjie/onekeymap-cli/blob/a98306344e5b915b9b0a8200def5a806747c2d4b/docs/telemetry.md for more details.
Changelog
- 437c7ee doc: update version in readme
- 386246d feat: add base keymap like intellij
- 14b6140 feat: add telemetry prompt
- 9eff71f feat: add unknown_action metric
- 0da869b feat: add vscode base keymap
- 9bdbb5b feat: add zed base keymap
- 3ca9135 feat: import from base
- 0cc3194 feat: setup metrics
- e5020c1 fix: conform to OTEL name convention, counter name changes from "onekeymap_xxxx" to "onekeymap.xxxx"
- 2b6ae74 fix: fix config name mismatch
- edfe89f fix: fix intellij base keymap for mac
- 99d421d fix: fix lint
- 9b5e34c fix: fix propmt when importing base keymap, selection if always "intellij-linux" earlier
- e04cdee fix: stop showing vim support in view command
- 0641c82 fix: use otlpmetrichttp instead of otlpmetricgrpc
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.0/onekeymap-cli_0.5.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.5.0_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.0/onekeymap-cli_0.5.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.5.0_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.5.0/onekeymap-cli_0.5.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.5.0_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/onekeymap-cli 0.4.0
Changelog
- 0571064 chore(deps): bump github.com/charmbracelet/huh from 0.7.0 to 0.8.0 (#15)
- 7b3ab37 doc: vscode-actions.json move to https://github.com/xinnjie/onekeymap-page repo
- 2191b3c feat: add more git blame actions
- 55780f0 feat: add onekeymap CLI option to specify keybinding config onekeymap.json location
- 9473e00 feat: add rustrover variant
- 4c3d6e7 feat: support more actions in intellij
- 73884c7 feat: watch onekeymap.json when viewing keybindings
🎉 Intellij actions coverage is high enough to use now.
Installation
macOS
brew tap xinnjie/onekeymap
brew install onekeymap-cliWindows
Scoop
scoop bucket add xinnjie https://github.com/xinnjie/scoop-bucket
scoop install onekeymap-cliManual installation
Extract the zip file and add the directory to your PATH.
Linux
Debian/Ubuntu (deb)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.4.0/onekeymap-cli_0.4.0_x86_64.deb
sudo dpkg -i onekeymap-cli_0.4.0_x86_64.debFedora/RHEL/CentOS (rpm)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.4.0/onekeymap-cli_0.4.0_x86_64.rpm
sudo rpm -i onekeymap-cli_0.4.0_x86_64.rpmAlpine (apk)
wget https://github.com/xinnjie/onekeymap-cli/releases/download/v0.4.0/onekeymap-cli_0.4.0_x86_64.apk
sudo apk add --allow-untrusted onekeymap-cli_0.4.0_x86_64.apkManual installation (Linux/macOS)
tar -xzf onekeymap-cli_*.tar.gz
sudo mv onekeymap-cli /usr/local/bin/