Bots

Bots

How to create a bot, message it, share it with your team, change it and delete it.

Open Bots home

A bot is a teammate you set up once, with its own name, role, instructions, model and memory. You find and manage bots in Bots mode.

  1. Click Bots in the strip beside the sidebar.
  2. Bots home opens in the centre, with a card for Nora and each of your bots, your group chats, and templates. The sidebar now lists your bots instead of threads.
  3. To come back to Bots home later, click the home button at the top of the sidebar (Bots home). Click Threads in the strip to return to your threads.

Create a bot

Create a bot when you keep giving an agent the same kind of job, such as reviewing code or editing drafts.

  1. In Bots mode, choose New bot at the top of the sidebar. On Bots home, choose New bot, or Create a bot if you don't have any yet.
  2. Enter a Name and a one-line Role, such as Code reviewer.
  3. Under Model, choose the provider and model the bot runs on.
  4. Under Available, choose where the bot can be used: Everywhere, or only in the current workspace.
  5. Write its Instructions: what it should do and how it should answer.
  6. Click Reroll until you like its face, or pick a shape, colour and eyes from the menus beside it.
  7. Choose Create bot.

Or ask Nora

Nora, the built-in bot listed first, can create bots for you. Click Nora in the Bots sidebar to start a thread, and ask for the bot you want, for example “make me a code reviewer bot”.

Start from a template

Templates fill in the name, role, instructions and face for common jobs, such as Code reviewer, Release manager, Researcher, Writing editor, Test engineer, Meeting summariser and Planner.

  1. Open Bots home.
  2. Under Suggested for your role, click a template. Templates for other kinds of work are under More templates. If you have no bots yet, they are under Start from a template.
  3. The bot editor opens prefilled. Choose the model and adjust anything you like.
  4. Choose Create bot.

Message a bot

Each bot has one ongoing chat with you. Work you ask for runs in the bot's own work threads, and each reply links to it.

  1. In the Bots sidebar, click the bot. Or choose Message on its card in Bots home.
  2. Type your message and press Enter.
  3. To see what the bot did, choose View work under its reply.

Share a bot with your team

A shared bot is saved as a file in the workspace's .nora/bots folder, so anyone who uses the repository gets it too.

  1. Open the workspace the bot should belong to.
  2. Create or edit the bot.
  3. Under Available, choose Only in this workspace, shared with the repository. The editor shows the file it will write.
  4. Save the bot, then commit the new file in .nora/bots like any other change.

Private to one workspace

Choose Only in this workspace, private to you to keep a bot to one project without writing anything to the repository.

See a bot's details

The info panel shows a bot's model, where it is available, its instructions, its memory, its recent work and the groups it is in.

  1. In the Bots sidebar, hover the bot and click its info button. Or right-click the bot and choose Bot info.
  2. Use Message, Edit or Delete at the top of the panel to act on the bot.
  3. Click a thread under Recent work or Groups to open it.

Change a bot

Edit a bot to change its name, role, model, instructions, face or where it is available.

  1. Right-click the bot in the Bots sidebar and choose Edit bot…. You can also choose Edit in its info panel or the pencil on its card in Bots home.
  2. Make your changes.
  3. Choose Save bot.

Running threads keep their instructions

Changes apply to new threads with the bot. Threads that have already started keep the instructions they started with.

Show or hide a bot's work threads

Bots do the work behind each reply in their own threads. You can list these in the sidebar or hide them to keep only your chats. Hidden threads still appear when they need your approval or answer.

  1. To see one bot's threads, click the arrow beside it in the Bots sidebar, or right-click it and choose Show work threads.
  2. To show or hide all bots' work threads, click the eye button beside Groups in the Bots sidebar or in a chat's header.
  3. In Threads mode, open Thread view options and set Bot work to Show work threads or Hide work threads.

Hide a bot in one workspace

A bot available everywhere can be hidden from a workspace where you don't need it.

  1. Open the workspace, then open Settings → Bots.
  2. Under Your bots, click Shown here beside the bot. It changes to Hidden here.

Delete a bot

Deleting a bot removes it from the Bots sidebar. Its existing threads and group replies keep their history.

  1. Right-click the bot in the Bots sidebar and choose Delete bot…, or choose Delete in its info panel.
  2. Confirm with Delete and the bot's name.

Shared bots are deleted for everyone

Deleting a shared bot removes its file from .nora/bots, so collaborators lose the bot too once that change reaches them.

NextDownload NoraWhat’s newGet support