Skip to content
V3CodeV3Code
Start here

POPULAR GUIDES

    FROM THE DOCUMENTATION

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

    Create a named agent

    ↗ View as Markdown

    Make a local Nock agent with its own name, instructions, voice, and conversation.

    A named agent gives a recurring kind of work a distinct identity in Nock. It can have its own instructions and voice, while using only the tools, app connections, and access allowed on this computer. A name or instruction cannot grant a new permission.

    Create one

    Section titled “Create one”
    1. Open the Agents panel and choose New agent.
    2. Choose an orb color and enter a Name.
    3. Describe its Character, Personality, What it can do, and Instructions. Prefer specific behavior you can check, such as “ask which audience I mean if it is unclear.”
    4. Choose Agent or Bot under Mode.
    5. Choose a Voice and decide whether to keep Notifications on.
    6. Choose Save agent.

    Select its orb and confirm its name is showing in the notch before speaking. For example: “Summarize this report in three bullets and keep all the figures.”

    Agent and Bot modes

    Section titled “Agent and Bot modes”

    Agent is a named assistant you can select for a turn. Bot emphasizes a persistent character, shorter turns, progress updates, and handing longer work to a worker. A local Bot is not a cloud computer and does not create a scheduled routine. See Routines and Cloud bots for those separate features.

    Edit its instructions

    Section titled “Edit its instructions”

    Open the agent’s orb and choose Edit agent. Update its fields and save. Open SOUL.md opens the agent’s instruction file for direct editing; Nock preserves text outside the portion it manages. If Save asks you to finish or stop active turns, do that first, then reopen the editor.

    Keep instructions short and non-conflicting. Put credentials in the intended connection controls, not in an agent’s character or instructions. Instructions travel with the agent’s messages and are not a secure vault.

    Conversations, tools, and removal

    Section titled “Conversations, tools, and removal”

    Each named agent has its own local workspace and memory. Its available tools follow the same app connections and Nock access settings. When the agent is selected, the notch shows it as the recipient; Back to Nock or selecting Nock returns the main voice target.

    Choose Remove agent and confirm the second press to disable it. Removing an agent does not erase its workspace. Check Chats and Privacy for history and data controls.