Commands and Actions

Commands & System Actions

Look provides two layers of command execution:

1. Inline Quick Actions (:command syntax) for instant system controls.
2. Command Mode (Cmd+/ or :cmdid) for interactive built-in utility applications.

---

1. Inline Quick System Commands

Type a colon : followed by the command name to trigger instantaneous actions without opening menus:

• :sleep: Puts displays and the operating system into sleep mode immediately.
• :lock: Instantly locks the user session screen.
• :mute: Toggles system audio output between muted and unmuted states.
• :theme: Cycles system appearance dynamically between Dark and Light mode.
• :caff: Toggles macOS caffeinate background sleep prevention.

---

2. Command Mode (Cmd+/)

Press Cmd+/ to enter the full-screen Command Mode catalog. You can also trigger a specific tool directly by typing its mnemonic (e.g. :pomo, :calc 2+2, :kill 3000).

Built-in Applications

🍅 Pomodoro Focus Timer (:pomo)

• Focus Engine: Configurable intervals (e.g. 25m focus, 5m break) with interactive audio alerts.
• Timer Styles: Switch between Modern Ring, Vintage Dial, and Minimalist Text dials.
• Ambient Sound: Point to any local folder of audio tracks for background focus music.
• Menu Bar Indicator: Mini-timer persists in the macOS status menu bar during sessions.

✅ Daily Tasks (:todo)

• Daily Kanban: Structured daily agenda grouping (3 daily focal tasks, overdue badges, completed tasks).
• Fuzzy Filtering: Search your task history dynamically across descriptions and target dates.
• Productivity Stats: Completion streaks, monthly heatmaps, and weekly velocity charts.
• Undo History: 50-step in-memory undo/redo via Cmd+Z / Cmd+Shift+Z.

⚡ Speed Test (:speed)

• Live Visual Dial: Real-time download/upload dials measuring from 1 Mbps to 1 Gbps with latency jitter tracking.
• Network Inspection: Displays internal LAN IPv4, external WAN IP (click-to-copy or click-to-mask), and ISP identification.
• Engine: Benchmarked against Cloudflare CDN edge nodes without external binary dependencies (core/netspeed).

🧮 Calculator & Converter (:calc, or just type an expression)

Backed by core/calc and the macOS QuickMathService:

• Math: 2+2, sqrt(16), 200*15%, 2^8, 5!, constants pi / e. A pinned Calculator row appears; Enter copies the value.
• Unit conversion: <amount> <unit> (to|in|->|=) <unit>. Includes digital units (b, KB, MB, GB, TB, PB).
• Currency conversion: same pattern with currency codes.
• Timestamps: timestamp / timestamp now, or timestamp <epoch>, converts to a readable date.

Exact unit and currency coverage lives in QuickMathService.swift; check it for the full list.

🛑 Process & Port Killer (:kill / ps")

• Kill by Name: Fuzzy search across running processes and terminate with confirmation.
• Kill by Port: Target stuck local web servers (e.g. :kill 3000 or ps"8080) to immediately release locked network sockets.

🐚 Shell Executor (:shell)

• Execute ad-hoc terminal snippets directly from the launcher.
• Safety Cue: Displays an orange visual warning when input contains sudo or privileged commands.