> ## Documentation Index
> Fetch the complete documentation index at: https://help.flickwise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Hand off what you point at to Claude Code, Codex, Cursor, ChatGPT, and other agents you already use.

Some jobs are bigger than a quick answer: fix a bug, research a topic, draft a whole document. For those, Flickwise can hand off to an AI agent you already use. Flickwise gathers what you pointed at and what you asked for, and the agent does the work.

Hand off doesn't use any of your actions. The brief is written on your computer and goes straight to your agent, never through Flickwise.

## Hand off from the Ask box

**1. Open Ask**

Open the ring on what you want help with and press <kbd>Space</kbd>.

**2. Say what you want**

Type or speak your instruction, like "fix this error" or "find three sources for this claim".

**3. Send it**

Click **Send to Claude Code** (or whichever agent is your default), or press <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>↩</kbd>. To pick another agent, click the arrow next to it.

The agent opens with a short brief: your instruction, the text you pointed at, and the app it came from. Home lists it as a **Hand off** action so you can find it later.

## How each agent opens

| Agent | How it opens | Screenshot |
| - | - | - |
| **Claude**, **Perplexity**, **Cursor**, **Codex**, **Zed** apps | The app opens with the brief filled in. Press <kbd>↩</kbd> to send it. | Not included |
| **ChatGPT** app | The app opens and the brief is on your clipboard. Paste it with <kbd>⌘</kbd> <kbd>V</kbd>. | Not included |
| **Claude Code**, **Codex**, **Cursor Agent**, **GitHub Copilot CLI**, **Gemini** | In your terminal, in your home folder, and it starts right away | Saved to a file the agent can open |

Flickwise uses the app on your computer. When an agent has both a command-line tool and an app, it uses the command line. Only when ChatGPT, Claude, or Perplexity isn't installed does it open the website instead. The brief is always copied to your clipboard too, in case an app doesn't fill it in.

## Settings

Go to **Settings → Agents** to see which agents Flickwise found on your computer.

* **Make default** picks the agent the Ask box sends to.
* **Test** opens the agent with a short sample brief, so you can check it works.

Don't see your agent? Click **Request an integration** at the end of the list and tell us which one.

## Let agents ask Flickwise (local MCP)

Hand off sends a brief to your agent. Local MCP works the other way: while your agent works, it can ask Flickwise for context. Say "fix this" in Claude Code, and it can look up what you just pointed at.

Turn on **Connect local MCP** at the top of **Settings → Agents**, then click **Connect** on Claude Code, Codex, Cursor, Claude, or Gemini in the list below it. For any other app that supports MCP, click **Copy setup** and paste it into that app's MCP settings. Flickwise needs to be running for agents to reach it.

Your agents can ask for:

| What | What they get |
| - | - |
| **Recent context** | What you last pointed at: the app, the text, the page, and the screenshot if that app allows screenshots |
| **Needs you** | Rings you dismissed in the last 30 minutes |
| **Recent actions** | Your latest actions and the start of each result |
| **Notes** | Lines that match a search in your notes folder |
| **About you** | What you wrote in **Settings → Memory → About you**, and [your preferences](https://help.flickwise.app/settings/memory.md#your-preferences): favorite actions and styles, and where things go |

The agent asks the Flickwise app on your computer directly, never our servers. What it reads then goes to the agent's own AI, like any context you give it. Apps you've set to **Never** are left out, and every answer shows up in **What was sent** with the agent's name. Turn off **Connect local MCP** to stop it.

> [!NOTE]
>
> Your agent follows its own privacy terms. Flickwise doesn't see what the agent does with the brief.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.