explaingit

stevibe/local-screen-agent

Analysis updated 2026-05-18

65SwiftAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A macOS app where an AI model looks at your screen and clicks things for you, using a separate tool to find exact click locations.

Mindmap

mindmap
  root((repo))
    What it does
      Screen capture
      AI tool calling
      Click automation
    Tech stack
      Swift
      SwiftUI
      Quartz events
    Use cases
      GUI agent prototyping
      Automation research
    Audience
      Developers
      AI researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Prototype an AI agent that can see and interact with a macOS screen.

USE CASE 2

Test tool-calling AI models against real GUI automation tasks.

USE CASE 3

Experiment with combining screenshot analysis and mouse automation locally.

What is it built with?

SwiftSwiftUImacOS

How does it compare?

stevibe/local-screen-agentiliyami/maccleannanako0129/tokenbar
Stars656464
LanguageSwiftSwiftSwift
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs a separately hosted LocateAnything server plus a tool-calling model endpoint, and macOS screen permissions.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Local Screen Agent is a macOS app that lets an AI model control your computer's screen by looking at it and clicking on things. It is built in Swift and made by a developer called stevibe, and it currently has 65 stars on GitHub. Here is how it works. The app takes a screenshot of your main display, then sends information about that screen to an AI model that can make tool calls, meaning the model can decide to run specific actions instead of just chatting. The model figures out what needs to happen next. A separate tool called LocateAnything looks at the screenshot and works out exactly where a specific item on the screen sits, giving back coordinates. The app then uses those coordinates to move the mouse and click in the right spot, using macOS's own system for sending click events. To run this project you need a Mac running macOS 13 or newer, the Swift 6.2 toolchain installed, access to an AI chat model that supports tool calling, and a separately hosted LocateAnything server. You also need to grant the app Screen Recording and Accessibility permissions in macOS settings, since it needs to see your screen and control mouse clicks. The project's own creator describes it as a proof of concept, meaning it is experimental and meant for local testing and research rather than real world production use. Right now it can only click the mouse, no other automation actions are supported, and it only captures your main display if you have more than one screen connected. It also has not been through Apple's notarization process, which is normally required before distributing macOS apps outside of local development. The code is organized into an app and interface layer, a core runtime layer that handles screenshots and click logic, and a script for building a local app bundle. It is released under the MIT license, a permissive license that allows free use, including commercial use.

Copy-paste prompts

Prompt 1
Help me set up Local Screen Agent on my Mac and connect it to a local model server.
Prompt 2
Explain how the locate_region and click_screen tools work together in this Swift project.
Prompt 3
Show me how to write a LocateAnything-compatible server that this agent can call.
Prompt 4
Walk me through building and signing the macOS app bundle using build_app_bundle.sh.

Frequently asked questions

What is local-screen-agent?

A macOS app where an AI model looks at your screen and clicks things for you, using a separate tool to find exact click locations.

What language is local-screen-agent written in?

Mainly Swift. The stack also includes Swift, SwiftUI, macOS.

What license does local-screen-agent use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is local-screen-agent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is local-screen-agent for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.