Night Market Skill — ported from claude-night-market/phantom. For the full experience with agents, hooks, and commands, install the Claude Code plugin.

Computer Control Skill

Use Claude's Computer Use API to see and control desktop environments through screenshots and mouse/keyboard actions.

When To Use

• Automating GUI-based workflows that lack CLI alternatives
• Testing web applications through visual interaction
• Filling forms, navigating menus, or interacting with desktop apps
• Building automation pipelines that need visual verification

When NOT To Use

• Tasks achievable through CLI or API (no GUI needed)
• Browser automation better served by Playwright or CDP

Architecture

The computer use system has three layers:

1. Display Toolkit (phantom.display) - executes OS-level actions via xdotool/scrot on the real or virtual display
2. Agent Loop (phantom.loop) - manages the conversation cycle between Claude API and the display toolkit
3. CLI (phantom.cli) - command-line interface for running tasks or checking environment readiness

User Task
    |
    v
Agent Loop  <---->  Claude API (beta)
    |                   |
    v                   v
Display Toolkit    tool_use responses
    |              (click, type, screenshot)
    v
OS Commands (xdotool, scrot)
    |
    v
Display (X11 / Xvfb / WSLg)

Quick Start

Check environment

cd plugins/phantom
uv run python -m phantom.cli --check

Run a task

export ANTHROPIC_API_KEY="sk-ant-..."
uv run python -m phantom.cli "Open Firefox and search for Claude AI"

Use in Python

from phantom.display import DisplayConfig, DisplayToolkit
from phantom.loop import LoopConfig, run_loop

result = run_loop(
    task="Take a screenshot of the desktop",
    api_key="sk-ant-...",
    loop_config=LoopConfig(
        model="claude-sonnet-4-6",
        max_iterations=10,
    ),
    display_config=DisplayConfig(width=1920, height=1080),
)

print(f"Done in {result.iterations} iterations")
print(result.final_text)

API Versions

The resolve_tool_version() function handles this mapping automatically based on the model name.

Available Actions

All versions:

• screenshot - capture display
• left_click - click at [x, y]
• type - type text string
• key - press key combo (e.g., ctrl+s)
• mouse_move - move cursor

Enhanced (20250124+):

• scroll - scroll with direction and amount
• left_click_drag - drag between coordinates
• right_click, middle_click, double_click, triple_click
• hold_key - hold key for duration
• wait - pause between actions