waku-shell — плагин для Claude Code: создание оболочек
Плагин waku-shell для Claude Code создаёт и меняет оболочки waku для Windows. Он берёт за основу скриншот, пост Reddit или готовую оболочку Quickshell.
MIT ★ 115 обновлён 2026-11-16
/plugin marketplace add JanDeDobbeleer/waku
/plugin install waku-shell@wakuЧто делает waku-shell
Плагин помогает агенту собрать оболочку waku по скриншоту, публикации на Reddit или существующей конфигурации Quickshell. Он формирует спецификацию по образцу, оставляет элементы с работающей backend-реализацией для Windows, а остальные убирает и перечисляет. Перед передачей агент проверяет оболочку.
Навык умеет создавать оболочку с нуля, переносить готовую или менять её стиль. Для запуска в Claude Code используйте команду /waku-shell:waku-shell либо опишите нужный результат. Совместимость с Quickshell помогает при переносе, но отличия waku от него сохраняются.
Какие задачи решает
- воссоздать оболочку waku по скриншоту
- перенести конфигурацию Quickshell для Windows
- изменить стиль существующей оболочки waku
- убрать элементы без работающей реализации для Windows
Примеры запросов агенту
- Создай оболочку waku для Windows по этому скриншоту и проверь её.
- Перенеси эту оболочку Quickshell в waku, оставив работающие в Windows элементы.
- Измени стиль моей оболочки waku по этой публикации Reddit.
Как установить waku-shell
Через маркетплейс плагинов
/plugin marketplace add JanDeDobbeleer/waku/plugin install waku-shell@wakuПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о waku-shell
Как установить waku-shell в Claude Code?
Выполните /plugin marketplace add JanDeDobbeleer/waku и затем /plugin install waku-shell@waku. Запустите навык командой /waku-shell:waku-shell.
Что делает waku-shell?
Навык создаёт, переносит или меняет стиль оболочки waku по скриншоту, публикации Reddit либо оболочке Quickshell. Он удаляет элементы без работающей backend-реализации для Windows и проверяет результат перед передачей.
Может ли waku-shell перенести оболочку Quickshell?
Да. Навык использует существующую оболочку Quickshell как основу и учитывает, что waku совместим с Quickshell с небольшими изменениями.
Исходный текст
SKILL.md · MIT
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/waku-logo-dark.svg">
<img src="docs/assets/waku-logo.svg" alt="waku, the Windows shell bar" width="360">
</picture>
</p>
# waku
> **waku is in active development.** Expect breaking changes: flags, config options, QML types and
> file formats can change or go away between releases without a deprecation period.
waku (枠, "frame", say "wah-koo") is a top bar for Windows, written in C++23 and Qt 6.12
(Qt Quick) and configured in QML. The name is the Japanese word for the frame around a window
(Dutch: kozijn), and the frame of your desktop is where the bar lives.
Built-in widgets cover the clock, workspaces (Windows virtual desktops), media, volume, Bluetooth,
Wi-Fi, battery, CPU, memory, the tray, the taskbar, notifications, GitHub, wallpapers and a control
center. You can copy any of them into your config and change it.
## Install
Download the MSIX for your processor (`waku-x64.msix` or `waku-arm64.msix`) from the
[latest release](https://github.com/JanDeDobbeleer/waku/releases/latest) and open it.
Then start `waku` from the Start menu or a terminal.
The full guide is in the [wiki](https://github.com/JanDeDobbeleer/waku/wiki/Installation).
## Customise
waku reads its config from a folder, the config home: `--config-home <dir>`, then the
`WAKU_CONFIG_HOME` variable, then `%USERPROFILE%\.config\waku`. Without a `shell.qml` there, you get
a built-in bar.
`shell.qml` says which bars to show and which widgets go where; `theme.qml` sets the look. Save
either file and the bar reloads. Run `wakuc config init` to write a starter `shell.qml` into the
config home; [examples/config](examples/config) has a fuller sample.
```qml
import waku
import waku.widgets
ShellRoot {
Panel {
edge: Panel.Top
thickness: 40
content: PanelLayout {
start: [ Clock {} ]
end: [ Volume {}, Battery {} ]
}
}
}
```
`wakuc` controls the running bar (`reload`, `status`, `quit` and more). See
[src/app/README.md](src/app/README.md) for its commands.
## Shells
waku is Quickshell-compatible, so shells written for Quickshell run with few changes. Ready-made
shells ported to Windows (Celeste, Octalia, Nomarchy) are in
[waku-ports](https://github.com/JanDeDobbeleer/waku-ports). Copy one into your config home. What
differs from Quickshell is in [docs/shells.md](docs/shells.md).
### Build your own shell with an AI agent
The repository ships a skill, `waku-shell`, that helps an agent create, port or restyle a shell from
a screenshot, a Reddit post (such as an r/unixporn URL) or an existing Quickshell shell. It works
from a measured spec, keeps only elements that have a real backend on Windows, drops and reports
the rest, and checks each shell before it hands it over. Source: [skills/waku-shell](skills/waku-shell).
Claude Code:
```
claude plugin marketplace add JanDeDobbeleer/waku
claude plugin install waku-shell@waku
```
Then ask for what you want, for example "recreate the look of this screenshot as a waku shell", or
run `/waku-shell:waku-shell`. In Claude Code 2.1.275 or later,
`/plugin install waku-shell --marketplace JanDeDobbeleer/waku` does both steps.
Other agents (Codex, Cursor and others) can install the skill folder with the
[skills CLI](https://vercel.com/docs/agent-resources/skills):
```
npx skills add JanDeDobbeleer/waku --skill waku-shell
```
or copy `skills/waku-shell` into your agent's skills folder.
## Key bindings
waku includes `wakukeys`, a hotkey daemon that reads `keys.conf` in your config home. See the
[sample bindings](examples/config/keys.conf) and the
[wakukeys guide](https://github.com/JanDeDobbeleer/waku/wiki/wakukeys).
## Build from source
Install Visual Studio Build Tools, Qt 6.12 and vcpkg, then:
```powershell
cmake --preset arm64-release
cmake --build --preset arm64-release
```
Use `x64-release` on an x64 PC. Prerequisites, presets and the flags of `waku` are in
[docs/building.md](docs/building.md).
## Documentation
| Document | What it covers |
| --- | --- |
| [Installation guide](https://github.com/JanDeDobbeleer/waku/wiki/Installation) | Install from the MSIX, first run, updates, troubleshooting |
| [docs/shells.md](docs/shells.md) | Notes for shell authors: what differs from Quickshell |
| [docs/building.md](docs/building.md) | Prerequisites, presets, deploy, command-line flags |
| [docs/architecture.md](docs/architecture.md) | Units and layering, threads, singletons, error policy |
| [src/app/README.md](src/app/README.md) | Running `waku` and `wakuc`, config home, QML modules |
| [SECURITY.md](SECURITY.md) | Threat model and how to report a problem |
## Licence and credits
waku is released under the MIT licence ([LICENSE](LICENSE)). It began as a C++ port of
[YASB](https://github.com/amnweb/yasb) and still uses what YASB found out about Windows (tray
messages, window tracking, notifications). [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) holds the
notices that must travel with any copy.
© Jan De Dobbeleer · MIT · JanDeDobbeleer/waku