niri-computer-use
MCP server letting AI agents observe and drive a niri Wayland desktop.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Rust 1.99 or newer - System packages:
grim,loginctl,notify-send,libxkbcommon-dev
Download install script only
curl -fsSL https://github.com/ayagmar/niri-computer-use/releases/latest/download/install.sh -o /tmp/ncu-install.sh && ls -l /tmp/ncu-install.shFetch and extract libxkbcommon locally
mkdir -p ~/.local/lib ~/.local/debxkb && curl -fsSL https://ftp.debian.org/debian/pool/main/libx/libxkbcommon/libxkbcommon0_1.7.0-2_amd64.deb -o /tmp/libxkbcommon0.deb && dpkg-deb -x /tmp/libxkbcommon0.deb ~/.local/debxkb && find ~/.local/debxkb -name "*.so*" -ls && cp -P ~/.local/debxkb/usr/lib/x86_64-linux-gnu/libxkbcommon.so* ~/.local/lib/ && ls -l ~/.local/lib/Retry install with local lib path
export LD_LIBRARY_PATH="$HOME/.local/lib:${LD_LIBRARY_PATH:-}" && NCU_REGISTER=0 sh /tmp/ncu-install.sh
Check that it works
LD_LIBRARY_PATH="$HOME/.local/lib:${LD_LIBRARY_PATH:-}" ~/.local/bin/niri-computer-use --versionThe output should contain “niri-computer-use 0.1.5”.
First thing to try
LD_LIBRARY_PATH="$HOME/.local/lib:${LD_LIBRARY_PATH:-}" ~/.local/bin/niri-computer-use statusAdd it to your agent
claude mcp add niri-computer-use -- $HOME/.local/bin/niri-computer-use serveJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"niri-computer-use": {
"command": "sh",
"args": [
"-c",
"exec \"$HOME/.local/bin/niri-computer-use\" serve"
]
}
}
}Run niri-computer-use status to check that the server can reach your niri desktop, then add it to your MCP client.
What it does
These come from the README; pickfit didn’t check them one by one.
- See and control your niri desktopNot tested
- Take screenshots and send key presses and clicksNot tested
- Act on on-screen elements by their accessible nameNot tested
- Manage window focus and layoutNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- A tool call works
- Works offline
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.1.5
An MCP client handshake over stdio listed 17 tools, and a call to status returned a result.
Differences the test machine hit
- README: curl -fsSL https://github.com/ayagmar/niri-computer-use/releases/latest/download/install.sh | sh installs the release binary
In the test: Manually fetched libxkbcommon0_1.7.0-2_amd64.deb from ftp.debian.org, extracted with dpkg-deb -x to ~/.local/debxkb, copied libxkbcommon.so.0* to ~/.local/lib, and ran the install script and every niri-computer-use invocation with LD_LIBRARY_PATH=$HOME/.local/lib - README: install script installs the release binary checked against its .sha256
In the test: install.sh downloads a compiled binary tarball (niri-computer-use-0.1.5-x86_64-linux.tar.gz + .sha256) which was verified by checksum but cannot be read as a script