Skip to content
Start here

POPULAR GUIDES

    FROM THE DOCUMENTATION

    Open this guide ↗
    ↑ ↓ select ↵ open esc closeV3Code Docs
    Nock · Connectionsnock

    Interactive app cards

    ↗ View as Markdown

    Use an app's own interactive card in Nock, control whether it can appear, and understand its boundaries.

    Some apps you sign in to directly can return an interactive card for a tool result. The card appears in the chat under the app’s name, so you can work with that result without leaving Nock. It is supplied by that app; it is different from a widget you ask Nock to build for your Mac.

    When Nock uses a supported app tool, its interactive card appears with the result. Read or navigate the card as needed. If the card opens a link, it opens in your browser after you choose the link. A card can ask Nock to use one of that app’s tools; actions that change something ask for your approval first.

    An app card is limited to its own app’s tools and the addresses that app declares. It cannot access your local files, settings, other apps, or other chats. It cannot embed other web pages inside itself. If it cannot load, the result may appear as a regular text or media card instead.

    Open Settings → Apps → Official → App widgets. For each directly connected app that supplies cards, Allow app widgets is on by default. Turn it off to stop that app’s interactive cards from appearing and to end an existing card’s connection to the app. Its result can still appear as an ordinary card; pictures and files use the media card.

    App cards exist while the app is running. When you reopen a saved chat, the original result appears as a media card rather than a live interactive app screen.

    App cards and Nock-made widgets are different

    Section titled “App cards and Nock-made widgets are different”

    An app card comes from a connected app. A Nock-made widget is a small app built for your Mac from a description. Find and edit those under Settings → Apps → My Apps → Widgets. See Build a widget and Connect apps.