Agent Canvas Setup

Agent Canvas Setup

Checks and installs dependencies for the agent-canvas visual editing skills (agent-eyes, agent-canvas, canvas-edit).

Quick Check

Run this first to see what's needed:

uv run .claude/skills/agent-canvas-setup/scripts/check_setup.py check

If all checks pass → Ready to use canvas skills.
If checks fail → Ask user about installation scope.

Installation Scopes

ALWAYS ask the user which scope they prefer before installing:

Recommended Prompt to User

Agent Canvas needs some dependencies. How would you like to install them?

1. **temporary** (recommended) - Minimal footprint. Browsers installed to system cache, 
   Python packages managed on-demand by uv. Nothing added to your project.

2. **local** - Creates a .venv in this project with playwright. Good if you want 
   all dependencies tracked with the project.

3. **global** - Same as temporary. Browsers go to system cache.

Which do you prefer? (1/2/3 or temporary/local/global)

Install Commands

SKILL_DIR=".claude/skills/agent-canvas-setup/scripts"

# Temporary (recommended) - uv handles Python deps on-demand
uv run $SKILL_DIR/check_setup.py install --scope temporary

# Local - creates .venv in project
uv run $SKILL_DIR/check_setup.py install --scope local

# Global - browsers only (Python via uv)
uv run $SKILL_DIR/check_setup.py install --scope global

What Gets Installed

Always Required

• uv - Must be pre-installed by user (provides instructions if missing)
• Python 3.10+ - Must be pre-installed

Installed by Setup

• Playwright Chromium (~200MB) - Browser binary for automation
  • Location: ~/.cache/ms-playwright/ (Mac/Linux)
  • This is the main "weight" of the installation

Python Packages (handled by uv)

• playwright - Browser automation
• axe-playwright-python - Accessibility scanning

For temporary and global scopes, these are cached in ~/.cache/uv/ and loaded on-demand when running scripts.

For local scope, these are installed to .venv/ in the project.

Error Recovery

If canvas skills fail, run check first:

uv run .claude/skills/agent-canvas-setup/scripts/check_setup.py check --json

Common issues:

• Playwright Chromium: not found → Run install with any scope
• uv package manager: not found → User must install uv first
• Python 3.10+: need 3.10+ → User must upgrade Python

Workflow Integration

Before running any canvas skill for the first time:

1. Run check_setup.py check
2. If not ready, ask user about preferred scope
3. Run check_setup.py install --scope <choice>
4. Verify with check_setup.py check again
5. Proceed to canvas skill