# 使用 Homebrew 安装 kanata-tray

查看 kanata-tray 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:kanata-tray
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install kanata-tray
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:kanata-tray
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/kanata-tray>
- **版本:** 0.8.0
- **来源摘要:** System tray for kanata keyboard remapper
- **主页:** <https://github.com/rszyma/kanata-tray>
- **仓库:** <https://github.com/rszyma/kanata-tray>
- **上游文档:** <https://github.com/rszyma/kanata-tray#readme>
- **许可证:** GPL-3.0-or-later
- **源码归档:** <https://github.com/rszyma/kanata-tray/archive/refs/tags/v0.8.0.tar.gz>
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- kanata-tray (cli)
- kanata-tray (别名)

## 构建依赖

- go
- pkgconf

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.8.0
- 本地数据: OK
- 上游仓库: https://github.com/rszyma/kanata-tray
- 检测到的最新版本: v0.8.0 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

Kanata Tray is a desktop tray wrapper for the Kanata keyboard remapper. It gives Kanata users start, stop, pause, preset switching, layer icons, hooks, and multi-instance control from a tray icon instead of a terminal process.

### 项目历史

The repository was created on 2024-02-07 and v0.1.0 was published on 2024-02-09. The README describes it as a simple wrapper for Kanata that works on Windows, Linux, and macOS.

The project exists because Kanata itself is primarily a keyboard-remapping engine and CLI. Kanata Tray fills the desktop-control gap, while its README notes that Kanata later gained Windows-only native tray-app support and links to a comparison issue.

### 采用历史

Adoption is tied directly to Kanata users who want visible runtime state, quick profile switching, or a friendlier way to start and stop remapping. Homebrew packaging makes the wrapper installable on macOS alongside the `kanata` package.

### 使用方式

Kanata Tray can run without initial configuration and can generate a TOML configuration file on first run. Users define presets that point at Kanata executables and configuration files, then switch or autorun those presets from the tray.

### 为什么软件包爱好者会关心

Kanata Tray is a small example of a companion GUI-ish package around a lower-level CLI daemon. The package is not historically broad, but it matters to desktop package catalogs because it turns a powerful keyboard remapper into something a normal workstation session can supervise.

### 时间线

- 2024: rszyma/kanata-tray repository created and v0.1.0 released.
- 2025: v0.8.0 release added hook-related changes and shutdown fixes.
- 2025: README documented Kanata v1.6.0 as the minimum supported Kanata version.

### Related projects

- Kanata is the keyboard remapper that Kanata Tray controls.
- Kanata's Windows-only tray support is adjacent but does not replace Kanata Tray's cross-platform wrapper role.

### 来源

- <https://api.github.com/repos/rszyma/kanata-tray>
- <https://github.com/jtroo/kanata>
- <https://github.com/rszyma/kanata-tray>
- <https://github.com/rszyma/kanata-tray/issues/24>
- <https://github.com/rszyma/kanata-tray/releases>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** kanata-tray
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/zh-hans/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/zh-hans/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [kanata](https://www.automicvault.com/zh-hans/pkg/brew/kanata/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [libxkbcommon](https://www.automicvault.com/zh-hans/pkg/brew/libxkbcommon/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [kbt](https://www.automicvault.com/zh-hans/pkg/brew/kbt/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [xmodmap](https://www.automicvault.com/zh-hans/pkg/brew/xmodmap/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [xkbcomp](https://www.automicvault.com/zh-hans/pkg/brew/xkbcomp/) - Shares av.db curated category or tags: cli, keyboard, system.
- [showkey](https://www.automicvault.com/zh-hans/pkg/brew/showkey/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [cliclick](https://www.automicvault.com/zh-hans/pkg/brew/cliclick/) - Shares av.db curated category or tags: cli, keyboard, system.
- [paneru](https://www.automicvault.com/zh-hans/pkg/brew/paneru/) - Shares av.db curated category or tags: cli, desktop-utility, system.

## Combined YAML source

View the package source record on GitHub. [combined/kanata-tray.yml](https://github.com/automic-vault/db/blob/main/combined/kanata-tray.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph