mcpField
D
deskctl

deskctl

github.com/harivansh-afkエージェントワークフロー1762 回インストール1 週間前に更新
リポジトリ

deskctl について

deskctl は Linux X11 のエージェント向け非対話型デスクトップ操作 CLI です。観察、待機、操作、検証の手順を使い、プログラムで扱える安定した JSON 出力を提供します。

主な機能

  1. 01Linux X11 デスクトップの操作
  2. 02画面スナップショットの取得と注釈
  3. 03ウィンドウ条件の待機
  4. 04タイトル、クラス、IDによるウィンドウ選択
  5. 05コマンドの安定した JSON 出力

活用シーン

  1. 01エージェントのデスクトップ操作の自動化
  2. 02操作前に指定ウィンドウを待機
  3. 03コマンド結果のプログラム処理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/harivansh-afk/deskctl --skill deskctl

インストール後、Claude Code で/deskctlを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
commands.md
runtime-contract.md
workflows/
observe-act.sh
poll-condition.sh

詳細

deskctl

Linux X11 エージェント向けの非対話型デスクトップ制御 CLI です。

すべての出力は、references/runtime-contract.md で定義されているランタイム契約に従います。--json を指定すると、すべてのコマンドは安定した JSON エンベロープを返します。出力をプログラムで解析する必要がある場合は、--json を使用してください。

クイックスタート

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

deskctl を npm からインストールした場合は、後から次のコマンドで更新できます。

deskctl upgrade --yes

エージェントのループ

デスクトップでの操作はすべて、観察 -> 待機 -> 操作 -> 検証の手順に従います。

deskctl snapshot --annotate        # observe
deskctl wait window --selector 'title=Chromium' --timeout 10  # wait
deskctl click 'title=Chromium'      # act
deskctl snapshot                   # verify

再利用可能なスクリプトについては、workflows/observe-act.sh を参照してください。ポーリングループについては、workflows/poll-condition.sh を参照してください。

セレクター

ref=w1          # snapshot ref (short-lived)
id=win1         # stable window ID (session-scoped)
title=Chromium   # match by title
class=chromium   # match by WM class
focused         # currently focused window

chromium のような単独の文字列はあいまい一致で検索しますが、候補が複数ある場合は失敗します。明示的なセレクターを使用してください。

リファレンス

ワークフロー

コメント

Markdown 対応