К основному содержанию
плагин

waku-shell — плагин для Claude Code: создание оболочек

Плагин waku-shell для Claude Code создаёт и меняет оболочки waku для Windows. Он берёт за основу скриншот, пост Reddit или готовую оболочку Quickshell.

MIT ★ 115 обновлён 2026-11-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add JanDeDobbeleer/waku
/plugin install waku-shell@waku
Открыть на GitHub

Что делает 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

Похожие плагины

Все плагины по теме «DevOps и инфраструктура» →
maui-shell-navigation dotnet Скилл maui-shell-navigation для Claude Code настраивает Shell-навигацию в .NET MAUI: вкладки, меню и переходы между страницами. Разбирает передачу параметров и подтверждение ухода со страницы. CX Codex +1 4 200установок shell-scripting-pro davila7 Субагент shell-scripting-pro для Claude Code пишет и дорабатывает shell-скрипты для автоматизации, развёртывания и системного администрирования. Подключается к таким задачам и помогает обработать ошибки, процессы и файлы. CX Codex 1 479установок hyva-exec-shell-cmd hyva-themes Скилл hyva-exec-shell-cmd находит стек разработки Magento и оборачивает консольные вызовы для контейнеров или локальной системы. CX Codex +1 1 400установок shell pproenca Скилл shell для Claude Code с 49 правилами по bash и POSIX sh: цитирование переменных, строгий режим, обработка ошибок. Запускается, когда агент пишет или правит скрипты. CX Codex +1 713установок shell-testing-framework manutej Скилл shell-testing-framework помогает проектировать тесты для Bash-скриптов: от структуры Arrange–Act–Assert до проверки покрытия и производительности. CX Codex +1 441установок bun-shell secondsky Скилл bun-shell для Claude Code учит работать с Bun.$, Bun.spawn и подпроцессами: выполнять команды, читать вывод и запускать параллельные процессы из TypeScript. CX Codex +1 413установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой