Skip to content

AUTOMATION.md

Latest commit

 

History

History
147 lines (120 loc) · 4.1 KB

AUTOMATION.md

File metadata and controls

147 lines (120 loc) · 4.1 KB
  • Left side: Claude Code terminal (this session)
  • Right side: Termide application window

Coordinates Reference (based on screen resolution ~2880x1800)

Termide UI Elements

Element Coordinates Description
Explorer (1836, 239) File explorer panel on the left
Source Control (1836, 456) Git status and changes panel
Git Graph (1836, 677) Git commit history visualization
Viewer/File Editor (2554, 249) Main file viewing/editing area
Agent Panel Input (2537, 623) AI Agent chat input box

Safety Zones

  • Screen center X: 1717
  • Left terminal (Claude Code): x < 1717 - AVOID clicking here
  • Termide area: x > 1717

Important: Double Click Safety Protocol

When interacting with Termide from another terminal, you need TWO SEPARATE double-clicks:

Step 1: Focus the Terminal window (2 clicks)

peekaboo click --coords 2537,623 && sleep 0.3 && peekaboo click --coords 2537,623

Step 2: Focus the Agent Panel input (2 more clicks)

peekaboo click --coords 2537,623 && sleep 0.3 && peekaboo click --coords 2537,623

Full sequence for sending a message:

# First double-click: focus terminal (use 1 second sleeps!)
peekaboo click --coords 2537,623 && sleep 1 && peekaboo click --coords 2537,623 && sleep 1 && \
# Second double-click: focus agent input
peekaboo click --coords 2537,623 && sleep 1 && peekaboo click --coords 2537,623 && sleep 1 && \
# Type and send
peekaboo type "message" && sleep 0.5 && peekaboo press return

IMPORTANT: Use sleep 1 between clicks, NOT sleep 0.3. Shorter sleeps often fail to register clicks properly.

Why 4 clicks total?

  1. First 2 clicks: Ensures Terminal.app window is focused
  2. Second 2 clicks: Ensures the Agent Panel input box receives focus

Starting Termide

cd ~/Projects/termide && bun run dev

How to Verify Termide is Running

IMPORTANT: Don't confuse seeing "termide" in the terminal prompt (just the directory name) with Termide actually running!

Termide NOT running = Black terminal with just a bash prompt Termide IS running = Full UI with multiple panels:

  • Explorer panel (left)
  • Source Control panel (left)
  • Git Graph panel (left)
  • File Viewer (top right)
  • Terminal/Agent Panel (bottom right)
  • Status bar at bottom

Always take a screenshot and visually verify the UI panels are visible before proceeding.

How to Verify Which Panel Has Focus

Each panel has a border that indicates focus state:

  • Cyan border = Panel HAS focus (active, receives keyboard input)
  • Gray border = Panel does NOT have focus

When testing click interactions, always verify the target panel's border changed to cyan after clicking.

Stopping Termide

IMPORTANT: Press Ctrl+C TWICE to properly close Termide:

peekaboo hotkey "ctrl,c" && sleep 0.5 && peekaboo hotkey "ctrl,c"

Opening Agent Panel

After Termide is running:

peekaboo hotkey "ctrl,space"

Selecting Claude (Antigravity)

  1. Press Down arrow to navigate to "Claude (Antigravity)"
  2. Press Enter to select
  3. Select model from list
  4. Press Enter to connect
peekaboo press down && sleep 0.2 && peekaboo press return
# Wait for model selector
sleep 1
peekaboo press return  # Select first model

Sending a test message

After connecting to agent:

# Two clicks to focus Agent Panel
peekaboo click --coords 1950,550 && sleep 0.3 && peekaboo click --coords 1950,550
# Type message
peekaboo type "Your message here"
# Send
peekaboo press return

Taking Screenshots

peekaboo image --mode screen --path /tmp/screenshot.png

Peekaboo Commands Reference

Click

peekaboo click --coords x,y
peekaboo click --coords x,y --double  # Double click

Type

peekaboo type "text to type"

Key Press

peekaboo press return
peekaboo press down
peekaboo press up
peekaboo press escape

Hotkey Combinations

peekaboo hotkey "ctrl,c"
peekaboo hotkey "ctrl,space"
peekaboo hotkey "cmd,c"

Screenshot

peekaboo image --mode screen --path /tmp/filename.png