---
title: "Deep links · Finch Agent"
description: "Jump straight into a conversation, session, or Space with finch:// links"
source: https://finchwork.app/en/docs/deeplinks
---

# Deep links

Finch supports a special link format starting with `finch://`. Clicking one jumps directly to the corresponding spot or action in Finch — like opening a new conversation or a past session — without you having to find it manually.

Unlike a regular URL, a `finch://` link opens the Finch app directly and performs the action, rather than opening in a browser.

## Common deep links

| What it does | Format | Example |
| --- | --- | --- |
| Open a new conversation | `finch://new` | [Open a new conversation](finch://new) |
| New conversation with a message pre-filled | `finch://chat?message=your message` | \[Summarize my to-dos for today\](finch://chat?message=Summarize my to-dos for today) |
| Open a past session | `finch://open?id=sessionId` | Get it via a session's right-click "Copy link" |
| Jump to a Space | `finch://open?target=space&id=spaceId` | Get it from the Space list |

The most common one is `finch://chat?message=...` — it works like a "one-click ask" button: anyone (including you) can click it to send a preset message to Finch, without typing anything.

## How to use it

### 1\. Just click it

If you see a blue `finch://` link in a Finch conversation or a document, just click it — Finch jumps to the right place automatically.

### 2\. Write your own

Format it as a Markdown link and you get a clickable deep link:

```markdown
[Show me today's schedule](finch://chat?message=Show me today's schedule)
```

Use this to pre-bake a question or action into a link that fires the moment it's opened — great for manuals, quick-access shortcuts, or FAQ collections.

### 3\. Copy a link from the session menu

To share or bookmark a specific conversation, find it in the sidebar, right-click (or open the "more" menu), and choose "Copy link." You get a `finch://open?id=...` link — send it to someone or save it, and opening it jumps straight back to that conversation.

## A few to try right now

-   [Open a new conversation](finch://new)
-   \[Help me organize today's tasks\](finch://chat?message=Help me organize today's tasks)
-   \[Tell me a joke\](finch://chat?message=Tell me a joke)
-   \[Design a custom theme for me\](finch://chat?message=Design a custom theme for me)

## Tips

-   If the message you want to pre-fill has spaces, replace them with `%20` when writing the link; non-ASCII characters need no special handling.
-   Deep links only work inside the Finch app. Opening them elsewhere (e.g. in a browser or chat app) may not do anything unless Finch is installed on that machine.