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.
- Click Bots in the strip beside the sidebar.
- 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.
- 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.
- 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.
- Enter a Name and a one-line Role, such as Code reviewer.
- Under Model, choose the provider and model the bot runs on.
- Under Available, choose where the bot can be used: Everywhere, or only in the current workspace.
- Write its Instructions: what it should do and how it should answer.
- Click Reroll until you like its face, or pick a shape, colour and eyes from the menus beside it.
- 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.
- Open Bots home.
- 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.
- The bot editor opens prefilled. Choose the model and adjust anything you like.
- 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.
- In the Bots sidebar, click the bot. Or choose Message on its card in Bots home.
- Type your message and press Enter.
- To see what the bot did, choose View work under its reply.
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.
- In the Bots sidebar, hover the bot and click its info button. Or right-click the bot and choose Bot info.
- Use Message, Edit or Delete at the top of the panel to act on the bot.
- 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.
- 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.
- Make your changes.
- 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.
- To see one bot's threads, click the arrow beside it in the Bots sidebar, or right-click it and choose Show work threads.
- To show or hide all bots' work threads, click the eye button beside Groups in the Bots sidebar or in a chat's header.
- 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.
- Open the workspace, then open Settings → Bots.
- 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.
- Right-click the bot in the Bots sidebar and choose Delete bot…, or choose Delete in its info panel.
- 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.