Skip to content
V3CodeV3Code
Start here

POPULAR GUIDES

    FROM THE DOCUMENTATION

    Open this guide ↗
    ↑ ↓ select ↵ open esc closeV3Code Docs
    Nock · Build and createnock

    Build a widget for Nock

    ↗ View as Markdown

    Create a small local tool in Nock's notch, try it, and decide whether to keep it.

    The widget builder makes a small app that opens in Nock’s notch and appears in Studio. It is not a full-screen project and is not the same as an outside-agent MCP connection. Open it from Studio → Tell Nock what to build or Settings → Apps → My Apps → Make a widget.

    Build and try a widget

    Section titled “Build and try a widget”
    1. Describe one useful thing you want the widget to show or do. Start with a simple, read-only task.
    2. Answer any clarification questions or choose Skip — make it as written.
    3. Let Nock build and check a draft. A completed layout does not prove every action works.
    4. Use Ask your widget… to try its available actions.
    5. Review What it needs, Advanced → Actions and approvals, and any service setup before using live data.
    6. Ask for a focused change and test again.
    7. Choose Keep widget when you want it in Studio, or Throw away to discard the draft.

    If you close the builder while it is working, the build continues. Find its Building tile in Studio and reopen it instead of starting a duplicate.

    Understand its access

    Section titled “Understand its access”

    A widget runs on this computer and may contact the services its actions use. Review the actions and when they ask before using it with sensitive information. Keep credentials in the designated configuration controls, not in the build description. Try it with non-sensitive data first and check its result in the original service.

    The builder can also connect an MCP server for a widget. This gives the widget access to that server’s tools; it does not create a Team outside-agent connection. Review the server’s setup, tools, and permissions before connecting it. See MCP connections in Nock.

    Keep or manage it

    Section titled “Keep or manage it”

    Kept widgets appear under Made by you in Studio and in Settings → Apps → My Apps. Open a kept widget to edit it. The builder may draw an icon for the Studio tile; you can select it to change the icon without rebuilding the widget.

    Widgets are local to the computer where you create them. Keeping one does not publish it or share its settings and connections with another computer. See Studio, App connections, and Privacy.