# AI use cases for Big Arrow on the Screen (franzenzenhofer/big-arrow-on-the-screen)

Repo: [franzenzenhofer/big-arrow-on-the-screen](https://github.com/franzenzenhofer/big-arrow-on-the-screen) | Use cases: 4 | Page: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/

big-arrow-on-the-screen (bigarrow) is a macOS command-line tool and skill for Claude Code and Codex that draws arrows, boxes and text signs over any window without taking focus or capturing the screen.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Point a human at the Allow button an agent cannot press: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/point-human-at-permission-button/
- Walk someone through an app one control at a time: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/walk-someone-through-app-controls/
- Point at the right browser tab out of many: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/point-at-browser-tab-among-many/
- Show a code on a sign that the person can copy and paste: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/show-code-to-copy-on-sign/

## How to point a human at the Allow button an agent cannot press with Big Arrow on the Screen

Repo: [franzenzenhofer/big-arrow-on-the-screen](https://github.com/franzenzenhofer/big-arrow-on-the-screen) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README

An agent draws an arrow and sign at the permission button so the human clicks it.

**Who it is for:** A developer whose AI agent stops at a macOS permission prompt and needs the human to click Allow.

**The problem:** The agent can find the button but should not press it, so it prints 'please click Allow' into a terminal the human may not be watching.

**The outcome:** The arrow and sign appear over the correct button in System Settings, the human clicks it, and the arrow removes itself after its time limit.

### Steps

1. Install the tool with `brew install franzenzenhofer/tap/bigarrow`.
2. Teach your agents the skill with `bigarrow install-skill`.
3. Point at the button with `bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"`.
4. If the command exits with code 4, run `bigarrow doctor` and grant Accessibility to the app that started bigarrow (for example Terminal or Claude).
5. Check that the sign sits over the Allow button, then wait for the human to click it.

### Prompt to paste into your agent

```text
Use the bigarrow CLI from the repo franzenzenhofer/big-arrow-on-the-screen to point at the button labelled <button label> in the app <app name> with the sign text "<sign text>". Expected output: a JSON result from `bigarrow point ... --json` with an exit code of 0. Verify the exit code is 0, and if it is 4 run `bigarrow doctor` and report which app needs Accessibility.
```

### Caveat

The --element target needs Accessibility permission for the app that starts bigarrow, and drawing alone needs no macOS permission.

Dual-use notice: only use this on software, sites and systems you own or are authorized to test.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/point-human-at-permission-button/

## How to walk someone through an app one control at a time with Big Arrow on the Screen

Repo: [franzenzenhofer/big-arrow-on-the-screen](https://github.com/franzenzenhofer/big-arrow-on-the-screen) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Chain several arrows so a person learns each step of an app's interface.

**Who it is for:** A presenter or teacher preparing a Keynote how-to, or a helper showing someone the next control to press.

**The problem:** Written instructions are hard to follow on screen, and describing a control in words is slow when the person is not familiar with the app.

**The outcome:** Each control gets its own numbered arrow and sign in order, and each arrow removes itself after its time limit.

### Steps

1. Install the tool with `brew install franzenzenhofer/tap/bigarrow`.
2. Point at the first control with `bigarrow start --element Animate --app Keynote --role radiobutton --text "1. Click Animate" --from right --style ring --color purple`. (inferred, check the README)
3. Point at the second control with `bigarrow start --element "Add an Effect" --app Keynote --text "2. Add an Effect" --from right --style box --corners sharp --color "#FF9F0A" --shape straight`. (inferred, check the README)
4. Point at the third control with `bigarrow start --element Play --app Keynote --role button --text "3. Press play. Bask in the applause." --from top --color teal --shape zigzag --size S`. (inferred, check the README)
5. Clear any arrows still showing with `bigarrow stop --all`. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the bigarrow CLI from franzenzenhofer/big-arrow-on-the-screen to show three steps in <app name>, using the element labels <label 1>, <label 2> and <label 3> with the sign texts "1. <text 1>", "2. <text 2>" and "3. <text 3>". Expected output: three `bigarrow start` runs that each return at once. Verify each run exits with code 0 and that `bigarrow stop --all` clears the arrows afterwards.
```

### Caveat

The --element matching depends on the labels the app exposes, so run `bigarrow elements --app <app name>` first to confirm the labels.

Dual-use notice: only use this on software, sites and systems you own or are authorized to test.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/walk-someone-through-app-controls/

## How to point at the right browser tab out of many with Big Arrow on the Screen

Repo: [franzenzenhofer/big-arrow-on-the-screen](https://github.com/franzenzenhofer/big-arrow-on-the-screen) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README

Raise a Chrome window and point at one tab by its title.

**Who it is for:** A person with a crowded browser who must choose one specific tab, such as an agent handing back a page it opened.

**The problem:** Many open tabs look alike, and a pointer aimed at a window hidden behind the terminal is not helpful.

**The outcome:** bigarrow brings the Chrome window and the named tab to the front, then points at the tab with a sign.

### Steps

1. Install the tool with `brew install franzenzenhofer/tap/bigarrow`.
2. Run `bigarrow start --app "Google Chrome:Sourdough" --element "Sourdough - Wikipedia" --role radiobutton --text "It's this tab, not the other 13" --from top --shape zigzag --color "#5856D6" --size L`, replacing the tab title with yours. (inferred, check the README)
3. Confirm the tab is selected and the sign points at it.
4. Clear the arrow with `bigarrow stop --all` when the person has found the tab. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the bigarrow CLI from franzenzenhofer/big-arrow-on-the-screen to raise the Google Chrome tab titled "<tab title>" and point at it with the sign "<sign text>". Expected output: the tab is selected and the command exits with code 0. Verify the exit code and report the tab title that was selected.
```

### Caveat

Tab matching with --app App:title needs Accessibility permission, and it is used here with Google Chrome as in the README example.

Dual-use notice: only use this on software, sites and systems you own or are authorized to test.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/point-at-browser-tab-among-many/

## How to show a code on a sign that the person can copy and paste with Big Arrow on the Screen

Repo: [franzenzenhofer/big-arrow-on-the-screen](https://github.com/franzenzenhofer/big-arrow-on-the-screen) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README

Put a PIN or code on a sign with a copy button and point at the field to paste it into.

**Who it is for:** A person signing in on a website who needs a code from an agent or script, such as a PIN for a sign-in form.

**The problem:** Reading a code from one place and typing it into another invites typos, and the agent cannot type into the field for the person.

**The outcome:** The sign shows the code with a copy button, and the arrow points at the PIN field until the person pastes the code.

### Steps

1. Install the tool with `brew install franzenzenhofer/tap/bigarrow`.
2. Run `bigarrow start --element "PIN code" --role textfield --app "Google Chrome:Acme sign-in" --from right --color blue --border-color yellow --text-color yellow --text "Franz, copy & paste the PIN {{482913}} here"`, replacing the field, window and code with yours. (inferred, check the README)
3. Click the copy button on the sign and paste the code into the field.
4. Clear the arrow with `bigarrow stop --all` after the paste. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the bigarrow CLI from franzenzenhofer/big-arrow-on-the-screen to point at the text field <field label> in <app name>:<window title> and show the sign "<sign text with {{<code>}}>". Expected output: a sign with a copy button and an exit code of 0. Verify the exit code and do not repeat the code in any other output.
```

### Caveat

The copy button is only created when the code is written as {{value}} inside --text, and it is not a password manager or a secure store.

Risk, credentials: A PIN or code on the sign is visible to anyone who can see the screen, so show it only when the person is alone and clear it afterwards.

Dual-use notice: only use this on software, sites and systems you own or are authorized to test.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/franzenzenhofer-big-arrow-on-the-screen/show-code-to-copy-on-sign/