harivansh-afk/deskctl
1
1
Fork 0
mirror of https://github.com/harivansh-afk/deskctl.git synced 2026-04-15 10:05:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
deskctl/README.md
Harivansh Rathi d0220100ad merge main into rename, resolve conflicts in favor of deskctl rename 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 08:43:26 -04:00

1.8 KiB
Raw Permalink Blame History

deskctl

npm release runtime skill

Non-interactive desktop control for AI agents on Linux X11.

Install

npm install -g deskctl
deskctl doctor
deskctl snapshot --annotate

One-shot execution also works:

npx deskctl --help

deskctl installs the command by downloading the matching GitHub Release asset for the supported runtime target.

Installable skill

npx skills add harivansh-afk/deskctl -s deskctl

The installable skill lives in skills/deskctl and is built around the same observe -> wait -> act -> verify loop as the CLI.

Quick example

deskctl doctor
deskctl snapshot --annotate
deskctl wait window --selector 'title=Firefox' --timeout 10
deskctl focus 'title=Firefox'
deskctl type "hello world"

Docs

Other install paths

Nix:

nix run github:harivansh-afk/deskctl -- --help
nix profile install github:harivansh-afk/deskctl

Source build:

cargo build

Support boundary

deskctl currently supports Linux X11. Use --json for stable machine parsing, use window_id for programmatic targeting inside a live session, and use deskctl doctor first when the runtime looks broken.