Tavina

Tools overview

πŸ“– This content is synced from the Tavina Handbook.
The canonical version always lives at https://tavina.ai/docs/friendly/tools/overview

Tools overview

Tavina tools are focused workspaces inside the app. They keep durable information in the right place instead of leaving everything buried in chat.

New accounts start with this toolbar, in order: Pins, Calendar, Weather, Notepad, Tasks, Shopping Lists, Clock Routines, Journal, and Links.

Contacts, Knowledge Library, and Automations are available too but hidden by default; you can enable them under Settings β†’ Appearance β†’ Toolbar. Discord Moderation, where your plan offers it, also stays off the default toolbar. In September 2026 the default toolbar arrangement was refreshed once for every existing account; anything you change afterwards is kept. Fleet Solutions is a connected tool for fleet operations teams β€” it appears only when a Tavina operator has enabled the DieselSS connection for your account (tavina/tavina#1994). Avatar Bridge is a private pilot tool β€” it appears only for the small group of accounts its operator has granted access to, and it lets a Tavina agent connect to its own in-world avatar on a private grid (tavina/tavina#1997). Each agent using it also gets adjustable avatar settings it can tune itself β€” such as how fast it chats in-world and which regions it may visit β€” while higher-risk options stay switched off and locked so only the account owner can change them (tavina/tavina#2020). The avatar also listens now: it hears nearby in-world chat and private messages, answers them on its own, keeps track of who it is talking with, and can receive or politely decline friendship and teleport invitations β€” the connection panel shows when this listening is active (tavina/tavina#2022). The bridge behind it occasionally renames its actions; older action names now translate automatically to their current equivalents, actions that no longer exist explain what to use instead, and the bridge panel shows this naming drift at a glance. Several additional safe abilities were switched on: the avatar can search nearby objects, look up people by name, and review recent in-world chat history; it can repair its own appearance glitches after crossing between regions (when wardrobe permissions allow); and it can fly to a specific point or stop moving on request (tavina/tavina#2026). You can also change any of these settings yourself, right in the bridge panel β€” each one now shows the right editor for its type (a toggle, a dropdown, a number, or a list) instead of a read-only value. Locks still protect you in one direction only: a locked or “user-only” setting stays frozen for your agent but is always editable by you, the account owner (tavina/tavina#2027). If the avatar ever gets stuck β€” ghosted after a rough region crossing, invisible after a teleport β€” recovery no longer needs an operator: the bridge panel has a confirmed “Relog avatar” action (with a visible cooldown while the grid enforces its wait), and your agent can relog on its own the same way; both show the new region and position once the avatar is back (tavina/tavina#2043). The bridge now also reports its own connection health: the panel shows live connection status β€” login, disconnect, reconnect attempts, region changes, and simulator health β€” as it happens, without you refreshing anything, and your agent is told right away when the connection drops or degrades; the bridge panel also lets you set how often routine health checks are sampled (tavina/tavina#2057). The bridge panel also has a Habit tab: a permanent, append-only Habit Ledger of real-world habit events. Your agent records events by name (for example “alcoholic drink”) the moment they happen and you can record or correct them yourself; points are set by a catalog only you can edit, completed tasks on your designated task board add positive entries automatically, every correction is a new counter-entry (nothing is ever edited or deleted), and when your balance crosses a threshold you set, a structured event is published for the environmental simulation to react to (tavina/tavina#2062). When the grid announces a planned restart, the bridge now handles it cooperatively: your agent saves a short note of what it was doing and who it was talking to, politely acknowledges the restart notice when it can, waits out the brief outage, and picks the conversation right back up where it left off once the grid returns β€” no lost context, no fresh-start reset (tavina/tavina#2154). The connection panel’s status cards β€” the IM-listening summary and the avatar status auto-report β€” now follow your selected light or dark theme and stay readable in both, and an optional β€œMatrix” color set restyles those two cards in classic green-on-black for a terminal look (tavina/tavina#2285). The avatar can also set its own home position in-world and return there on request β€” going home follows the same region-travel permissions you set for teleporting (tavina/tavina#2289). And when nearby chat that isn’t addressed to the avatar builds up unheard, it no longer sits invisibly: your agent is told how much held chat is waiting the next time it wakes, and the connection panel shows it too, so the backlog can be caught up with one look (tavina/tavina#2288). The avatar can now take part in in-world group conversations too: it can reply in group chat, see which chat sessions exist, join or leave them, and accept session invites β€” group replies follow the same chat-speed settings as its other conversations (tavina/tavina#2292). The avatar can also end its in-world presence deliberately: a clean sign-out with no automatic return β€” after it, the avatar stays signed out until the agent relogs it back in, so a lost connection can no longer leave it standing in-world unattended (tavina/tavina#2294). If you have paused the bridge with Disconnect, the panel no longer tells you the avatar is disconnected: the card says the integration is off and periodically checks the avatar’s real in-world session in the background without resuming anything, shows when it last checked and how long that session has been live, and if the grid cannot be reached it reports the session as unknown rather than logged out (tavina/tavina#2344). When the grid announces a planned restart, the avatar now gets the notice too: it is told ahead of time to finish what it is doing and sign out before the restart, then wait for the all-clear β€” or, if the all-clear is missed, the stated safe-return time β€” before coming back, so it is never dropped without warning (tavina/tavina#2319). The bridge panel also has a Population tab: a live table of every agent-operated avatar on the private grid β€” connection health, agent phase, region with instability shown first and loudest, simulator FPS, and AO profile at a glance β€” plus a per-resident detail view with confirmed management actions such as setting the AO profile, waking a paused avatar, relogging, and starting or stopping on-demand bridges (tavina/tavina#2379). People-finder now prefers looking people up by name over lookups by avatar ID, and the panel shows the finder’s overall health β€” ok or ok-limited β€” rather than treating an optional grid component as an outage (tavina/tavina#2410). The bridge panel also has a Grid Ops tab: a strictly read-only view of the whole grid’s health at a glance β€” overall state, who is online (human- or agent-operated), services and backup pipelines, struggling or down regions shown loudest, and an active-rollout banner while a grid deployment is in progress (tavina/tavina#2472). Desktop toolbars can show a compact text label under each icon so tools are easier to recognize at a glance β€” on by default, and switchable under Settings β†’ Appearance β†’ Toolbar (tavina/tavina#2156).

How tools work

A tool is a panel with its own purpose. You can open it from the toolbar, work directly in the PWA, and ask Tavina to help from chat.

For example, Tavina can help plan tasks in conversation, but the Tasks tool is where the task board lives. Tavina can discuss a document in chat, but the Knowledge Library is where uploaded Sources and Catalogs live.

Ask Tavina to open a tool panel

You can ask Tavina to open supported work panels for you. For example: “show me my tasks,” “open the notepad,” or “what’s the weather?” If the panel is available, Tavina opens it in the app and leaves two visible signs: a short toast and a chat line saying what opened. The panel should not change silently.

Tavina only opens registered work panels through this flow. Settings still uses its normal Settings and pinned-destination paths instead of a generic chat-open command.

If you are in focus mode, Tavina should not yank the layout open. It may suggest the panel with a toast and chat note, but focus mode stays put until you choose to leave it.

Tavina also keeps a short per-session panel history. Ask “take me back” to return to the previous panel, or use the small back chip shown at the top of a work panel when panel history is available. Toolbar clicks always win: if you choose a panel yourself, that choice overrides any agent suggestion and becomes the newest history entry.

You can also ask Tavina to close the panel β€” for example, “close the panel” or “back to full-screen chat.” Tavina closes it, confirms with a toast and a chat note, and clears the panel history so a later “take me back” will not reopen what you just closed. If no panel is open, Tavina says so plainly instead of pretending something was closed.

When to use each tool

Tool Use it for Start here
Pins Quick access to Settings destinations you use often. Pins tool
Weather Current conditions, hourly forecasts, multi-day outlooks, and weather-aware planning. Weather tool
Calendar Events, sub-calendars, schedule views, projections, and availability context. Calendar tool
Tasks Task boards, task cards, statuses, priorities, deadlines, and subtasks. Tasks tool
Contacts Managing people you know β€” contact details, per-channel consent, history timelines with Gmail activity, CSV, vCard, and Google Contacts imports, duplicate merge review, consent-gated email sending through Postmark or Gmail, self-running email sequences, WordPress website intake, and agent help with all of it. Contacts tool
Shopping Multiple named shopping lists with quantities, notes, and checked-off items. Shopping lists
Notepad Lightweight note collections, quick edits, and reminders that are not tasks. Notepad tool
Links Saved URLs organized as Cards β†’ Tabs β†’ Items. Links tool
Routines Alarms, timers, recurring routines, system schedules, and follow-up watches. Routines tool
Knowledge Library Uploaded documents, Catalogs, Sources, citations, and library search. Knowledge Library overview
Fleet Solutions Fleet ticket triage β€” assignment filters and search, one-step advance, unit assignment, customer findings, and recoverable deletes β€” via the connected DieselSS service. Private restricted tool: not documented in the public handbook; documentation for granted accounts is provided separately.

Use tools together

Tools are most helpful when they support each other:

  • Use Weather with Calendar to plan outdoor appointments.
  • Use Tasks with Calendar when work has deadlines.
  • Use Shopping with Routines for recurring errands.
  • Use Links and Notepad for quick reference, then move long documents into Knowledge Library.
  • Use Pins to keep your most-used Settings destinations close.

Canvas status

Some Tavina planning material uses the word Canvas for rendered HTML, SVG, or Markdown. In the current source verified for this update, Canvas is not a standalone default toolbar tool. See Canvas and rendered content for the current expectation.

Good questions to ask Tavina

  • “Which tool should I use for this?”
  • “Open my task list.”
  • “Take me back to the panel we were just using.”
  • “Turn this plan into Tasks and Calendar events.”
  • “Move these links into the Links tool.”
  • “Use my Weather and Calendar to plan tomorrow morning.”
  • “Which Knowledge Library Source did you use?”

Related pages

Scroll to Top