Tavina

Version History tool

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

Version History tool

When you delete something in Tasks, Notepad, Shopping, Links, or Clock, Tavina quietly saves a copy of it first. If you change your mind, your Tavina agent can show you what was deleted and put it back β€” no help desk needed.

What is kept

Every time you delete one of the following, Tavina snapshots the item and everything inside it before the deletion happens:

  • Tasks β€” deleting a board, list, task, subtask, or checklist, including a board label together with its card assignments
  • Journal β€” discarding a recorded session, together with its brainstorming Q&A and linked agent memory
  • Contacts β€” deleting a tag, list, or segment, or removing a tag, list, or custom field from a contact
  • Knowledge Library β€” deleting a Source or personal Catalog; purging an original is captured byte-for-byte so it can be restored byte-exact, and purged derivatives are recovered by regenerating them from the retained or restored original
  • Automations β€” deleting a workflow or version, with the full workflow graph captured before removal
  • Fleet Solutions β€” an agent-driven rule delete, with the full rule captured so a restore re-creates it in the connected service
  • Notepad β€” deleting a collection or a single note
  • Shopping β€” deleting a list or item, or clearing completed items
  • Links β€” deleting a collection with its tabs and links, deleting a tab with its links, or deleting a single link
  • Clock β€” deleting an event or watch

For example, deleting a Tasks board keeps the board together with all of its lists, tasks, subtasks, checklists, comments, and labels, so the whole tree comes back on restore.

Tavina asks before deleting

Your Tavina agent will not delete something big on the spot. Before a destructive deletion β€” like removing a whole Tasks board, a Notepad collection, a Shopping list with its items, or a Links card β€” the agent checks with you first. Nothing is removed until you agree, and if you decline the item stays exactly as it was. Smaller deletions, such as a single note, task, or link, are also confirmed by default so an accidental request will not quietly remove something.

This confirmation and the version history work together: once you agree to a deletion, Tavina still saves its copy to version history first, so the safety net of listing and restoring recent deletions stays in place. Recovery is fail-closed across these tools: if the safety capture cannot be completed, the deletion does not happen at all (tavina/tavina#1958). Journal sessions recover through the Journal’s own recoveries list, which restores the entry, its listener Q&A, and the linked agent memory in one step.

How to recover something

Just ask your Tavina agent in plain language:

  • “What did I delete recently in Tasks?”
  • “I deleted my Shopping list by mistake β€” can you bring it back?”
  • “Restore the clock event I removed yesterday.”

Your agent can list the most recent deletions per tool and restore any of them. Restores bring back the deleted item exactly as it was, including nested items.

You can also recover things yourself in the app: the Notepad, Shopping, and Links tools each have a Recently Deleted panel that lists your recent deletions for that tool and restores them with one tap. If a snapshot can no longer be restored, the panel tells you honestly instead of failing silently.

Limits and expectations

  • Tavina keeps a short version ring of the most recent snapshots for each deleted item β€” by default the last six snapshots per item (configurable by the operator) β€” so old chains of deletions of the same item eventually age out. Restore promptly if something matters.
  • Only deletions are versioned. Editing a note or renaming a task is not kept in version history.
  • Restores are recorded in the audit journal, so there is always a trace of who restored what.
  • Each subscriber’s version history is private to them; one subscriber can never see or restore another subscriber’s deleted items.
  • Version History is not a toolbar tool: it works through your agent’s list/restore actions and the in-tool Recently Deleted panels (Notepad, Shopping, Links). For help with a restore that will not complete, see Getting help and reporting bugs.
Scroll to Top