Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatLet Claude Code, Codex, Pi or any MCP agent see and drive your niri desktop: windows, screenshots, buttons by name, keys and clicks, with a stop key you hold.
Asked: "In Files, put the two screenshots into a new folder called release-0.1, then bring me back here." This is a real Claude Code session (Opus 5.5) on a niri 26.04 desktop, with the installed server; nothing was scripted. The agent's keyboard shortcut doesn't open the dialog, so it uses the right-click menu instead. Thinking time between calls is shortened; the calls play in real time. The full 19-second recording (MP4).
Documentation: https://ayagmar.github.io/niri-computer-use/, also as plain Markdown for agents (llms.txt).
status.It offers up to 22 tools over stdio: reading the desktop, screenshots it can save to ~/Pictures/niri-computer-use, zooming into part of a screenshot to read small text, accessible elements, and, under the lease, focus, launch, close, niri's layout actions, pointer, keyboard, paste, element actions and three Noctalia panels. Acceptance evidence for each milestone is in docs/results/. It is in early development.
Release builds exist for x86_64 and aarch64 Linux, and both need glibc 2.39 or newer and libxkbcommon. Either way you need niri 26.04, and grim and loginctl at run time, plus notify-send if you turn on confirm_lease.
Two ways to install, both giving the same server:
With the install script. Pipe it into sh, or download it with curl -fsSLO to read it first. It puts the binary in ~/.local/bin, copies the skill that tells your agents how to use the server to ~/.local/share/niri-computer-use, links it from ~/.claude/skills and ~/.agents/skills, links the Noctalia plugin when Noctalia is installed, and ends with the steps in the Quickstart below. The install script lists every file it writes, what it checks, NCU_VERSION and NCU_BIN_DIR, and how to uninstall.
curl -fsSL https://github.com/ayagmar/niri-computer-use/releases/latest/download/install.sh | sh
With cargo. With Rust 1.99 or newer and libxkbcommon's headers (libxkbcommon-dev on Debian and Ubuntu, libxkbcommon on Arch), cargo builds the crate from crates.io into ~/.cargo/bin:
cargo install --locked niri-computer-use
The crate holds no skill. Install it with the skills CLI, which copies it into ~/.agents/skills and links it from ~/.claude/skills, or link skills/niri-computer-use from a clone:
npx skills add ayagmar/niri-computer-use --skill niri-computer-use --agent claude-code --agent pi --agent codex -g
Install has the full steps, among them building from a clone, installing by hand from the tarball and updating while agents run.
From a shell inside your niri session, with the binary where you put it:
~/.local/bin/niri-computer-use status
status prints a readiness report as JSON; niri.compat should be ok. The install script offers to register the server in each agent it supports that it finds on PATH (Claude Code, Pi, Codex, Amp, GitHub Copilot CLI, Gemini CLI and Qwen Code), through the agent's own command. To do it yourself, here for Claude Code:
claude mcp add --scope user niri-computer-use -- ~/.local/bin/niri-computer-use serve
Client setup covers Codex, Pi and other MCP clients. None needs more than the command: the server finds your niri session itself when its environment lacks one.
Then bind the stop key in your niri config, with the binary's full path:
binds {
Mod+Shift+Escape allow-inhibiting=false allow-when-locked=true hotkey-overlay-title="Stop the AI agent (niri-computer-use)" { spawn "/home/you/.local/bin/niri-computer-use" "stop"; }
}
The key cancels the running action and takes the lease back; ~/.local/bin/niri-computer-use resume (or ~/.cargo/bin/… after cargo install) lets agents act again. First session walks through the rest.
Here is one run with every call and a full result. It is run 1791814792-1684005 of the following command, with the model claude-sonnet-5-5 through Claude Code 2.1.296 and the server at 8faae79, in a headless nested niri:
make nested-eval SCENARIO=errand SKILL=skills/niri-computer-use MODEL=sonnet
The prompt:
Open my notes app, then type exactly
Meeting moved to 3pminto the wev window and press Enter once to send it, then close the notes window you opened, and leave me on the window I was on.
The agent's eight calls:
status
desktop_state
acquire_desktop
launch {"preset": "notes"}
focus {"window_id": 2}
type_text {"text": "Meeting moved to 3pm", "expect": {"window_id": 2}, "submit": true, "screenshot": true}
close_window {"id": 4}
release_desktop {"restore_focus": true}
What launch answered:
{
"accepted": true,
"observed": "one",
"windows": [4],
"focused_window": 4,
"changes": {
"focus": {"from": 3, "to": 4},
"opened": [{"app_id": "notes", "id": 4, "title": "harness window", "workspace_id": 1}]
}
}
accepted says niri took the request, observed what niri saw afterwards, and changes what niri saw change. The grader passed all nine of its checks, among them one launch, exactly the 20 characters before a single Enter, the notes window closed, and focus back on the user's window. The calls with their results and the grading are in docs/results/readme-example.md.
confirm_lease on, you allow each lease on a desktop notification before the agent gets it, even when its client approves tool calls without asking you. It is off by default.expect has focus, unless it passes "none". Text goes out one key at a time, with focus checked again before each key, and the lock state read again once its last read is over 250 ms old. Pointer and keyboard input is refused while an app on your deny list has focus, and element actions on its windows.unrestricted lifts that and allows niri's gated actions such as Spawn.What isn't protected: any connected agent sees your screen and window titles, a click can land on a denied window that doesn't have focus, typing and clicking don't check for password fields, a lock that comes after the last read isn't caught, and an agent that can run shell commands can answer the confirm_lease notification itself. A click or a key can do anything you could do. Read Safety before letting an agent act, and SECURITY.md to report a problem.
main still reports 26.04, so the server acts on it, but it isn't a supported release: against main at fc9e8c4, typing around a keyboard layout switch went wrong in the nested checks.Normal. The keyboard, screenshots and the other tools work with any monitors.policy.toml, launch presets, the deny list, unrestricted, confirm_lease, the shared engine and tool profilesserve, status, stop, resume, recover, watchllms.txt, and the skill at stable URLsSee docs/development.md and CONTRIBUTING.md.
MIT. See LICENSE. Built binaries include niri-ipc, which is GPL-3.0-or-later, so a distributed binary follows GPL-3.0 terms.
MCP server for AI agents to observe and drive a niri Wayland desktop. Early development.
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Niri Computer Use yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-11-05. MCP server for AI agents to observe and drive a niri Wayland desktop. Early development.