# Tana > Tana is an agentic meeting platform. Work gets done in the meeting, not after. Agents create documents, file issues, and update your context graph while you talk. And each meeting makes future meetings smarter. This file contains the full documentation for **Tana**, an agentic meeting platform where AI agents do real work during meetings. **Tana Outliner** is a separate, earlier product for knowledge management through structured outlining. It lives at https://outliner.tana.inc and has its own documentation there. These are distinct products that share a brand name. If you are looking for help with Tana Outliner, do not use this documentation. ## Tana ### Features #### Agents URL: https://tana.inc/learn/features/agents Agents are custom AI assistants you build by describing what you need and adjust the same way, by talking to them. - [Build an agent](#creating-an-agent) by describing what you need; the AI scaffolds the prompt, capabilities, and settings - [Capabilities](#agent-capabilities) bundle the tools an agent needs with the instructions for using them well - Run agents in [chat](#chatting-with-an-agent), by [voice](#voice-mode), or on a [schedule](#schedules) so they run while you sleep - Each [space](/learn/features/spaces) can set a default agent that picks up new chats automatically - [System agents](#system-agents) are built in and read-only; you build the rest ## What an agent is An agent is an AI assistant you configure for a specific job: prepping you for meetings, triaging bugs, drafting weekly updates, or anything else you would otherwise repeat in a fresh chat. Each agent has its own capabilities, prompt, settings, optional voice, and optional schedules, and lives as a doc you can open like any other. The default Tana assistant is one such agent, built in to every org. Custom agents stand alongside it. ## Creating an agent Click the **pencil button** at the top of the sidebar to start a new agent, then describe what you want. Agents created from here are global, available to the whole organization, and show up in the sidebar. You can also ask the AI chat to create an agent: "I want an agent that preps me for every meeting by pulling context on the people I'm meeting with." Tana builds the agent, including name, prompt, capabilities, and a starting set of context fields. Adjust it the same way you created it: keep talking to it, in [chat](#chatting-with-an-agent) or by [voice](#voice-mode). The agent edits its own configuration as you tell it what to change. Custom agents live in [spaces](/learn/features/spaces), so they pick up that space's context and members. Agents owned by a space appear as a leaf row under that space in the sidebar tree, revealed via the chevron just like a sub-space. Global agents (not scoped to a space) show in a **Custom agents** section in the sidebar. Agents in the sidebar are draggable, so you can re-parent an agent to another space or drop it into an editor as a link. ## Customizing an agent Open the agent and click **Customize** next to the title. The panel expands with sections for: - **Capabilities:** What the agent can read, do, and connect to, including [integrations](#agent-capabilities) like GitHub, Slack, Linear, Jira, and HubSpot. - **Prompt:** The instructions the agent follows, written in a rich text editor with full formatting. An **Improve Your Agent** helper opens a chat that can read and rewrite the prompt with you. To include Tana docs, chats, or meetings as context, reference them in the prompt with `@` mention search. - **Schedules:** Days and times for the agent to run automatically. See [Schedules](#schedules). - **Voice:** The voice the agent uses when speaking. See [Voice mode](#voice-mode). The agent doc also lists recent outputs and chats so you can see what the agent has been doing. ### Agent capabilities The **Capabilities** section of the Customize panel controls what the agent can do, organized into two groups of skills. **Capability skills** bundle a coherent set of tools with the instructions for using them well: - **Reading capabilities:** Searching, reading, and gathering context from Tana. - **Create capabilities:** Creating new documents and items. - **Update capabilities:** Editing existing documents, fields, and structure. Toggle a capability on to grant the agent its underlying tools plus Tana's guidance for using them. As Tana refines a capability over time (adding tools, sharpening instructions), every agent that has it picks up the improvement automatically. New agents are seeded with the **Reading** capability so they are useful out of the box. **Integration skills** appear as a dedicated section with one-click toggles for each connected service: GitHub, Slack, Linear, Jira, and HubSpot. Each row shows the live connection status. If an integration is not connected, the row shows a **Not connected** button that deep-links straight to its setting in [Integrations](/learn/features/integrations). For the rare case where you need a single tool that no capability or integration covers, an **Advanced** picker lets you enable individual tools directly. Capability skills are the preferred path because they bundle tools with their usage instructions and stay current as Tana improves them. Agents that were configured before the switch to capabilities get an upgrade button on the agent doc that converts their old tool-bundle setup to the matching capabilities. ### Default agent per space Every [space](/learn/features/spaces) can set a default agent. Any new chat started from that space's home picks up the default agent unless you choose a different one explicitly. To create an agent inside a space, navigate to the space and click the **+** button in the top right corner, then select **Agent**. You can also create the agent in chat and ask the AI to move it to the space. ### Auto-resume after proposals Agents can be configured to continue the conversation automatically once you have accepted or dismissed the last pending [proposal](/learn/features/proposals), so multi-step flows do not stall waiting for a nudge. ## Chatting with an agent Open the agent and start typing in its chat panel. It uses the same composer as everywhere else in Tana ([@mentions](/learn/features/chat#mentions-and-skills), [skills](/learn/features/skills) with `/`, attachments, voice input). The agent uses its configured capabilities, prompt, and context fields on every message. You can also reference an agent from any chat with `@`, the same way you reference a document. The agent is timezone-aware: when you ask about "today" or "yesterday", it uses your own calendar day, even if the chat spans midnight or a teammate is in a different time zone. ## Voice mode Agents can run in voice mode inside meetings, letting you have a two-way live voice chat with them. The voice widget in meetings includes an agent picker that lets you switch to any custom agent. Each agent has a **Voice** setting in its Customize panel that chooses from seven distinct voice profiles: Cove, Wren, Ivy, Sage, Pip, Finn, and Slate. Newly created agents get a random voice so two agents in the same org are unlikely to sound the same. The agent doc also has a **Voice sessions** section with a **Start** button. Clicking it creates a fresh calendar event pre-set to that agent and drops you into the call. Recent voice sessions show up as a list so you can jump back into one later to continue. For the in-meeting voice agent experience (wake words, multi-participant behaviour, guest handling), see [Meetings, Voice agent](/learn/features/meetings#voice-agent). ## Schedules Put an agent on a schedule so it runs without you. In the Customize panel's **Schedules** section, pick days of the week and a time of day. Each schedule has a **Timezone** (a searchable picker that defaults to your own zone), so a daily brief set to 09:00 in Oslo always lands on the right Oslo calendar day, and the agent reasons about "today" in that zone. Each schedule can carry an optional **Additional prompt** that varies what the agent does on different runs. For example, a daily morning agent might pull a different focus area depending on the day. The agent's activity panel shows enabled schedules with the routine in its configured zone and the zone labelled (for example, "Weekdays at 09:05 (Europe/London)"). The **Next run** and **Last run** labels stay in your own local zone. ## System agents Some agents are built in to Tana and managed centrally. They show a **System agent** badge instead of the Customize button and cannot be edited. The default Tana assistant is the canonical example. ## Deleting an agent Open an agent's doc and choose **Delete** from the overflow menu. ## Reporting issues If an agent produces an incorrect or unhelpful response, right-click the message and select **Report Bad Chat**. The full conversation, plus the agent's current configuration, is attached automatically for analysis. --- #### AI chat URL: https://tana.inc/learn/features/chat Chat with AI on your own, or bring AI into a conversation with teammates by @mentioning it. - AI can read, search, create, update, and delete content across Tana - Reference any document with [@mentions](#mentions-and-skills) and invoke [skills](/learn/features/skills) with / - Every AI change is a [proposal](/learn/features/proposals) you review before it applies - Connected to [GitHub, Slack, Linear, and coding tools](#connected-tools) for cross-tool workflows - [Voice input](#voice-input) with real-time dictation in the chat input - Switch between [models](#choosing-a-model) from OpenAI, Anthropic, and Google ## Solo chat or team chat Every chat in Tana is either a solo conversation with the AI or a conversation with teammates. The two work the same way, with one difference: - **Solo chat:** You and the AI. The AI responds to every message. - **Team chat:** You, teammates, and optionally the AI. The AI stays quiet by default. Mention @Tana when you want a response, so human conversation is not interrupted. In both cases, the AI has the same capabilities: reading your content, creating and updating documents, invoking [skills](/learn/features/skills), and connecting to your [integrations](/learn/features/integrations) and [custom MCP servers](/learn/features/integrations#custom-mcp-servers). ## Starting a chat There are several ways to start a conversation with AI in Tana: - **Today:** The "Ask or Capture…" bar below the date header in [Today](/learn/features/today). Each message starts a fresh solo chat pinned to the selected date. - **Space home:** The "Ask or start a chat..." bar at the bottom of every space home. Type a message and press enter to create a new chat scoped to that space. - **Meetings:** Every meeting has two chat surfaces. The private [Ask or Capture](/learn/features/meetings#chat-in-the-call) pill in the bottom bar is yours alone and the AI auto-responds to every message. The shared [Chat With Everyone](/learn/features/meetings#chat-in-the-call), opened from the call toolbar, is visible to all attendees and stays quiet until you mention @Tana. - **Quick chat:** Press on the desktop app to open a new chat from anywhere. Press to open it with voice dictation active. - **Sidebar:** Click "New Chat" in the sidebar. - **Create menu:** Select "Chat" from the create menu. - **Documents:** Many document types have a contextual chat panel that scopes the conversation to the open document. Recent chats appear in the sidebar sorted by last activity, with unread indicators for new messages. ## Composing a message ### Mentions and skills Reference documents and invoke AI capabilities directly from the message input: - Type **@** to search and reference any document in Tana. The AI receives the referenced document as context. Mentioning @Tana triggers an AI response in chats with other people. - Type **/** to search and attach a [skill](/learn/features/skills). The AI follows the skill's instructions when responding. The same `/` also accesses emoji and formatting commands. - Type to open the emoji picker (about 250 common emojis searchable by shortcode). Press again to close the picker without inserting anything. ### Attachments Add images, audio, video, PDFs, and other files by dragging them into the chat, pasting, or clicking the attach button. Each attachment shows upload progress while it is sending, and Send waits until uploads finish so nothing is silently dropped. Failed uploads can be removed and retried. Images get AI-generated descriptions automatically, and the AI reads PDFs, audio, and video so it can summarize them, answer questions about their content, and embed media inline in its replies. ### Voice input The chat toolbar has two voice modes: - **Dictation:** Click the microphone button to speak your message. Words appear in the input as you speak. Supports English, Norwegian, and many other languages. - **Audio recording:** Click the voice button to record an audio clip, preview it, and send as an attachment. The audio is automatically transcribed. ## What AI can do ### In Tana The AI has full access to your content (within your permissions). It can: - **Read:** Documents, types, fields, meeting transcripts and participants, screen capture screenshots, calendar events, skill definitions, previous chats, tables, attached PDFs, and uploaded audio and video - **Search:** Keyword search, semantic search, relationships between documents - **Create:** Docs, tasks, typed entries, types with fields, skills, artifacts, AI-generated images, and calendar events - **Update:** Titles, content, fields, calendar events, space configuration, table data, and type definitions - **Delete:** Any document When the AI creates a calendar event it needs a title and start time; end time, timezone, location, description, and participants are optional. Passing participants restricts the event to that list with you as admin. Updating an existing event covers its tagline, summary, wrap-up screenshots, and pinned documents; the time, title, attendees, and meeting link come from the calendar and the AI does not change them. Updates and deletes and creates all appear as [proposals](/learn/features/proposals) for your review. AI never changes anything without your approval. ### Connected tools When you connect integrations, the AI can act on them from chat: - **GitHub:** Search and create issues, review and merge pull requests, read code and files, comment on issues and PRs - **Slack:** Send messages to channels or people, list channels and users - **Linear:** Search, create, and update issues - **Custom MCP servers:** Use the tools from any [remote MCP server you connect](/learn/features/integrations#custom-mcp-servers), surfaced through the linked skill for that server - **Coding tools:** Hand off the current document or chat as a self-contained prompt to Claude Code, Cursor, Codex, GitHub Copilot, Lovable, or v0. Triggered by phrasings like "create a PR" or "send this to Cursor"; when more than one tool is enabled, you pick. Configure integrations in Settings. See [Integrations](/learn/features/integrations). ### Managing access The AI can also propose changes to a document's access: restricting it to specific participants with editor or admin roles, opening it back up to everyone in its space or event, and toggling the Guest Link (anyone with the link can view). Access changes go through the same proposal approval flow as the rest of the AI's edits, and the proposal preview shows a clear access callout before you accept. ### Default content language Every organization picks a default content language in Settings, Organization, Language. The AI writes its replies, generated artifacts, outcomes, summaries, and document titles in that language no matter which language the conversation is happening in. Meeting transcription stays multilingual (auto-detected per speaker) so a mixed-language call still transcribes everyone correctly. ### Usage limits Each organization has monthly and rolling two-hour AI usage limits, plus a shared org-wide pool. As a bucket approaches 80 percent, an amber "Approaching usage limit" callout appears at the top of every chat panel and a soft warning lands in Activity. When a bucket is exceeded, the AI returns a red "Usage limit reached" callout instead of a reply, with a countdown to when you can chat again. Your own monthly and two-hour caps are visible as progress bars in Settings, User, Usage. ### Web search and image generation Models that support web search can look up current information when your question goes beyond Tana. Results include citation links to sources. Web search availability varies by model. The AI can also generate images from text descriptions. Generated images become image documents owned by the chat they were created in, so an image made in an "Only me" chat stays private. When a reply includes a Mermaid diagram, Tana renders it inline once the diagram is complete, so you never see a half-drawn render. A malformed diagram shows a compact notice instead, and the AI corrects it on its next turn. ## Reviewing changes Every AI-generated document, edit, or deletion appears as a proposal you review before it takes effect. Proposals show up as inline cards on the message that produced them, so you can see what the AI did and decide on it in place. Each pending proposal shows a **Location and access** pill telling you where the new document will live and who will see it, so the consequences are visible before you accept. Accept individually, reject, or iterate by chatting with the AI to refine before accepting. When the AI assigns a task to you while acting on your behalf, you do not get a notification for your own work. Assigning to someone else still notifies them, attributed to you. See [Proposals](/learn/features/proposals) for the full review workflow. ## Choosing a model Tana supports models from OpenAI, Anthropic, and Google. Switch models at any time during a conversation. The change takes effect on the next message. Models are grouped by cost: - **Cheap:** Smaller, faster models for simple tasks - **Moderate:** Balanced cost and capability - **Expensive:** Most capable models for complex reasoning Some models support **reasoning** with configurable effort levels (low, medium, high). Some support **web search**. Both capabilities are indicated in the model selector. ## Clarifying questions The AI may ask clarifying questions before proceeding with a task. When this happens, the chat input is replaced with the question and a set of options. Each card also includes a **Something else** free-text fallback at the bottom so you can answer in your own words instead of being forced into one of the suggested choices. Pick an option, type a custom answer, or skip the question. ## Side panels The chat toolbar opens side panels for: - **Outcomes:** Pending proposals and accepted outcomes from this conversation - **In common:** Documents shared between chat participants. Only visible when the chat has multiple participants. ## Agents Beyond the default Tana assistant, you can build custom agents with their own capabilities, prompt, voice, and schedules. Click the pencil button at the top of the sidebar, describe what you want, and Tana scaffolds the agent for you. See [Agents](/learn/features/agents) for the full guide. ## Reporting issues If the AI produces an incorrect or unhelpful response, right-click the message and select "Report Bad Chat." Describe what went wrong and the full conversation is attached automatically for analysis. When an AI run fails outright, the chat displays a red callout with a one-line, actionable reason: provider rejection (e.g. "image exceeds 2000 pixels on the longest side"), idle timeout, too many tool steps, repeated tool errors, stalled response, or a generic "Something went wrong" fallback. Cancelled and "Usage limit reached" keep their pill style. The AI also recovers automatically from malformed tool calls before giving up. --- #### Apps URL: https://tana.inc/learn/features/apps Tana runs on the web and as a desktop app, all syncing in real time. - [Desktop app](#desktop): tabs, split view, and [external meeting capture](/learn/features/meetings#capture-an-external-call) - [System tray](#system-tray) shows today's agenda for every signed-in org - [Web app](#web): works in any browser, installable as a PWA - All platforms [sync in real time](#sync) - Deep links (`tana-app://`) for opening specific documents from other tools ## Desktop The Tana desktop app is available for Mac and provides features beyond the web experience. ### Tabs Open multiple documents in separate tabs within one window. The tab bar appears at the top when you open a second tab. Each tab maintains its own navigation history and split view state. Use to open a new tab, to close the current one, and or to cycle between them. on any link opens it in a new tab. ### Split view Work with two documents side by side. Use on any link to open it in the other pane. Drag the divider to adjust the split ratio. Each pane can be closed independently. Use on a link to open it in a new window instead. ### External meeting capture The desktop app can detect active Zoom, Teams, and Google Meet calls and capture their audio and screen content for transcription and outcome extraction. See [External meeting capture](/learn/features/meetings#capture-an-external-call) for the full workflow. ### System tray The desktop app installs a menu bar icon that shows today's agenda across every organization you are signed in to. Events are listed in time order. When you are in more than one org, each event is labelled with the org it belongs to so it is clear which org it is from. The menu bar title shows the meeting that is happening right now, or the next one coming up if nothing is in progress. Click any event to jump to it. ### Deep links The desktop app registers the `tana-app://` URL scheme. Links in this format open the corresponding document directly in the app, making it easy to link to Tana content from other tools. ## Web Tana works in any modern browser at [home.tana.inc](https://home.tana.inc). The web app can be installed as a PWA (Progressive Web App) for a more app-like experience. The web app has the same features as the desktop app except for tabs, split view, and external meeting capture. ## Sync Tana syncs in real time across all your devices. The sync indicator in the sidebar shows connection status. ## Updates When a new version is ready, Tana shows an update banner. How soon it appears depends on how long your session has been open, and after a long idle stretch Tana asks you to reload with a "Reload required" prompt. Neither the banner nor the prompt interrupts you while you are in a call. --- #### Artifacts URL: https://tana.inc/learn/features/artifacts Artifacts are AI-generated visual documents that turn conversations into presentation-ready material. - Three types: [storyboards](#storyboard), [customer journey maps](#customer-journey), and [slide decks](#slides) - Generated from [meeting transcripts](/learn/features/meetings#outcomes) or [chat conversations](/learn/features/chat) - Fully [editable](#editing-artifacts): click any text to edit inline, drag to reorder, AI to iterate - Created as [proposals](/learn/features/proposals) you review before accepting - Shareable like any document via [access controls](/learn/features/spaces#access-modes) ## What artifacts are Artifacts are structured visual documents generated by AI from your conversations. Unlike docs (which are freeform text), artifacts have a specific layout and visual design tailored to their type. They turn meeting discussions into presentation-ready materials. ## Creating artifacts Generate artifacts from two places: - **Meeting outcomes:** Click "Generate artifact" in the outcomes panel during or after a [meeting](/learn/features/meetings). Choose the artifact type and AI generates it from the transcript and screen captures. - **Chat:** Ask the AI in any [chat](/learn/features/chat) to create an artifact. The AI uses the conversation context to generate it. Artifacts are created as [proposals](/learn/features/proposals) that you review before they become visible in Tana. ## Artifact types ### Storyboard A visual narrative with scene cards, designed for pitch decks and presentations. Each scene has a title, description, visual notes, and an optional AI-generated image. Scenes are laid out in a scrollable grid. You can drag scenes to reorder them, move scenes to a "Probably not relevant" section to set them aside without deleting, or remove scenes entirely. ### Customer journey A before-and-after comparison showing workflow improvements. The "before" side shows pain points and quotes, the "after" side shows the improved workflow with success criteria. Toggle between before and after views to compare. ### Slides A full presentation deck with a hero slide, takeaway cards, themed sections, action items, and a closing slide. The deck includes its own navigation controls, progress bar, and keyboard shortcuts for presenting. Sections support multiple component types including callouts, checklists, numbered grids, and screenshot galleries. ## Editing artifacts All artifact text is editable inline. Click any title, description, or text element to edit it directly. Changes are saved automatically. For larger changes, open the artifact in [chat](/learn/features/chat) ("Open in chat" in the toolbar) and describe what you want changed. The AI can update specific items, add new content, remove sections, reorder elements, and regenerate images. When reviewing an artifact as a [proposal](/learn/features/proposals), use the iteration chat to refine it before accepting. Each round of changes creates a new version you can compare. ## Sharing Artifacts support the same [access controls](/learn/features/spaces#access-modes) as any document. Share with specific people or make available to everyone in the space. Link sharing also works for storyboards, customer journey maps, and slide decks. Generated images and screen-share screenshots resolve to signed URLs in the public viewer so all imagery renders, and slide decks with full-bleed layouts use the entire viewport. Artifacts opened from a public link are fully read-only: text is non-editable, drag handles and drop zones for storyboard scene reorder are hidden, and delete buttons are removed. Open the same artifact inside the app and inline editing, drag-and-drop reorder, and delete actions are all available. --- #### Canvas URL: https://tana.inc/learn/features/canvas Canvas is an infinite whiteboard in Tana for visual thinking. - Infinite whiteboard with drawing tools, shapes, arrows, and text - [Embed documents](#embedding-documents) from Tana directly on the canvas - [Real-time collaboration](#collaboration) with live cursors and follow mode - Full editing toolkit: [align, distribute, flip, group](#editing), undo/redo - Every canvas supports [backlinks](/learn/features/docs#backlinks) and [sharing](/learn/features/spaces#access-modes) ## Creating a canvas Select "Canvas" from the [create menu](/learn/features/interface#create-menu). A canvas opens as a full-screen whiteboard with an editable title and drawing tools. ## Drawing tools The toolbar at the bottom of the canvas provides standard drawing tools: select, draw, arrow, text, and shapes. These are the default tldraw tools for freeform visual work. ## Embedding documents Click the embed tool in the toolbar to place a document from Tana onto the canvas. A picker appears showing documents in the current space. Select one to embed it as a card on the canvas. Double-click an embedded document to view its content. You can also create new docs directly from the canvas. When you embed an image, it converts to a native canvas image for better handling. ## Editing The menu bar at the top provides: - **Edit:** Undo, redo, cut, copy, paste, duplicate, delete, select all - **View:** Theme (light, dark, system), zoom controls (in, out, fit, 100%) - **Selection:** Align (left, center, right, top, middle, bottom), distribute (horizontal, vertical), flip (horizontal, vertical), group and ungroup ## Collaboration Multiple people can work on the same canvas simultaneously. Each person's cursor is visible in real time with their name and a color. Use the collaborator panel to follow someone else's view as they navigate the canvas. ## Side panels - **Backlinks:** Documents that reference this canvas - **In common:** Documents shared between canvas participants ## Open in chat Click "Open in chat" in the toolbar to start an AI [conversation](/learn/features/chat) with this canvas as context. --- #### Docs URL: https://tana.inc/learn/features/docs Docs are the default kind of item in Tana for writing, thinking, and capturing context and information. - Rich text editor with [slash commands](#slash-commands) for headings, lists, code blocks, math, diagrams, and more - Assign a [type](/learn/features/types) to add structured fields, or use as a freeform doc - [Mention](#mentions) docs, people, and items with rich, interactive pills - [Backlinks](#backlinks) show every item that references this doc - [Send to](#send-to) routes a doc to a chat, a skill, a meeting, a copied link, or Markdown export ## Creating a doc Select "Doc" from the [create menu](/learn/features/interface#create-menu), or from the "+" button on any space home or date in [Today](/learn/features/today). A Doc is the default item kind for freeform writing, and the create menu, types table, space home buttons, slash command, and AI tools all use the label **Doc**. The slash-menu aliases "note" and "document" still match the same option, so existing muscle memory keeps working. When you create a typed entry inline (from the kanban board's "+" buttons or the slash command), the **Inline document popover** protects in-flight work: while the new doc is still in proposal state, clicking outside or pressing Escape no longer discards what you typed. Only the **Create** button (to keep it) and the **Discard** trash icon (to drop it) close the popover. Editing an existing doc is unchanged: outside-click and Escape still dismiss the popover. ## The editor A doc opens as a full-screen editor with an editable title at the top and a rich text area below. The editor supports real-time collaborative editing: multiple people can write in the same doc at the same time. ### Formatting Select text to access inline formatting: **bold**, _italic_, ~~strikethrough~~, and `inline code`. ### Slash commands Type `/` anywhere in the editor to insert: - **Heading 1, 2, 3:** Section headings at different levels - **Bullet list:** Unordered list - **Numbered list:** Ordered list - **Code block:** Syntax-highlighted code - **Quote:** Blockquote - **Divider:** Horizontal rule - **Math block:** LaTeX equation - **Mermaid diagram:** A diagram written in Mermaid syntax In the title, type `/` to set or remove a [type](/learn/features/types) on the doc. A Mermaid block renders the diagram with a "Preview" / "Source" toggle (Preview by default); click the diagram to open it in a pan and zoom view. You can also turn any existing code block into a diagram by changing its language to Mermaid. Flowcharts and the common graph types are supported. ### Emoji picker Type in the editor or the chat composer to open the emoji picker (Slack-style, around 250 common emojis searchable by shortcode). Pick one to insert it. Pressing again closes the picker without inserting anything. ### Images and attachments Drag and drop, paste, or use the attach button to add images, audio, and video files to a doc. Images get AI-generated descriptions automatically. Video and audio render inline as native HTML5 players in the editor, the read-only viewer, the diff preview, and the compact editor, so attached media plays in place rather than as a separate download. Opening a video or audio item on its own shows it in a dedicated player panel with the standard toolbar, with upload-in-progress and failed states surfaced in the player area. ### Mentions Type `@` to mention another document, a person, or any item. You can also paste a link to another Tana item and it drops in an inline mention at your cursor, while links to images and videos render the media inline. Each mention is a pill with a leading symbol that matches what it points to: a task's state, a person's avatar, an image thumbnail, a type badge for a typed item, or the document-kind icon for everything else (Doc, Canvas, Meeting, Chat, Skill, Agent, Space, and audio, video, or other assets). Long titles truncate so the pill stays one bounded shape, including inside table cells and headings. Move between mentions with the arrow keys, and open one by pressing Enter or clicking: a Doc opens in a peek side panel, other kinds navigate to the item. Modifier-clicks open the mention in a new tab, window, or split, the same as any other link. You can also drag a mention to move it within the doc. ## Types and fields Any item can be assigned a [type](/learn/features/types) to add structured fields. For example, assign a "Bug" type to add fields like priority, assignee, and status. Set the type from the overflow menu ("Set type") or via slash command in the title. When a type with a workflow is assigned, the item becomes a [task](/learn/features/tasks) with state tracking and assignment. ## Task state An item with a task state shows a checkbox next to the title. Click the checkbox or press to toggle between open and closed. See [Tasks](/learn/features/tasks) for full task management. ## Send to Every item has a **Send to** menu in its toolbar, and on meeting tiles, that routes the item without leaving it: - **Chat with...:** start a chat about the item with Tana, one of your [custom agents](/learn/features/agents), or a teammate. This creates a new chat with the item attached and opens it, ready for your first message. Choosing a teammate makes a shared private chat with just the two of you; if they do not already have access to the item, Tana offers to grant it. - **Skills and integrations:** run any [skill](/learn/features/skills) attached to the item's type, or a connected integration like GitHub or Linear. If a skill creates an external issue, it links to it once run. - **Pin to meeting:** attach the item to a meeting so everyone in the call can see it. - **Copy link:** copy a link to the item. - **Export Markdown:** download the item as a `.md` file, with the title as an H1 heading and the full content in Markdown. In the Chat with... list, the people you have recently shared docs, chats, and canvases with come first, shown with their profile photos. ## Open in chat Right-click a doc and choose "Open in chat" to iterate on it with AI in a split view: proposed edits on the left, an iteration chat on the right. Describe the change you want and the AI updates the proposal in place. Accepting lands the edits on the original doc; rejecting or closing leaves it unchanged. These iteration chats are owned by the doc itself, so they stay out of your main chats list. ## Side panels The toolbar provides access to side panels: - **Table of contents:** Headings from the doc, for quick navigation within long documents - **Backlinks:** All items that reference this doc, grouped by field type or mention context. Backlinks update automatically as other items link to it. - **Changes:** Chronological history of edits showing what changed, who made the change, and when. Click an entry to see details. - **In common:** Items shared between the doc's participants. Only visible when the doc has multiple participants. Backlinks and Changes are pinned open by default. ### Backlinks Backlinks are a key part of how information connects in Tana. When any item links to or mentions this doc, that reference appears in the backlinks panel. Backlinks are grouped by how the reference was made: through a specific field (shown as "Type > Field"), or as an inline mention. ## Location and access The doc toolbar shows two adjacent buttons for location and access: - **Location** ("Lives in") opens a popover for the document's scope (which space or event it belongs to), with an Open button to navigate to the parent. A doc that does not live in a space or on a meeting shows a book icon and a "Library" label, and clicking it opens the [Library](/learn/features/interface#library). - **Access** opens access mode, participants, and Guest Link. See [Spaces and sharing](/learn/features/spaces#access-modes) for the access modes and [Link sharing](/learn/features/spaces#link-sharing) for the Guest Link behavior. The same **Move** action lives in every doc panel's overflow menu (Doc, Canvas, Chat, Skill, Agent, Artifact, Type, Space Home, plus Image, Asset, Audio, Call, and Transcript panels). It is also available on the meeting event overflow menu and on the inline document popover. ## Deleting a doc Delete from the overflow menu or context menu. A confirmation dialog warns before proceeding. A deleted document is soft-deleted: opening it shows a "Document deleted" panel with a "Restore document" button, so you can bring it back if you removed it by mistake. --- #### Integrations URL: https://tana.inc/learn/features/integrations Integrations connect Tana to the tools your team already uses. - [Google Calendar and Outlook](#calendar-sync): sync events to your Tana calendar - [GitHub](#github): create and manage issues, review PRs, read code from AI chat - [Slack](#slack): send messages and list channels from AI chat, mention @tana in any thread, plus the /tana slash command - [Linear](#linear): create and track issues from meetings and chat - [Jira](#jira): create and update issues from meetings and Chat, with meeting screenshots embedded as visual context - [HubSpot](#hubspot): search contacts, companies, and deals from your CRM, log notes, and update lifecycle stages from Chat - [Custom MCP servers](#custom-mcp-servers): connect your own remote MCP servers so their tools are available to AI chat - [Coding tools](#coding-tools): send prompts to Cursor, GitHub Copilot, Codex, and Lovable from AI chat - All integrations are accessible to AI in [chat](/learn/features/chat) as tools - Connect from [Settings](/learn/features/interface#settings) with one-click OAuth ## Connecting integrations All integrations are configured in Settings. Click "Connect" to start the OAuth flow and authorize the service. On the desktop app, the authorization page opens in your default browser so passkeys and password managers work; Tana finishes the connection once the provider reports it as active. On the web, authorization opens in a popup. Once connected, the integration is available to AI in [chat](/learn/features/chat) and through [skills](/learn/features/skills). You can disconnect or reconnect integrations at any time from the same settings page. ## Calendar sync Connect **Google Calendar** or **Microsoft Outlook** to see your events in [Today](/learn/features/today). On the desktop app, connecting or reconnecting a calendar opens the provider's sign-in page in your default browser, so passkeys and password managers work. The first time you connect a provider, Tana enables that account's primary calendar automatically so [Today](/learn/features/today) has events to show right away. After that, enable the specific calendars you want to sync. Each calendar can be enabled, disabled, or force-synced individually. Events sync automatically when changes happen on either side, and you can trigger a manual sync at any time. If you disconnect and later reconnect the same provider, Tana remembers the calendars you previously had enabled and turns them back on for you. If a connected calendar stops syncing for any reason, Tana surfaces a **Calendar needs reconnect** indicator next to your account in the sidebar and on the calendar settings page. Reconnecting the affected provider clears the warning. The reconnect dialog tells you that reconnecting clears your current calendar selections so you know to re-pick them afterwards. If an account is connected without write permission, Calendar settings shows it with an amber **Read-only** row and an **Enable edits** action that runs the consent flow to grant write access. The per-calendar write toggles stay dimmed until it is granted. Synced events show their original title, time, attendees, and external meeting link. You can add talking points, start a chat, and extract outcomes from synced events the same way as Tana-created meetings. For more on working with synced events, see [Meetings](/learn/features/meetings#calendar-sync). ## GitHub Connect your GitHub account to work with repositories, issues, and pull requests from AI chat. What the AI can do with GitHub: - **Repositories:** List your repositories and browse directory contents - **Issues:** Search, read, create, update issues. Add comments. - **Pull requests:** List, create, review, merge PRs. Add comments. - **Code:** Read file contents from repositories When a [skill](/learn/features/skills) is attached to a type for GitHub issue creation, you can file an issue from the item's [Send to](/learn/features/docs#send-to) menu; the AI asks which repository when the item does not make it obvious, then links to the GitHub issue once it is created. Filing an issue from a meeting reads the transcript, pulls in screen-share screenshots, and asks a clarifying question if the surface is ambiguous, then attaches an automatic **Screenshots** section to the issue body. ## Slack Two levels of Slack integration: **Organization-level (admin):** Install the Tana Slack app to enable the `/tana` slash command in your Slack workspace. **Personal:** Connect your Slack account to let AI chat send messages and access channels. What the AI can do with Slack: - List channels and users - Send direct messages - Send channel messages **Mentioning @tana in a thread:** Mention `@tana` in any Slack thread to bring Tana into the conversation. It posts a thinking placeholder and edits it in place with the answer, and keeps a running chat per thread so follow-ups have context. It reads the earlier messages in the thread and any files shared there, and ingests image, PDF, text, and JSON attachments on the mention, so you can drop in a screenshot or document and ask about it. Tana only uses what each participant in the thread is allowed to see. If your Slack email does not match a Tana account, `@tana` and `/tana` reply with an **open in Tana** link that pairs the two identities, so future mentions resolve to you. ## Linear Connect Linear to create and manage issues from meetings and chat. What the AI can do with Linear: - List teams - Search existing issues - Create new issues - Update issues Like GitHub, Linear has a system [skill](/learn/features/skills) for creating issues from typed items. Attach it to a type and run it from any item's [Send to](/learn/features/docs#send-to) menu. ## Jira Connect Jira to create and update issues from meetings and Chat. Useful for pushing bugs and feature requests out of meeting outcomes and into the project tracker. What the AI can do with Jira: - List Jira projects the connected account has access to - Search issues by free text, optionally scoped to a project key - Create issues with summary, description, type, priority, labels, assignee, and parent (for subtasks or epics) - Update an existing issue's summary, description, priority, labels, assignee, or workflow status Filing a Jira issue from a meeting reads the transcript and embeds screen-share screenshots into the issue description as visual context, the same way it works for GitHub. ## HubSpot Connect HubSpot to read and update CRM data from Chat. Useful for pulling context into a meeting prep, logging a note after a call, or moving a deal forward without leaving Tana. What the AI can do with HubSpot: - **Contacts:** Search by name, email, company, or domain. Look up full details and the deals associated with a contact. Update lifecycle stage, lead status, and any contact property (job title, phone, custom properties). - **Companies:** Search by name or domain. Update lifecycle stage and any company property (industry, employee count, custom properties). - **Deals:** List recent deals sorted by last modified. Create a new deal and associate it with a contact or company. - **Notes:** Create a note and attach it to a contact, company, or deal, for example to log meeting takeaways straight into the CRM record. Property names follow your HubSpot configuration (HubSpot internal property names like `lifecyclestage` or `hs_lead_status`, with the values configured in your account). New to HubSpot in Tana? Follow the [setup guide](/learn/guides/connect-hubspot) for the connect flow, example prompts, and troubleshooting. ## Custom MCP servers Beyond the built-in integrations above, Tana can connect to your own remote [MCP](/learn/features/mcp) servers, so any tools they expose become available to AI chat. This is how you bring a service Tana does not integrate with directly, your own internal server or a third party's, into the AI. To add a server, go to Settings, Custom MCP servers: 1. Enter the server URL and authorize it over OAuth. On the desktop app, the authorization opens in your default browser so passkeys and password managers work. 2. If a server does not let Tana register itself automatically, the connect step says so, and you can add it with a Client ID and Secret instead. Each connected server is private to you; other members of your organization do not see it. Connecting a server adds a linked [skill](/learn/features/skills) for it. The server's tools enter a chat only when that skill is in scope, so a connected server does not add tools to every conversation. Manage the connection from the skill's panel: - **Tool catalog:** every tool the server exposes, with the server URL and when it was last synced. Use **Refresh tool catalog** to re-read the list after the server changes. - **Allow or deny each tool:** a per-tool control. A denied tool is never offered to the AI or called on your behalf, and it stays denied across a catalog refresh. Remove a server from the same settings page to disconnect it and drop its tools. This is the inverse of Tana's own [MCP server](/learn/features/mcp), which lets external AI tools connect into Tana. ## Coding tools Tana can hand off the current document or chat context to an external coding tool as a self-contained prompt. The hand-off is driven by the built-in **Open in coding tool** skill (see [Skills](/learn/features/skills)) and triggers on phrasings like "create a PR", "open a pull request", or "send this to Cursor". When more than one tool is enabled, the AI asks you to pick. When the repo or project is not named in the source material, the AI asks where the change should land instead of guessing. Available coding tools: - **Claude Code:** Anthropic's CLI coding agent, desktop app only. Configure one or more named projects (name and local folder path) in Settings, Coding Tools. The AI launches Claude Code in the chosen project folder, and the session URL appears as a clickable link in the chat. The web app shows a "Requires desktop app" note. - **Codex:** OpenAI's coding agent - **Cursor:** AI-first code editor - **GitHub Copilot:** GitHub's AI pair programmer (opens in VS Code) - **Lovable:** AI full-stack app builder - **v0:** Vercel's AI UI builder Enable or disable individual tools in Settings, Coding Tools. Each tool has a toggle to control whether the AI can use it. When a tool is used in chat, an "Open in [tool name]" button appears in the conversation. If the prompt is too long to fit in that tool's launch link, a note appears above the button with a **Copy full prompt** action that puts the complete prompt on your clipboard; the shortened link still works as a secondary action. --- #### Interface URL: https://tana.inc/learn/features/interface Tana's interface is built around a flat sidebar, a create menu, quick chat, search, and an activity feed. - Flat sidebar: [Today](#today), [Activity](#activity), [Tasks](#tasks), [People](#people), [Library](#library), and your spaces - Bottom section groups [Search](#search) and [Account](#account) - [Create menu](#create-menu): make meetings, docs, canvases, tasks, chats, types, skills, and custom types from anywhere - [Quick chat](#quick-chat): press Cmd+L to start an AI conversation instantly - [Search](#search) across Tana with filters for space, type, and editor - [Activity](#activity): a two-column dashboard of your notifications and recently updated items - Desktop app supports [tabs and split view](#desktop-features) for working with multiple documents ## The sidebar The sidebar is the main navigation in Tana. It sits on the left side of the screen as a flat list of destinations: Today, Activity, Tasks, People, Library, and your spaces. A bottom section groups Search and Account. There are no tabs. On wider screens the sidebar is always visible and can be resized by dragging its right edge. On narrower screens it appears as an overlay when opened. ### Today The [Today](/learn/features/today) view. Your starting point each day: a greeting that flips through the day, the events rolling from Now to Next up, Upcoming, and Past, and quick access to create, meet, or search. ### Activity Activity sits right below Today as a two-column dashboard: your **Notifications** on the left and **Recents**, a time-grouped list of recently updated items, on the right. The columns stack on narrow screens, and the sidebar entry carries a blue badge with your unread count. Notifications cover when someone: - **Adds you to a document or meeting** - **Assigns you a task** - **Starts a call** you are waiting on - **Sends you a chat message** - **Archives or restores a type** in your organization (the row carries the type title and a link to its panel) Each notification shows who triggered it, what it is about, and when it happened. Click it to navigate to the source, and unread ones show a blue dot. "Mark all read" in the Notifications header clears them, and a **"+"** in the toolbar opens the create menu. Both columns start collapsed and expand with a "View more" or "Show more" control. Recents carries the same filter bar used elsewhere in the Library (Space, the Meetings and Chats pills, Visibility, and the type palette). Narrow Recents to **Chats** and an **MCP** pill appears that scopes to chats started from an MCP client; it hides itself when none are in view. A recurring meeting series collapses to a single row, the occurrence closest to now, so the series keeps its place in the recency order without repeating. ### Tasks The global Tasks view: your tasks across every space, grouped by type and narrowed with filter pills (Assigned to, Created by, Type, Space) that live in the URL, so a filtered view is bookmarkable and Back and Forward step through it. It opens on what is assigned to you, and with no filter set it shows your most recent tasks. See [Tasks](/learn/features/tasks) for how the view works. ### People Your team, sorted by recent interaction. Shows: - **Constellations:** Groups of people you frequently interact with (3 to 5 people). Click to see everything you share with that group. - **Individual members:** Each person shows an online indicator (green dot when active). Click to see shared documents, or right-click for "Start Call." Drag a task onto a person to assign it to them. ### Library Open the Library to browse everything in Tana by kind. The home shows an ordered preview of each category, **Spaces · Meetings · Tasks · Types · Chats · Agents · People · Skills · Canvases · Docs**, each with a **See all** link to its own page. Empty categories hide themselves. A category page shows the category title, a **Library** breadcrumb to step back out, and an inline search field; section routes (Spaces, Chats, Agents, Skills, Canvases, Docs) also carry the shared **Created by** and **Visibility** filter pills, and Chats adds an **MCP** pill that narrows to chats started from an MCP client. The Types page adds a single-select space filter. The **Skills** section lists only the skills your organization has authored; Tana's built-in system skills are filtered out. Media, meaning images, audio, video, and uploaded files, does not appear in the Library, space browse, or Search; it still renders inside the chats and documents that embed it. Anything that does not live in a space or on a meeting lives in the Library, and its location pill shows which category it belongs to; a plain task points to the Tasks view. In the sidebar, each space can be expanded to show the types defined in it. Space home uses the same section index, scoped to that space. ### Spaces Your spaces appear directly in the sidebar below the Library so you can jump to any space home in one click. See [Spaces](/learn/features/spaces). ### Bottom section Search and Account live at the bottom of the sidebar, separated from the main destinations. Each opens the corresponding view or menu. ## Dark theme on Today and meetings Today and meeting routes render in the dark theme regardless of the rest of Tana, so events and calls stay legible and consistent. ## Create menu The create menu is accessible from the pencil icon in the sidebar toolbar, or from the "+" button on space home pages and dates in Today. It is a searchable palette with these options: - **Meeting**, **Doc**, **Canvas**, **Task**, **Chat**, **Type**, **Space**, **Skill** - **Custom types:** Any types you have defined, grouped by space When used from a space context, created items are scoped to that space and the Space option is hidden. Tasks open as inline cards rather than navigating away. Everything else navigates to the new document. ## Quick chat Press on the desktop app to open a quick chat window. Type a message, optionally add participants, and press enter. The chat is created and AI responds automatically. Press to open quick chat with voice dictation active. Your speech is transcribed directly into the message input. Quick chat is the fastest way to ask the AI anything without leaving what you are working on. ## Search Open search from the **Search** entry in the sidebar, or with from anywhere, including while editing a document. It opens as a popover hosting the same browse interface: a search field for full-text search across Tana, the filter bar, and, when you have not typed a query or set a filter, the per-section index. On iPad and other touch devices it opens as a bottom sheet that stays clear of the on-screen keyboard. The Library and Search share one filter bar of round pills: - **Space:** show items from a specific space (Search only) - **Meetings** and **Chats:** quick pills that narrow to those kinds - **Created by:** a people picker, with you pinned to the top as "(you)" and an "Anyone" option to clear it - **Visibility:** narrow by who can see an item, Any, Private to me, Shared with me, Restricted, Open, or Anyone with the link for items shared by link - **More (⋯):** a type palette for any other kind, including the types you have defined Without a query, the filters act as a browse mode. Recent items appear under "Recently Updated". Narrow to **Meetings** only and the view becomes a dedicated meetings table (title, the space it lives in, time, attendees, and a lock for private ones), sorted with the most recent first. Two sub-filters appear next to the Meetings pill: a time window (Upcoming, Today, or Past, with Today in your local zone) and Attendees, a multi-select people picker that shows meetings including everyone you pick. The Chats pill, Created by, and the type palette hide while meetings-only is active. ## Panel title chip As you scroll down any panel, a doc, canvas, chat, skill, agent, meeting, space home, and the rest, a compact title chip appears in the toolbar showing the item's avatar or thumbnail and its entity-type badge. Click the chip to scroll back to the top. ## Settings Open settings with or from the account menu in the sidebar footer. Settings sections include: - **Profile:** Your name and account details - **Usage:** Your AI spend against the monthly cap and rolling two-hour cap, shown as percentage progress bars with relative reset captions ("Resets in 3 days"). No dollar amounts. In environments where usage caps are not enforced, a gray info callout above the bars notes the bars are informational. - **Calendars:** Connect Google Calendar or Outlook - **Integrations:** Connect GitHub, Slack, Linear, Jira, HubSpot - **MCP:** Configure AI assistants to connect to Tana - **Coding tools:** Choose which coding tools are available to AI chat - **Preferences:** The **Call Sounds** toggle that gates the join, leave, raise-hand, and chat tones in [meetings](/learn/features/meetings#chat-in-the-call), and a **Tana links** row with a **Reset** for your saved [open-in-desktop choice](#desktop-features). - **Advanced:** Developer tools: Sketch Mode, Loro Debug, Live Query Debug, and Export Database. - **Organization:** Name, default content language, and other org-wide settings - **Members:** Invite and manage team members (admin only) The account menu also lets you switch between organizations, view pending invitations, leave an organization, and sign out. ## Desktop features The desktop app adds features not available in the browser: - **Tabs:** Open multiple documents in separate tabs within one window - **Split view:** Work with two documents side by side. Use on any link to open it in the split pane. - **New window:** Use on a link to open it in a new window. - **Toggle sidebar:** Use to show or hide the sidebar (also under View ▸ Toggle Sidebar). The same shortcut works on iPad with a hardware keyboard. In the browser it stays the page's "Save" shortcut. - **Open in Tana:** When you open an org-scoped Tana link in a browser and have the desktop app installed, Tana offers to open it in the app, with **Open always**, **Open once**, or **Continue in browser**. Your choice is remembered; reset it from the **Tana links** row in Settings, Preferences. Meeting links are excluded so guests can still join calls in the browser. - **Meeting detection:** The desktop app can detect active Zoom, Teams, and Meet calls for [external meeting capture](/learn/features/meetings#capture-an-external-call). ## Sync Tana syncs in real time across all your devices. The sidebar footer shows sync status. A cloud-off icon appears if authentication has expired and you need to sign in again. If a connected calendar silently stops syncing, an amber **!** indicator with the tooltip "Calendar needs reconnect" appears next to the sync status in the user account row; reconnect from [Calendar settings](/learn/features/integrations#calendar-sync) to clear it. --- #### Keyboard shortcuts URL: https://tana.inc/learn/features/keyboard-shortcuts Every shortcut in Tana, including keyboard shortcuts and text input shortcuts. Organized by feature area, with the correct keys for your operating system. ## Meetings ## Chat ## Editing ## Formatting ## Navigation --- #### MCP URL: https://tana.inc/learn/features/mcp Tana provides a Model Context Protocol (MCP) server so external AI tools can read and write your content in Tana. - [MCP server](#mcp-server) lets external AI tools read and write your content in Tana - One-line setup for [Claude Code](#claude-code), connector setup for [Claude Desktop](#claude-desktop), and [any MCP client](#other-mcp-clients) over OAuth - [Tools](#available-tools) cover search, read, create, update, delete, schema, and skills - [Writes create proposals](#how-writes-work) that you review and approve, just like the built-in AI - The server preloads [your identity and space members](#preloaded-context) so agents can act on your behalf - Going the other way? [Connect your own MCP servers](/learn/features/integrations#custom-mcp-servers) so their tools work in Tana's chat ## MCP server Tana provides a Model Context Protocol (MCP) server that lets external AI tools connect to Tana. From a client like Claude Code or Claude Desktop, an agent can read documents, search content, create and update items, and use the same capabilities available in Tana's built-in [chat](/learn/features/chat). The server lives at `https://home.tana.inc/mcp`, and authentication is handled automatically over OAuth. Settings, MCP has a one-click copy for the URL and ready-made configuration snippets. MCP works in both directions. This page covers Tana **as a server**, external AI tools reaching into Tana. For the reverse, connecting Tana to **your own** MCP servers so their tools become available in [chat](/learn/features/chat), see [Custom MCP servers](/learn/features/integrations#custom-mcp-servers) in [Integrations](/learn/features/integrations). ## Claude Code Add Tana to [Claude Code](/integrations/claude) with a single command: ``` claude mcp add tana --transport http https://home.tana.inc/mcp ``` The command and URL are available for one-click copy in Settings, MCP. ## Claude Desktop [Claude Desktop](/integrations/claude) connects to Tana through Anthropic's **connectors** flow. From the Settings, MCP page in Tana, follow the link to Anthropic's "Use connectors to extend Claude's capabilities" guide and add Tana with the MCP Server URL shown on the page. ## Other MCP clients Any MCP client that supports HTTP transport and OAuth can connect to `https://home.tana.inc/mcp`. Point the client at that URL and it goes through the same authentication flow as Claude Code and Claude Desktop. External clients can also point directly at a calendar event URL and pull the full meeting context in a single `readEvent` call: participants, attendees, transcript references, screen-share screenshots, and the `relatedDocs` index of attached artifacts and chats. The bundled `tana-cli` and the URI validator accept the broader set of doc kinds (event, call, transcript, screen-share, artifact, asset, audio, video, canvas, agent, workflow, calendar-subscription) and the `/o/:org/e/:event` and `/o/:org/c/:chat` URL shapes, so you can pass a URL straight from the browser. ## Available tools The server exposes much of the same toolset the built-in AI uses, so an external agent can do many of the same things Tana's own assistant can. Tools are grouped by purpose: **Read** | Tool | Description | | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `searchItems` | Full-text search across Tana. Wildcard listings (`queries: ["*"]`) sort results newest-first | | `semanticSearchItems` | Meaning-based search that finds conceptually related content | | `readItems` | Fetch the full content, fields, and block structure of specific documents. Distinguishes "kind I do not read" from "URI does not resolve" | | `getItemInfo` | Read an item's metadata and status by URI (access, owner, timestamps, proposal state, external IDs) without loading its body content | | `listEdges` | Find relationships between documents in the knowledge graph | | `readTable` | Read tabular data with cell block IDs for precise edits | | `getTypes` | Inspect type definitions and fields so the agent knows the shape of your data | | `readSkill` | Read the definition of a [skill](/learn/features/skills) | | `contextRetrieval` | Gather the relevant context for a natural-language question, the way built-in chat does | | `readEvent` | Read a calendar event with its participants, attendees, and a `relatedDocs` index of every artifact, event chat, and screen-share image attached to the meeting | | `readFullTranscript` | Read the transcript of a meeting recording | | `readScreenShareScreenshots` | List and read the screenshots Tana captured during a meeting's screen shares | | `listEvents` | List calendar events | | `listCalendars` | List the user's connected calendars | **Write** | Tool | Description | | ------------------------ | ----------------------------------------------------------------------------------------- | | `createItems` | Create new documents | | `updateItems` | Edit existing documents | | `deleteItems` | Remove documents | | `moveDocuments` | Reparent documents in the graph | | `rename` | Rename a document, with the change going through the proposal review like any other write | | `manipulateTable` | Insert and update rows, columns, and cells in tables | | `createArtifact` | Produce structured artifacts like summaries and notes | | `updateArtifact` | Edit an existing artifact | | `updateEvent` | Edit a calendar event | | `generateImageDocuments` | Create image documents from prompts | | `manageTypes` | Create and change types and their fields | | `manageSpace` | Create or modify [spaces](/learn/features/spaces) | | `manageAccess` | Change access control for an item, the agent equivalent of the share menu | | `createSkill` | Author a new [skill](/learn/features/skills) | | `createAgent` | Create a new agent document, with its skills and capabilities | **Proposal review** | Tool | Description | | ------------------ | ------------------------------------------- | | `listProposals` | List pending proposals from a write session | | `approveProposals` | Apply pending proposals | | `rejectProposals` | Discard pending proposals | The exact list and schemas are always available from the server itself via the standard MCP `tools/list` call. ## How writes work Write tools do not change your graph directly. They create [proposals](/learn/features/proposals) attached to a session, and you review them the same way you review changes from built-in chat. This keeps you in control when an external agent is doing real work on your graph. The typical flow is: 1. The agent calls a write tool. The server returns a `sessionUri` and the proposed changes go into that session as pending proposals. 2. You open the session in Tana and review, edit, or discard the proposals. The chat opens with a short recap from the agent of what it did and why, so you have the context to continue from rather than a bare set of tiles. 3. The agent can call `listProposals`, `approveProposals`, or `rejectProposals` if you have told it to, but it should not auto-approve on your behalf. If you have already authorized a write out of band, for example through an explicit instruction to the agent or a CLI flag, the agent can pass `autoApprove: true` on the write call. The server then applies the proposals in the same round-trip instead of leaving them pending. ## Preloaded context When a client connects, the server sends instructions that include your identity and the members of your space. This means an agent can resolve "me", "I", and "my" to the right user URI and assign tasks or reference people by name without an extra lookup. ## Custom MCP servers MCP also runs the other way: Tana can connect to your own remote MCP servers so their tools are available to its [AI chat](/learn/features/chat), much like the built-in integrations. You set these up in Settings under Custom MCP servers, authorizing each server over OAuth and choosing which of its tools the AI may use. See [Custom MCP servers](/learn/features/integrations#custom-mcp-servers) in Integrations for the full setup. ## Spotting MCP chats A chat session that an MCP client starts shows an "MCP:" prefix on its auto-generated title in your chat list, so it is easy to spot among your other chats. --- #### Meetings URL: https://tana.inc/learn/features/meetings Tana meetings combine video calls, real-time transcription, and AI-powered outcome extraction in one place. - Built-in video calling, real-time [transcription](#transcription), and [screen capture](#screen-capture) - [Capture](#during-the-call) the conversation during the call as typed items, artifacts, and skills, or make a blank doc, canvas, or task - [Present](#presenting) a document, canvas, or your screen on the shared stage, with guests following along - [Capture external calls](#capture-an-external-call) from Zoom, Teams, or Meet without moving the call - AI auto-processes meetings when the call ends: summary, action items, and [artifacts](/learn/features/artifacts) - All AI-generated changes go through [proposals](/learn/features/proposals) you review before they are applied - [Guest access](#inviting-people) via link, no Tana account required ## Setting up a meeting ### Calendar sync Connect Google Calendar or Outlook from Settings to see your events in your [Today](/learn/features/today) view. See [Integrations](/learn/features/integrations) for setup details. Synced events appear with their original title, time, attendees, and meeting link. You can add talking points, start a chat, and extract outcomes from synced events the same way as Tana-created ones. Sync runs both ways. Events you create and manage in Tana appear in your connected calendar shortly after, and edits to their title or time, and deleting them, propagate back to Google or Outlook. New connections write Tana events to your primary calendar automatically. If you connected a calendar earlier, open Settings, Calendars and choose which calendar to write to (the default write target) to turn it on. ### Creating a meeting Select "Meeting" from the create menu (the pencil icon in the sidebar). This creates a new event with a Tana video call link. The meeting defaults to the current time (rounded to the nearest 5 minutes) with a 30-minute duration. If you create from a specific date in Today, it defaults to 9:00 AM on that date. You can change the date, time, and duration from the event view. ### Inviting people Open the event's details to add people. Add teammates by name, or type any email address to invite someone outside your organization. Because a meeting's attendees sync out to your connected calendar, everyone you add gets a real calendar invite in their inbox. Added participants can see the event, join the call, and access talking points and outcomes. The details panel shows attendees as an avatar stack with controls to add or remove people; only the organizer can change the invite list, and your own avatar sorts first. You can also share the guest link from the pre-call screen for quick access without an invite. Guests join with a display name and do not need a Tana account. If a guest opens the link before anyone from your team has joined, they wait in a lobby and are let into the meeting automatically as soon as a Tana user starts the call. Once in the meeting, guests see a resizable three-column layout that mirrors the host: meeting on the left, the live **Meeting Digest** in the middle (read-only, no pause control), and a surface column on the right that shows public documents pinned to the event and approved meeting outcomes. Cards carry the same coloured type badge that the host sees (Bug, Task, Idea, and any other type), plus thumbnails for artifacts. Clicking a card opens the doc in the public viewer. The surface column stays hidden until there is something to show. If you are signed in to a different organization and click a meeting link for one you are not a member of, Tana asks whether you want to join as a guest, with the option to go back to your own org instead. ### Talking points Click "Add talking points" on the event to prepare an agenda using the rich text editor. Other participants see the agenda appear in real time. During the call, talking points are accessible as a side panel. After the call, they become read-only on the event. ## The call ### Joining When you open a meeting with a Tana call link, a pre-call Get Ready screen appears with a camera preview, audio and video toggles, and device settings (camera, microphone, speaker, background blur). The preview is marked with a "Preview" badge so it is clear you have not joined yet. If you do not have a working camera, the preview area shows "No camera detected" instead. Click "Join Meeting" to enter. From Today, you can also click "Join" directly on an event card when participants are already in the call. If the call already has five or more people when you join, your microphone starts muted so you do not interrupt; unmute when you are ready. If you have already been in the call once, a **Re-Join** button appears in the meeting toolbar that takes you straight back in without going through Get Ready again. When someone is waiting for you in a call, Tana notifies you outside the app and takes you to the meeting when you click it: a system notification on the desktop app, and a browser notification on the web. In a browser the first one asks for permission, and you can manage it from the Notifications row in Settings under Preferences. ### Controls The meeting toolbar at the bottom of the screen has the standard call controls and the actions you use during a meeting: - **Mute** (): toggle microphone - **Video** (): toggle camera - **Raise hand** (): automatically lowers when you start talking - **Reactions** (): open the reactions popover for the six defaults, the full picker, and search. See [Reactions popover](#reactions-popover) below for keyboard shortcuts. - **Settings:** camera, microphone, speaker, background blur, noise cancellation - **Capture:** turn the conversation into typed items, artifacts, and skills. See [During the call](#during-the-call). - **Present:** put a document, canvas, or your screen on the shared stage for everyone to follow. See [Presenting](#presenting). - **Your Meeting Agent:** opens your private AI side chat for this meeting. See [Chat in the call](#chat-in-the-call). - **More:** an overflow menu with Copy link and Delete - **Leave** (): end the call for yourself The same toolbar design is used across the get-ready screen, the guest lobby, and the live call. A muted microphone or camera shows a gray slash rather than a red highlight. On phones, the toolbar is laid out for smaller screens so the controls stay within reach. The meeting uses a two-column layout with a presenter stage: whoever is speaking or sharing takes the main area, and other participants appear alongside. Camera feeds (or avatars) show names and indicators for speaking and hand raise. Side panels during the call give you access to talking points, outcomes, and shared context with other participants. If your connection drops, Tana automatically attempts to reconnect. You can switch between meetings without dropping the call: jumping to another meeting keeps you connected through the transition. ### Reactions popover The Reactions button in the toolbar opens a popover with the six default reactions, a "+" to open the full emoji picker, and a search. Once the popover is open: - sends one of the six default quick reactions - opens the full picker - Classic emoticons send the matching reaction without leaving the keyboard: `:)`, `:(`, `:D`, `:P`, `:O`, `:/`, `:|`, `:*` The popover stays open between presses so you can stream reactions in a row. Lowercase variants (`:d`, `:p`, `:o`) fall through to search instead of firing a reaction. ### Minimized overlay Navigate away from a meeting and the call collapses into a small overlay at the edge of the screen. It shows up to four participant tiles: one fills the overlay, two sit side by side, three or four form a 2×2 grid, and any others collapse into a "+N" count. The tiles prioritize whoever is speaking, anyone with a raised hand, and the active presenter, with screen-shares and camera-off avatars shown first. Click any tile to return to the full meeting view. A chevron toggle flips the overlay between the left and right edges, and the side you choose is remembered. ### Voice agent Tana's **voice agent** is a hands-free conversation partner that joins a meeting as a voice participant. It is available in any internal call: solo meetings as well as multi-participant ones. Start it by saying **"Hey Tana"** or **"Hi Tana"** (with localised equivalents in Norwegian, Swedish, French, Spanish, German, Italian, Portuguese, and Dutch). Say **"Bye Tana"** or **"Goodbye Tana"** to stop it. While the agent is reasoning between your input and its first audio reply, a subtle progress sound plays so the gap does not feel dead; the sound is tied to the **Call Sounds** toggle in Settings, Preferences. How to start it depends on the meeting shape: - **Solo internal meetings:** a 1×1 voice control tile appears in the meeting grid alongside the other participant tiles. Clicking it starts the agent. - **Multi-participant meetings:** the start action lives in the meeting overflow menu as **Add voice agent** so it does not crowd the toolbar. - **External-meeting captures:** the voice tile is hidden so the external-capture widget owns the slot. When a Tana user activates the voice agent in a meeting with guests, the guests see the agent's tile and hear its audio. Guests get the same auto-mute toast and manual-unmute override that other participants get. Guests cannot activate the agent themselves. In a meeting with several people, the voice agent only reads content that everyone present can access, so a private document one person can see is never read aloud to the room. Your voice agent is remembered if you stop it, leave, or reload the page, so it does not reset mid-meeting. The welcome meeting at the end of onboarding starts the voice agent automatically so you can speak with Tana right away. Subsequent visits do not re-trigger. ### Chat in the call A meeting has two separate chat surfaces: - **Your Meeting Agent:** A private chat for you and the AI, opened from the **Your Meeting Agent** button in the meeting toolbar. Only you see it, and the AI responds to every message. Use it to ask questions about the discussion, pull up context from Tana, or have the AI create documents without interrupting the room. The button shows when the AI is replying and surfaces an unread indicator if you have closed the popover, so you can leave it minimized and come back to it. The chat persists across reloads and stays with the meeting. - **Chat With Everyone:** A shared chat visible to all attendees, opened from the chat button in the call toolbar. New messages surface as toasts and an unread badge for anyone who does not have it open; clicking a toast opens the chat anchored to that button. A short ding plays for incoming messages when the chat is closed; you can turn this off with the **Call Sounds** toggle in Settings, Preferences. The AI stays quiet by default. Mention @Tana when you want a response, so the human conversation is not interrupted. The chat is attached to the event and remains available after the call ends. When a guest is in the meeting, AI is turned off in this shared chat: @Tana, agent and skill mentions, the `/` command, and the Skill button are all removed, and a callout explains the pause. This keeps your organization's data out of a chat a guest can read. AI stays off for the rest of the meeting even after the guest leaves. Guests can still send and read plain-text messages; mentions, links, attachments, and dictation are member-only and not available in the guest composer. Your private Your Meeting Agent is unaffected. Both use the same composer as [AI chat](/learn/features/chat), so you can reference documents with @, invoke [skills](/learn/features/skills) with /, attach files, and dictate by voice. ### Screen sharing Any participant can share their screen, including guests. The shared screen takes the main view while participant videos move to a smaller strip. Multiple participants can share at the same time. You start a share from the **Present** button in the toolbar; guests have a dedicated screen-share button. Screen sharing is available on desktop and web. On devices that cannot share a screen, such as iOS, the button is hidden. Guests' shared screens are captured into the meeting's screen captures alongside everyone else's, so they appear in the transcript's screen captures, the digest, and the post-meeting summary. If one of a guest's screenshots fails to upload, the guest sees a notice. ### Presenting Put a document or canvas at the center of the meeting for everyone to follow, without screen sharing. Open **Present** in the toolbar to bring up a palette of everything you can put on stage: - **Screen or Window:** share your screen (see [Screen sharing](#screen-sharing)). - **New:** create a blank doc or canvas, pinned to the meeting and presented right away, for live notes or a whiteboard. - **Pinned**, **Outcomes**, and **Recents:** the meeting's pinned docs, docs created in this meeting, and your recently edited docs, narrowed to the types that can be presented (text and canvas). Type to search across everything else. Picking a document pins it to the meeting and starts presenting. You edit the title and body live while everyone else follows read-only, seeing your caret in a document, or your cursor, viewport, and selections on a canvas. Followers auto-scroll to stay with you (canvases camera-follow your viewport); scroll or pan away and a **Follow** control appears to snap back. Guests in the meeting can be given access to the presented document in one click, so an external attendee follows the same live document. Anyone who joins while you are presenting sees what is on stage. To stop, open **Present** again and choose **Stop presenting**, which also ends a screen share. The **Present** button stays highlighted while you present. ### Transcription Tana transcribes conversations in real time. Each participant's audio is transcribed separately, so the transcript includes speaker identification and timestamps. Transcription follows your organization's language setting, while still automatically detecting and transcribing other languages spoken in the call. The transcription indicator in the call toolbar shows the live transcript in a scrollable popover. From there you can: - **Copy** the transcript text - **Edit** the transcript: select a segment to delete it, delete everything after a point, or wipe the entire transcript - **View screen captures** taken during screen sharing ### Screen capture When someone shares their screen, Tana automatically captures screenshots at regular intervals. Duplicate frames are filtered out so only visually distinct content is saved, and each unique screenshot gets an AI-generated description. Screen captures are available to AI when extracting outcomes, so the AI can reference what was shown on screen alongside what was said. ### Off the record Tana transcribes and captures screen content by default during calls. To pause everything, toggle off-the-record mode from the transcription indicator in the call toolbar. This stops transcription, screen-share capture, and external-meeting capture at once, so nothing about the conversation is recorded. An "Off the record" indicator appears for all participants so everyone knows recording has stopped. Toggle it again to resume. Use this for sensitive discussions, personal topics, or any part of the conversation you do not want captured. ## Outcomes Outcomes are the docs, tasks, typed items, and artifacts that come out of a meeting. Tana lets you capture outcomes while the conversation is happening, and automatically processes the full meeting when the call ends. ### During the call The meeting toolbar's middle controls are **Capture** and **Present**; see [Controls](#controls). **Capture** turns the conversation into outcomes. It opens with a single lookback-window picker, how far back to read: the last minute, last 2 minutes (the default), last 10 minutes, or the entire meeting. From that span, pick what to make: - **Auto** or a specific **type:** "Auto" captures whatever the discussion points to, or pick a type chip (Task, Bug, Decision, and any custom type) and AI creates a structured, typed document from that part of the conversation. When Tana already knows the concept being captured, the in-progress tile uses its title (for example "Capturing iOS scroll bug...") instead of a generic "Capturing..." label. If you later elaborate on a captured item, the proposal updates in place without showing a new card. - **Artifacts:** generate a [rich artifact](/learn/features/artifacts) like a storyboard or slides from the conversation. - **Skills:** run the built-in **Screen share recap** or **Code prompt** skill, or any of your own [skills](/learn/features/skills). A pinned skill becomes a single tile that reshapes with the skill's lifecycle: while it runs the tile shows the skill name and a live progress indicator, and once it has produced proposals the same tile expands into a group stack of those proposals. Click either state to open the full conversation, and use the More or right-click menu for Open chat and Unpin from event. Captured results are shared with the meeting participants by default; the popover footer shows who the result will be visible to before you capture. You can also capture a specific stretch of the conversation: hover a row in the live **Meeting Digest** and use **Capture as…** to open the same picker scoped to that segment's transcript span, or its **⋯** menu to **Copy transcript segment** (the section's transcript, grouped by speaker). To add material yourself, use the **Pinned** section on the meeting surface: create a blank **Doc**, **Canvas**, or **Task**, or search Tana to pin an existing document. Creating a doc or canvas from **Present** also pins it to the meeting and puts it on stage. See [Presenting](#presenting). A **Summary** tile also appears in the right column when the call has wrapped up, so you can generate the post-meeting summary with one click. When anyone starts a capture, a tile shows up for all participants (for example, "Alice is capturing Action Item") so the room knows what's being pulled out of the conversation. If a capture fails, the error surfaces so you know it did not succeed. Pinned imagery, including screen captures and artifact scenes, opens in a full-screen viewer with copy, download, and arrow-key navigation. On the meeting surface, a tile shows a state control inline and an assignee control in the corner for any item that carries a task or workflow state, plain tasks as well as typed items like a Bug, so you can move it to In Progress or hand it to a teammate without opening it. A plain document shows its kind (Canvas, Doc, Meeting), and a typed item keeps its type badge. The meeting also has its own chat surfaces. See [Chat in the call](#chat-in-the-call) for how AI responds in the private Your Meeting Agent and the shared Chat With Everyone. When Your Meeting Agent creates new docs in the meeting, each one gets a **Pin to meeting** action so you can attach it to the event for everyone else to see. ### After the call Once everyone has left the call, Tana automatically generates a tagline and summary for the event, selects representative screenshots from screen shares, extracts action items and decisions as typed items, and creates structured meeting notes. This runs on its own; you do not need to click anything to start it. When the conversation clearly points a task at a specific teammate, extraction assigns it to that person, and to several people when it was handed to more than one. If who owns it is ambiguous, the task is left unassigned rather than guessed. If you pinned a document to the meeting, such as a Product Track or an open issue, extraction treats it as the main subject of the meeting and prefers updating that document over creating a parallel one. Every call also produces one canonical **summary document**: an AI-written tagline and short summary, a participants byline, a wide illustration whose scene is drawn from the conversation, and sections for Key Takeaways, Topics Discussed, and Next Steps. After the call, the meeting's middle column becomes a **Summary** panel with a **Summary** and **Timeline** toggle, switching between the summary and the topic-by-topic transcript, plus **Share** and **Edit** buttons. If anything went wrong while it was being written, Tana retries so the summary always lands. You can re-trigger any of these manually from the outcomes section at any time. Re-running extraction updates existing outcomes rather than creating duplicates. ### Review and use On the meeting surface, captures are grouped into **Outcomes** and a **For Review** list: AI-generated items wait under For Review as [proposals](/learn/features/proposals) until you accept them, and accepted items move to Outcomes. Once accepted, outcomes are regular documents in the same space as the meeting. You can edit them, assign types, add fields, and work with them like any other document. Each outcome can be shared with specific people or spaces, making it easy to distribute results to people who were not in the call. ## External meetings You do not need to move your calls to Tana to get transcription and outcomes. There are two ways to work with meetings happening in other tools. ### Capture an external call The Tana desktop app can capture meetings happening in Zoom, Teams, or Meet without moving the call itself. This is useful when other participants are not on Tana or when you cannot change the meeting link. This detection-based flow is now the legacy capture path: system-audio capture (below) is the default, and these steps only apply after you turn on **Use legacy meeting capture** in Settings, Preferences. 1. **Enable meeting detection** in the desktop app. This requires screen recording and microphone permissions on macOS. 2. When Tana detects an active call, a notification appears: "Meeting detected." 3. Click **Capture** on the calendar event, or use the ad-hoc capture button if the meeting is not on your calendar. 4. Go back to the external tool to participate normally. 5. Tana captures the audio for transcription and takes screenshots of shared screen content in the background. 6. When the call ends (or you click "End capture"), Tana processes the meeting and generates outcomes. The desktop app identifies speakers and correlates them with the transcript. If the meeting is not already on your calendar, Tana creates a matching event. **Auto wrap-up:** External captures also get the same periodic mid-meeting wrap-ups and section refreshes that in-app calls get, on top of the post-recording wrap-up. The event picks up a tagline, a summary, and outcome proposals without you needing to open it. **One capture at a time:** On the desktop app, an external meeting capture and an in-app Tana call cannot run at the same time. Trying to join a Tana call while a capture is recording shows a toast asking you to stop the capture first. Starting a capture while you are already in a Tana call is blocked the same way. ### Capture with system audio (opt-in) On the desktop app, Tana captures external meetings through your computer's own audio. Because it captures the audio your machine plays, it works across any meeting platform rather than a fixed set, and it is designed to be lighter on your machine and more reliable. A small always-on-top window opens a couple of minutes before a scheduled meeting so you can start recording in one click, with pause and stop controls right in the window. You can also start a capture from the Today toolbar for a meeting that is not on your calendar. If someone else in your organization is already capturing the same meeting, everyone else sees it so it is not recorded twice. This is the default capture mode on the desktop app on macOS or Windows, on the latest version. It does not yet detect ad-hoc meetings automatically or take screenshots. If you need the previous detection-based capture, turn on **Use legacy meeting capture** in Settings, Preferences. ### Move to Tana For meetings synced from an external calendar, the event organizer can replace the external video conference link with a Tana call. Click "Move to Tana" on the event. All attendees are notified of the change. **Capture** keeps the call in the external tool and records from the side. Use this when you cannot change the meeting link. **Move to Tana** replaces the link so everyone joins in Tana. Use this when you want the full experience including live outcome capture during the call. --- #### Proposals URL: https://tana.inc/learn/features/proposals AI in Tana never changes your content without approval. - AI never changes anything without approval. Every change is a proposal you review first - [Three types](#proposal-types): create, update, and delete - [Review individually](#reviewing-proposals) with a diff view, or [accept all](#accept-all) at once - [Iterate with AI](#iterating-with-ai) to refine a proposal before accepting - Meeting [outcomes](/learn/features/meetings#outcomes) use the same proposal system - [Version history](#version-history) tracks all changes to documents over time ## Proposal types Every proposal is one of three operations, matching what AI can do to your content: - **Create** (labeled "To be created"): A new document the AI wants to add to Tana. Accept with **Keep**. - **Update** (labeled "To be updated"): Changes to an existing document, shown as a diff against the original. Accept with **Update**. - **Delete** (labeled "To be deleted"): A document the AI wants to remove, shown with a preview of what will be deleted. Accept with **Delete**. Proposals come from [chat](/learn/features/chat), [meetings](/learn/features/meetings), [skills](/learn/features/skills), and any other place AI acts in Tana. Access changes proposed by the AI (restricting a doc to specific participants, opening it back up, or toggling the Guest Link) follow the same flow. The proposal preview shows an access callout with visibility (Participants only, Open, or inherited) and per-participant role changes so the consequences are clear before you accept. ## Reviewing proposals ### Pending proposals When AI generates changes, proposals appear as inline cards on the message that produced them, so you can see what the AI did and decide on it in place. While AI is still thinking, a "Refining proposals" indicator shows progress. Proposals are grouped on the card by operation (deletes first, then updates, then creates) and by document type within each group. ### Accepting and discarding For each proposal: - **Accept** applies the change to Tana - **Discard** rejects the proposal without applying it Click any proposal to open the detail view with the full content of the proposed change. Proposals are editable while pending, so you can modify content directly before accepting. The detail view has previous and next chevrons to step through everything pending, and discarding one advances you to the next, so you can work through a stack without closing and reopening. The view closes once nothing is left to review. If a change can't be applied in full, a colour-coded callout appears above the accept and discard controls explaining what happened: a change that was blocked, one that applied with some parts dropped (for example an access change that could not include a Guest Link for that kind of item), one that has gone stale and should be discarded, or one that hit a temporary problem and will retry. If a proposal was made by a newer version of Tana than the one you are running, the card shows a callout asking you to reload, with a **Reload** button, in place of the Accept and Discard controls. [Accept all](#accept-all) shows the same callout where it reaches one of these proposals. For updates, three view modes are available: - **Diff:** Side-by-side comparison of original and proposed (default) - **Proposal:** The proposed version only - **Original:** The original version only ### Accept all Click **Accept All** to apply all pending proposals at once. If the batch includes space deletions, a confirmation dialog warns that deleting a space removes all its documents permanently. After acceptance, a confirmation message appears in the chat showing how many changes were accepted and listing the affected documents. ### Iterating with AI When reviewing a proposal from a meeting or outcome, you can chat with AI to refine it before accepting. The detail view opens with a split layout: the proposal on one side, an iteration chat on the other. Describe what you want changed and the AI updates the proposal in place. In meetings, refinements update the same proposal silently, so no new "Capturing..." card flashes back to the top of the meeting. Each iteration creates a new version. Use the version dropdown to compare versions ("Version 1", "Version 2 (Latest)") and accept the one you prefer. ## Outcomes In the context of [meetings](/learn/features/meetings) and background AI processing, proposals are called **outcomes**. The outcomes panel shows: - **Pending outcomes:** Proposals waiting for your review - **Accepted outcomes:** Documents created or updated, grouped by type - **Progress:** Active AI processing with a status indicator showing what it is doing (searching, reading, creating) Each accepted outcome has a **Share** button for managing access independently from the meeting or chat. See [Sharing outcomes](/learn/features/spaces#sharing-outcomes). ## Automatic approval Some AI actions skip manual review. During meetings, periodic wrap-ups (tagline, summary, screenshot selection) are auto-approved so the event stays up to date in real time. Document creates from background processing may also auto-approve. Updates, deletes, and space changes always require your approval, regardless of context. ## Version history The changes panel on any document shows a chronological history of edits. Each entry shows what changed, who made the change, and when. Click an entry to see details. Changes are grouped by time and can be expanded to see individual edits. Change types are labeled as Created, Updated, or Deleted with color-coded indicators. Version history is read-only. It does not currently support reverting to a previous version. --- #### Skills URL: https://tana.inc/learn/features/skills Skills are reusable AI instructions you create once and use everywhere. - Reusable AI instructions you write once and use everywhere: [chat](/learn/features/chat), [meetings](/learn/features/meetings), and [typed items](#skills-on-types) - [System skills](#system-skills) are built-in for common tasks like creating GitHub issues - Invoke with [/skills in chat](#invoking-skills), from the [Send to menu](#skills-on-types) on typed items, or from [meeting outcomes](/learn/features/meetings#outcomes) - Write instructions in a rich text editor with full formatting support ## What skills do A skill is a set of AI instructions packaged for reuse. Instead of typing the same prompt every time you want the AI to do something specific, you write the instructions once as a skill and invoke it whenever you need it. Skills are how you customize what the AI does for your team. A product team might create skills for "Write a PRD from meeting notes" or "Create a GitHub issue from this bug." A consulting team might create "Generate a client summary" or "Draft a follow-up email." ## Creating a skill The usual way to make a skill is to ask the AI: describe what it should do, or tell Tana to save something it just did as a skill, and it writes the skill for you. You can also create one by hand by selecting "Skill" from the [create menu](/learn/features/interface#create-menu), and you can open and edit any skill the same way no matter how it was made. However it is created, a skill has three parts: - **Title:** The name that appears in search results and the Send to menu - **Description:** When and why to use this skill. Helps the AI decide whether to use it and helps teammates understand its purpose. - **Body:** The full instructions, written in a rich text editor with formatting support. This is the prompt the AI follows when the skill is invoked. Skills live in [spaces](/learn/features/spaces) and are accessible from that space's context. ## Invoking skills Skills can be invoked from several places: - **Chat:** Type `/` in the [chat](/learn/features/chat) input to search and attach a skill. The AI follows the skill's instructions when responding. - **Send to menu:** Skills attached to a [type](/learn/features/types) appear in the Send to menu on every document with that type. Pick one to run the skill on that document. - **In a meeting:** Open the **"+"** menu in the meeting toolbar and pick a skill under "Rich artifacts and skills" to run it with the meeting transcript and context. See [meeting outcomes](/learn/features/meetings#outcomes). - **@mention:** Type `@` in chat and select a skill to attach it. ## Skills on types When you configure a [type](/learn/features/types), you can attach skills that appear in the [Send to](/learn/features/docs#send-to) menu on every document of that type. This is the most powerful pattern for skills: the skill is always right where you need it. For example, attach a "Create GitHub issue" skill to a Bug type. Every bug document can file one from its Send to menu, and it links to the GitHub issue once created. ## System skills System skills are built-in and read-only. They handle common tasks like creating GitHub issues, creating Linear issues, extracting meeting outcomes, summarizing meetings, generating PRDs and product feedback, and handing off context to coding tools. System skills show a "System Skill" badge and cannot be edited. The **Open in coding tool** system skill packages the current document or chat context as a self-contained prompt and hands it off to Claude Code, Cursor, Codex, GitHub Copilot, Lovable, or v0. It is triggered by phrasings like "create a PR", "open a pull request", or "send this to Cursor". When more than one coding tool is enabled, the skill asks you to pick. When the repo or project is not named in the source material, the skill asks where the change should land instead of guessing. See [Integrations, Coding tools](/learn/features/integrations#coding-tools). You can use system skills as-is or create your own skills that build on the same patterns. --- #### Spaces and sharing URL: https://tana.inc/learn/features/spaces Spaces group related content in Tana with their own members and AI personality. Access inherits from organization to space to document. - Containers for [documents](/learn/features/docs), [types](/learn/features/types), and [skills](/learn/features/skills), each with their own [AI instructions](#ai-instructions) - Three [access modes](#access-modes): everyone, only you, or selected people - Access [inherits](#how-access-inherits) from organization to space to document - [Link sharing](#link-sharing) lets anyone view a document without a Tana account - [Real-time collaboration](#real-time-collaboration) with live presence and cursor sharing - [Nested spaces](#nested-spaces) for deeper organization - Custom [color and name](#name-description-color) make each space recognizable throughout the interface ## Creating a space Select "Space" from the [create menu](/learn/features/interface#create-menu). New spaces are private to you by default. Add team members through the location and access settings when you are ready to share, or restrict access further on individual documents inside the space. Opening the create menu from inside a space creates a **subspace** nested under that space. See [Nested spaces](#nested-spaces). ## The space home Every space has a home page. It is both the landing page for the space and the place where you create new content in it. ### Pinned items A grid of pinned documents at the top. The drop zone is always visible on the space home, even when nothing is pinned yet, so dragging an item onto it works the first time too. Drag any item from the space onto the pinned section to pin it for quick access. Unpin by right-clicking and selecting "Unpin." ### Type cards Types defined in the space appear as colored cards below the pinned items. Click a card to open the [type page](/learn/features/types#the-type-page) with all entries of that type. ### Content list Below the type cards, the full content list shows all documents in the space sorted by last updated. Filter by type to narrow the view. ### Chat A chat bar at the bottom of the page starts an AI conversation scoped to the space. The AI receives the space's context and follows its AI instructions. See [AI chat](/learn/features/chat). ## Configuration Open "Configure Space" from the toolbar overflow menu on the space home. ### Name, description, color The name and description explain what the space is for. The color is a hue slider that colors the space avatar throughout the interface. Every reference to the space, whether in the sidebar, search results, or document breadcrumbs, shows the same color, making it easy to recognize visually which space content belongs to. ### AI instructions Custom instructions the AI follows when working in this space. This is how you give the AI context about the team, project, or domain. For example, a product design space might say: "This space contains product design documents. When creating tasks, always include a priority field. When writing specs, follow our format: problem, solution, tradeoffs, success criteria." Every chat, skill, and outcome generated in this space inherits these instructions. This is what gives each space its own AI personality. ### Skills Skills created in this space are listed in the configuration for reference. See [Skills](/learn/features/skills) for how to create and use them. ## Nested spaces A nested space is simply a space that lives inside another space rather than at the top level. Create one with the **+** in the top right of the parent space and choose **Space**. Like any item, a space has a **Lives in** location; nesting just sets that location to the parent. The nested space appears in the parent's content list and inherits its access by default, and changing a space's location (from its Location pill) moves it and everything inside it, so a space works as a portable container for its context. Use nesting for a genuine sub-area that has its own focus or members, for example a department space with a sub-space per team. When you just have many of the same kind of thing, reach for a [type](/learn/features/types) instead, so you do not end up with a sprawl of spaces. ## Access modes Every document, space, and meeting has access controls. Open the location and access settings from the toolbar (the lock or participant icon) to manage who can see it. The popover is organized into accordion sections for Scope, Access, People, and Guest link, so each concern has its own place. Three access modes: - **Everyone in {location}:** All members of the organization or space can access the content. - **Only me:** Only you can see it. This is the default for new spaces. - **Only selected people:** You choose exactly who has access. Add people from your organization using the search field, and remove them individually. ## How access inherits Access flows from outer containers to inner content: - **Organization** → all members are added automatically when they join - **Space** → inherits from the organization, can restrict to specific members - **Document or meeting** → inherits from its parent (space or org), can restrict further An item inside a restricted space is visible only to people who have access to the space, even without its own explicit restriction. You can tighten access on individual documents beyond the space's settings, but you cannot open it wider than the parent allows. Every document has a location shown in the location and access popover. You can move documents between spaces from the same popover, which changes both where the document lives and which access rules it inherits. Types can only be moved up to the organization level, not between spaces. ## Link sharing Enable "Anyone with the link can view" in the access settings to create a public link. Anyone with the URL can view the document without signing in to Tana. This is useful for sharing meeting outcomes, docs, or artifacts with people outside your organization who do not need edit access. The public viewer renders typed items with their full type chip, workflow state pill, assignees (as an avatar stack matching the in-app view), fields grid, and embed cards. Embed cards are clickable; embeds for items that do not have their own public page render as plain item cards. The browser tab title reflects the document's title once the page loads. Turning link sharing off applies immediately and the shared URL stops working. If you open a link whose sharing has been turned off, you see a Sign in call to action that returns you to the authenticated view. ## Real-time collaboration When multiple people have access to a document, they can work on it at the same time. Changes appear in real time for all participants. Docs and canvases show live cursor presence with each person's name and color, so you can see who is editing where. [People](/learn/features/interface#people) in the sidebar shows who is online (green dot indicator). Click a person to see everything you share with them. ## Sharing outcomes Meeting [outcomes](/learn/features/meetings#outcomes) and chat results can be shared independently from the conversation they came from. Each outcome has a **Share** button for managing its access settings. This is common when AI extracts action items or documents from a meeting that stakeholders outside the meeting need to see. Share the outcome with them without sharing the full meeting. ## Organization members Invite and manage your team from Settings (admin only): - **Invite new members** by email - **View pending invitations** - **Manage existing members** All organization members can be added as participants to spaces, documents, and meetings. People in the sidebar shows all members and their online status. ## Deleting a space Delete a space from the overflow menu on its home page. Deleting a space removes the space and all its contents, including nested spaces. A confirmation dialog warns before proceeding. --- #### Tasks URL: https://tana.inc/learn/features/tasks Tasks in Tana are documents with a state and an assignee, gathered in the tasks view. - Create from anywhere: [create menu](/learn/features/interface#create-menu), [chat](/learn/features/chat), [meetings](/learn/features/meetings), or the [tasks view](#the-tasks-view) - [Tasks view](#the-tasks-view): grouped by type, with bookmarkable Assigned to / Created by / Type / Space filters - Four states: [inbox, in progress, completed, later](#task-states) - [Assign to team members](#assignment) or drag a task onto a person in the sidebar - Toggle state with the checkbox or Cmd+Enter (Ctrl+Enter on Windows) - [Pin to dates in Today](/learn/features/today#pinning-items-to-dates) for time-based planning - Tasks with [types](/learn/features/types) appear on the [kanban board](/learn/features/types#the-kanban-board) ## Creating a task Several ways to create tasks: - **Create menu:** Select "Task" from the [create menu](/learn/features/interface#create-menu). The task opens as an inline card, assigned to you by default. - **Chat:** Ask the AI to create tasks during a [conversation](/learn/features/chat). AI-created tasks appear as [proposals](/learn/features/proposals) for your review. - **Meetings:** Extract tasks from [meeting outcomes](/learn/features/meetings#outcomes) during or after a call. - **Tasks view:** Click the "+" button on the tasks page. - **Typed entries:** When a [type](/learn/features/types) has a workflow, creating an entry of that type creates a task in the inbox state. Tasks created from the create menu and the tasks view open as inline cards (a popover over your current view) rather than navigating away. ## The tasks view The global view is titled **Tasks** in the sidebar and the [Library](/learn/features/interface#library). Instead of tabs, it uses filter pills that live in the URL, so a filtered view is bookmarkable and the browser's Back and Forward walk your filter history: - **Assigned to:** who the task is assigned to. Opening Tasks from the sidebar starts here, set to you. - **Created by:** who authored the task. - **Type:** a specific [type](/learn/features/types), or plain tasks. - **Space:** a specific space. With no pills set, the view shows the latest 50 active tasks rather than an empty screen, with a "Showing the latest 50 active tasks" note; a filter that genuinely matches nothing reads "No tasks". By default tasks are **grouped by type**: plain tasks come first, then each [workflow type](/learn/features/types) under its own heading that links to the type's definition. Every group heading carries a **"+"** that creates a task already matching that group, the right type, state, space, and assignee, folding in whatever filters are active. The header create menu offers a plain Task or any of your workflow types, assigned to you. Each row shows the state checkbox, title, type if any, and the relative updated time; long titles wrap up to three lines rather than clipping. Toggle state by clicking the checkbox, or right-click it for the full state menu (inbox, in progress or custom workflow states, completed, later). Click a row's title to open it in a popover over your current view rather than navigating away. Tasks created from this view default to **unrestricted** access (everyone in the space can see them), and self-assigning a task does not add you to the participants list, so you keep your existing access level instead of being demoted from admin to editor. ## Task states Every task has one of four states: - **Inbox:** New tasks land here. This is the triage state for things that need to be reviewed and prioritized. - **In progress (or custom states):** Active work. When a [type](/learn/features/types) has a workflow with custom states, each custom state represents a stage of progress. - **Completed:** Done. Toggle by clicking the checkbox or pressing . - **Later:** Deferred. For things you want to come back to but not right now. Wherever a task appears, its state shows as a single state icon. The icon mirrors the current state at a glance, and inside a custom workflow it draws a progress pie sized by the state's position in the workflow's ordered states. Click the icon to open the state dropdown, right-click for the context menu, and hover to see the current state's name. On a kanban board, drag cards between columns to change state. In the tasks view, use the checkbox or the state menu on each row. ## Assignment Tasks can be assigned to any team member. Set the assignee from the dropdown below the task title, or **drag a task onto a person** in the [People](/learn/features/interface#people) view in the sidebar. Assigned tasks appear for that person in their tasks view. ## Tasks on Today Pin a task to a specific date using "Pin to Date" from the context menu. Pinned tasks appear in [Today](/learn/features/today) alongside your meetings. See [Pinning items to dates](/learn/features/today#pinning-items-to-dates). ## Tasks and types Tasks are documents with state tracking. When you assign a [type](/learn/features/types) with a workflow to a document, it becomes a task automatically. The workflow's custom states become the columns on the kanban board for that type. This means you can have different kinds of tasks (bugs, features, design tasks) each with their own workflow stages, all visible in the same tasks view but manageable on their own kanban boards. --- #### Today URL: https://tana.inc/learn/features/today Today is your default daily view in Tana, combining meetings, pinned work, and an Ask or Capture bar scoped to the day. - The default screen when you open Tana: your [meetings](/learn/features/meetings), tasks, and pinned items for the day - [Pin any document](#pinning-items-to-dates) to a date from the Search button or from any document's context menu - [Navigate between days](#navigating-between-dates) with the arrows, or jump to any date with the mini calendar - Past meetings show outcome preview cards inline with taglines, summaries, and captured artifacts - Start an [AI chat](#ask-or-capture-from-today) tied to the day from the Ask or Capture bar - Synced events from [Google Calendar or Outlook](/learn/features/integrations) appear automatically ## Your daily view Today is the first screen you see when you open Tana. It shows the day's meetings, pinned items, and an Ask or Capture bar for starting AI conversations tied to the selected date. The Today view reacts to the clock. The greeting flips through the day, events roll from Now to Next up, Upcoming, and Past as time passes, and midnight rollover happens without a reload. The day is organized into groups: - **Now:** Meetings in progress - **Next up:** The very next meeting coming up - **Upcoming:** Meetings later in the day - **Past:** Meetings that have ended. Each past event shows outcome preview cards, so taglines, summaries, and captured artifacts appear inline on the event. Past events are listed newest-first, so the most recently ended meeting sits closest to **Now** and **Next up**. - **Pinned:** Documents, tasks, and other items you have pinned to this date Each meeting card shows the time, title, attendees, and either a **Join** button (for Tana calls) or the external meeting provider (Google Meet, Zoom, Teams). When someone is already in a call, the card shows who is in it. For an external meeting, a small icon next to the provider logo runs [Move to Tana](/learn/features/meetings#move-to-tana) right from the list, replacing the external link with a Tana call. The Join button appears once a meeting is within 10 minutes of its start time. Hovering it opens a device-check preview with the camera feed and mic, camera, and settings toggles; clicking joins the call directly without going through the Get Ready screen. Event cards can also be dragged into the sidebar to pin them to a space, or dropped into another document to create a reference. Right-clicking opens the standard context menu (Pin to space, Pin to date, Copy URL, and so on). ## Navigating between dates Use the arrow buttons next to the date heading to step to the previous or next day. The calendar icon opens a mini calendar for jumping to any date. When you are viewing a different day, a "Go to Today" button appears to return to the current date. ## Pinning items to dates Any document, task, or other item can be pinned to a date. Pinned items appear in the "Pinned" section alongside your meetings. Ways to pin: - **Create from Today:** Items made with the Create button on the day are automatically pinned to that date. Meetings are not pinned because they appear on their scheduled date automatically. - **Pin an existing item:** Use the Search button below the date header to find and pin any existing document. - **Pin from a document:** Use "Pin to Date" from any document's context menu. To **unpin**, right-click a pinned item and select "Unpin." ## Ask or Capture from Today The Ask or Capture bar below the date header lets you start an AI conversation tied to the selected date. Type a message and press enter. A new chat is created and pinned to that date. See [AI chat](/learn/features/chat) for what you can do in a conversation. ## Creating from Today Below the Ask or Capture bar, three buttons let you add content to the selected day: - **Meet now:** Start a meeting and enter the call right away. A "Who are you meeting with?" popover opens so you can copy the guest link, add colleagues in one click, pick **Myself** for a solo screen-share session, or start a voice chat with an agent. - **Meet later:** Schedule a meeting on the selected date. Pick the time and duration in natural language (for example, "tomorrow at 3pm" or "45 minutes"), so you do not have to open a date or duration picker. - **Create:** Open the full create menu for docs, canvases, tasks, chats, types, skills, and any custom types. Items created this way are automatically pinned to the selected date. - **Search:** Pin an existing document to the selected date by searching for it. --- #### Types URL: https://tana.inc/learn/features/types Types are schemas you define to give documents structured fields. - Ask [AI chat](/learn/features/chat) to create any type you need, with fields and workflow — no templates required - Define custom schemas with [fields](#fields) (text, link, date) to structure any document - Add a [workflow](#workflows) to enable status tracking with a [kanban board](#the-kanban-board) - Attach [skills](/learn/features/skills) to a type so they appear as quick actions on every entry - [AI instructions](#ai-instructions) per type guide how the AI works with entries of this type - The [type page](#the-type-page) shows all entries as a list or kanban board - Color-coded [type cards](/learn/features/spaces#types-in-a-space) appear on space home pages ## Creating a type The fastest way to create a type is to ask AI. In any [AI chat](/learn/features/chat), describe what you want to track ("a Bug type with priority, assignee, and steps to reproduce") and the AI will create it, with fields, workflow, and AI instructions. No templates to pick from, no pre-made catalogue. Every type you need, you can just ask for. To create one manually, select "Type" from the [create menu](/learn/features/interface#create-menu). Give it a name, add fields, and optionally enable a workflow. Types can live in a [space](/learn/features/spaces) or at the organization level. ## The type page Every type has a page showing all documents with that type assigned. The page displays differently depending on whether the type has a workflow. **Without a workflow:** A simple list of entries sorted by last updated, with a button to create new entries. An option to "Convert to workflow" is available if you want to add status tracking later. **With a workflow:** A tabbed view with three tabs: - **Active:** A kanban board with columns for each workflow state - **Completed:** Entries marked as done - **Later:** Entries deferred for later Drag entries between tabs to change their state. The "+" button creates a new entry that opens as an inline card. ### The kanban board When a type has a workflow, the Active tab shows a kanban board. Columns represent workflow states. Drag cards between columns to change status. Columns can be resized and reordered. Cards open in an inline popover when clicked, so you can review and edit without leaving the board. Each card also carries an assignee avatar on its trailing edge, with a dashed placeholder when no one is assigned. Click it to open a searchable people picker, type a name, and reassign the card without opening it. The same picker backs the assignee shown in a card's detail view. ## Configuring a type Navigate to the type configuration page from the overflow menu on the type page. Configuration includes: ### Fields Fields add structured data to every document with this type. Four field types are available: - **Text:** Plain text values - **Link:** References to other documents. You can configure which types are valid link targets and set a custom reverse label (the name shown in backlinks). - **Date:** Date values - **Member:** References to members of your organization Each field can be configured as single-value or multi-value. Add fields from the configuration page by typing a name and clicking "Add." Remove fields from the dropdown menu on each field. ### Workflows A workflow adds status tracking to the type. Click "Add Workflow" in the configuration to enable it. Every workflow has four fixed states: - **Inbox:** Where new entries land by default - **Completed:** Done - **Later:** Deferred Between Inbox and Completed, you can add custom states. By default there is one: "In Progress." Click "Customise statuses" to add, rename, reorder, or remove custom states. These become the columns on the kanban board. Remove the workflow entirely with "Remove Workflow" to return the type to a simple list. ### AI instructions Custom instructions the AI follows when working with entries of this type. For example, "When creating bugs, always include steps to reproduce and expected behavior." ### Color A hue slider that colors the type badge throughout the interface. When the type lives in a space, the color is inherited from the space. ### Skills Attach [skills](/learn/features/skills) to a type. Attached skills are available from the [Send to](/learn/features/docs#send-to) menu on every document with this type. This is how you add domain-specific AI actions to your workflow: attach a "Create GitHub issue" skill to a Bug type, and every bug can file one in a click. ## Assigning types to documents Any document can have a type. Assign from: - The overflow menu on a [doc](/learn/features/docs) ("Set type") - A slash command in the doc title - The [create menu](/learn/features/interface#create-menu) (creating a typed entry directly) Changing or removing a type updates the available fields. Existing field values are preserved when switching between types that share field names. ## Archiving a type Archive a type from the "..." menu on its type page; a confirmation dialog appears first. An archived type and all its items drop out of every menu, picker, type palette, list, Library view, and search result, including semantic search, and the change takes effect immediately without a reload. Existing items keep their type assignment and show a muted "(archived)" label in place of the normal type badge. The type page shows a callout explaining the state, with an "Unarchive" button that makes the type available again everywhere. To find an archived type again, open **Recently archived** under Organization in Settings. It lists every type you have archived, newest first, with how long ago each was archived. Click a row to open that type's page, where you can Unarchive it. --- ### Help #### Apps and platforms URL: https://tana.inc/help/apps-and-platforms Using Tana on desktop, mobile, and the web. ## What desktop features are available? ## Can I use tabs on desktop? ## What is split view? ## How do I see today's meetings without opening Tana? ## Is there a mobile app? Not yet. Use Tana in your mobile web browser for now. ## Can I use Tana on the web? ## What are the keyboard shortcuts for navigation? ## What are the keyboard shortcuts for editing? --- #### Canvas and artifacts URL: https://tana.inc/help/canvas-and-artifacts Visual canvases and AI-generated artifacts in Tana. ## How do I create a canvas? ## What drawing tools are available? ## Can I embed documents in a canvas? ## Can I collaborate on a canvas? ## What are artifacts? ## How do I create an artifact? ## What types of artifacts can I create? ## How do I edit an artifact? ## How do I share an artifact? --- #### Collaboration and sharing URL: https://tana.inc/help/collaboration-and-sharing Sharing content, managing access, and collaborating in real time. ## What are the different access modes? ## How does access inherit between items? ## How do I share a link? ## How does real-time collaboration work? ## What are shared outcomes from meetings? ## How do organization members work? --- #### Docs and editing URL: https://tana.inc/help/docs-and-editing Writing, formatting, and managing docs in Tana. ## How do I format text? ## How do I add images and attachments? ## How do I mention another document or person? ## How do I see what links to a doc? ## How do I send a doc to a chat, a skill, or export it? ## How do I iterate on a doc with AI? ## How do I delete a doc? --- #### Getting started URL: https://tana.inc/help/getting-started Common questions about getting started with Tana. ## What is a space and how do I set one up? ## What types of documents can I create? ## How do I organize Tana with types? ## How do I navigate the interface? ## How do I create new things? ## How do I search for something? ## Where do items that are not in a space live? ## How do I see my notifications and recent activity? --- #### Integrations and MCP URL: https://tana.inc/help/integrations-and-mcp Connecting Tana to external tools and using the MCP server. ## How do I connect an integration? ## How do I sync my calendar? ## What can the AI do with GitHub? ## What can the AI do with Slack? ## What can the AI do with Linear? ## What can the AI do with Jira? ## What can the AI do with HubSpot? ## How do I connect my own MCP server? ## What coding tools can Tana connect to? ## How do I use the MCP server? ## How do I use Tana with Claude Code? ## How do I use Tana with Claude Desktop? --- #### Meetings URL: https://tana.inc/help/meetings Setting up, running, and getting value from meetings in Tana. ## How do I create a meeting? ## How do I invite people to a meeting? ## How do I prepare talking points? ## How do I join a call? ## What happens to a call when I navigate away? ## Can I share my screen? ## How does transcription work? ## Can I capture my screen during a meeting? ## How do I pause recording during a call? ## What can I do during a call? ## Can I chat during a meeting, and does AI work with guests present? ## What can I do with a meeting after the call? ## Can I capture an external call? ## Can I talk to Tana by voice during a meeting? --- #### Organizing your spaces and types URL: https://tana.inc/help/organizing-your-spaces Spaces, types, fields, and structuring your information in Tana. ## What is a space home? ## How do I configure a space? ## Can spaces be nested? ## How do I create a type? ## How do I add fields to a type? ## What are workflows? ## Can I see a kanban board? ## How do I add AI instructions to a type? ## How do I archive a type? ## How do I delete a space? --- #### Today and tasks URL: https://tana.inc/help/today-and-tasks Managing your day and tasks in Tana. ## How do I see my day? ## How do I navigate between dates? ## How do I pin items to dates? ## How do I create something from Today? ## How do I create a task? ## What are task states? ## How do I assign tasks to people? ## How do tasks appear on Today? ## How do tasks connect to types? --- #### Working with AI URL: https://tana.inc/help/working-with-ai How to use AI chat, proposals, skills, and voice input in Tana. ## How do I start an AI conversation? ## What can AI do in Tana? ## How do AI proposals work? ## Can AI apply changes automatically? ## Can I see previous versions of AI changes? ## How do I choose an AI model? ## Can I use voice to talk to AI? ## What are skills? ## How do I create a skill? ## How do I use a skill? ## Can I customize my own AI agent? ## Can the AI change who has access to a doc? ## What language does the AI write in? ## What happens when I hit my AI usage limit? --- ### other #### Bring every meeting into Tana URL: https://tana.inc/blog/bring-every-meeting-into-tana Capture meetings from any tool, keep your calendar in sync both ways, and pin your own sidebar. Plus a sharper meeting view and a calmer voice agent. This update is about Tana fitting the way you already work. Your calendar now syncs both ways, capturing the meetings you hold in other tools is smoother and more reliable, and the sidebar is yours to arrange. The meeting itself, and the voice agent in it, got sharper too. Events you create and manage in Tana now sync out to your connected calendar. Make an event in Tana and it appears in Google Calendar or Outlook moments later, and changes to its title or time, and deleting it, propagate back too. New connections write Tana events to your primary calendar automatically. If you connected a calendar earlier, turn it on by choosing which calendar to write to in [calendar settings](/learn/features/meetings#calendar-sync). Capturing a meeting held somewhere else now works better. Because it records the audio your computer plays, it works across any meeting platform rather than a fixed set, and it is lighter on your machine and more reliable. A small always-on-top window opens a couple of minutes before a scheduled meeting so you can start recording in one click, with pause and stop controls right there. You can also start a capture from the Today page for a meeting that is not on your calendar. If a teammate is already capturing the same meeting, everyone else sees it so it is not recorded twice. It is rolling out as an opt-in. On the latest desktop app, turn on **Use experimental meeting capture** in Settings, Preferences. See [capturing external meetings](/learn/features/meetings#capture-with-system-audio-opt-in) for the details. The sidebar is now yours to shape. Instead of listing every space and agent automatically, it keeps a clean set of primary links and a **Pinned** area you fill with the things you actually reach for. Pin any document, space, or agent, drag to reorder, and right-click to create a new section and group your pins. Your full set of spaces is still there in the Library whenever you need it. The meeting view is now one calm column that carries the work instead of a stack of documents. What the AI captures during the call is sorted into two clear places: items wait under **For Review** until you accept them, with keep and reject buttons right on the card, and accepted ones move to **Outcomes**. During the call the live digest steps back to a slim status line, so the shared focus takes center stage, and the full timeline stays one click away. When the meeting ends you get an editable, shareable summary with a Summary and Timeline toggle. See [how outcomes work](/learn/features/meetings#review-and-use) for the details. ## More in this update The voice agent has a calmer, more ambient look and clearer audio, and you can set a default voice for Tana's built-in agents in Organization Settings. Invite anyone to a meeting straight from Tana. Add teammates by name or type any email address, including people outside your organization, and everyone you add gets a real calendar invite in their inbox. Transcription follows your organization's language across meetings, external capture, the voice cursor, and dictation, while still picking up other languages spoken in the room. Guests in a Tana meeting can ask the AI questions in their own private chat, separate from the shared meeting chat. It answers but cannot create or change anything. Say "Hey Tana" and give a command in the same breath, like "Hey Tana, file that as a bug", and the agent acts on it instead of just greeting you. Tana opens faster, especially on slower connections and right after an update. Incoming-call notifications now reach you in the browser, not just the desktop app, and take you straight to the meeting. The full list of what shipped lives in the [changelog](/changelog). ## Try this --- #### Bring your own tools URL: https://tana.inc/blog/bring-your-own-tools Tana reaches further this update: its AI can use the tools on your own MCP servers, the Tasks view groups and filters your work into bookmarkable slices, and a new search popover gets you to anything in Tana from wherever you are. This update is about reach. Tana's AI can now use the tools on your own servers, a reworked Tasks view groups and filters your work into slices you can bookmark and share, and a new search popover gets you to anything in Tana from wherever you happen to be. Tana already connects to GitHub, Slack, Linear, Jira, and HubSpot. Now you can connect anything else that speaks the Model Context Protocol, your own internal server or a third party's, and its tools become available to Tana's AI. Add a server from settings and authorize it once over OAuth. Each connection becomes a [skill](/learn/features/skills), so its tools only enter a chat when that skill is in scope, and you can allow or deny each tool from the skill's panel. Your connected servers stay private to you. It runs both ways, too. Tana is itself [an MCP server](/learn/features/mcp), so Claude, Cursor, or any MCP client can work with Tana from the other side. See [Custom MCP servers](/learn/features/integrations#custom-mcp-servers) for the full picture. The [Tasks](/learn/features/tasks) view is now built around filter pills, assignee, creator, type, and space, that live in the URL, so any slice of your tasks, everything assigned to you, what you have delegated, only your open issues, becomes a link you can bookmark or share, and the browser's Back and Forward walk your filter history. Group the list by type, status, or assignee, with a "+" on every group heading that adds a task already matching that group and your active filters. With nothing filtered, the view shows your most recent tasks rather than an empty screen. [Search](/learn/features/interface#search) now opens as a popover right where you are, including while you are writing in a document. Start typing for full-text search across Tana, or open it empty to browse. When nothing is typed, the popover shows the [Library](/learn/features/interface#library) as a browsable index: each kind of thing, meetings, tasks, types, chats, and the rest, in its own section with a "See all" page. It is the fastest way to land on something without losing your place. Reach for it with Cmd+P on macOS, or Ctrl+P on Windows and Linux. ## More in this update **Filter by who can see it.** A new visibility filter in [search and the Library](/learn/features/interface#search) narrows any list to what is private to you, shared with you, restricted, open, or shared by link. **Set an [outcome's](/learn/features/meetings#outcomes) state from the meeting.** Outcome tiles show a state control inline for anything with a workflow, a plain task or a typed item like a Bug, so you can move it along without opening it. **See where any item lives.** The location button on a panel now names the [Library section](/learn/features/interface#library) an item belongs to, like "Meetings" or "Docs", and links straight there. **Recent meetings, front and center.** The [Meetings preview](/learn/features/interface#library) on your Library and space home leads with recent meetings, with a dropdown to switch between recent, upcoming, today, and past. **[Reopen an archived type](/learn/features/types#archiving-a-type).** A "Recently archived" list in settings keeps every type you have archived, so you can find one and unarchive it. **A [title chip](/learn/features/interface#panel-title-chip) when you scroll.** Scroll down any panel and a compact chip with the item's icon and type appears in the toolbar. Click it to jump back to the top. **[Dictation](/learn/features/chat#voice-input) keeps your last words.** Send a dictated message the moment you stop speaking and the tail of what you said now makes it in, instead of getting dropped. **Copy a long prompt for a [coding tool](/learn/features/integrations#coding-tools).** When a hand-off prompt is too long for a tool's launch link, Tana offers a "Copy full prompt" button so you can paste the whole thing. **Open a [video](/learn/features/docs#images-and-attachments) in its own player.** Opening a video item now plays it in a dedicated player panel with the usual toolbar, instead of a generic view. **[Transcription](/learn/features/meetings#transcription) spells your team's names right.** Meetings and dictation now lean on your organization's name and your teammates' names, so "Tana" and the people in the room come through correctly. That is the gist. The full list, every new, improved, and fixed item, lives in the [changelog](/changelog). ## Try this The new search popover and Library are about getting to anything fast. Let the AI do the gathering: drop this into a chat and it pulls a scattered topic into one place. --- #### From conversation to action URL: https://tana.inc/blog/from-conversation-to-action The AI can turn a conversation into a calendar event, guests can join the shared meeting chat, and a new Capture as action grabs the exact part that mattered. Plus Meet now or later from Today, diagrams inline in chat, and more. This update is about the conversation, and everything you want to do with it. The AI can turn it into a calendar event, guests can join the shared chat, and you can grab the exact part of a meeting that mattered without keeping the rest. Ask in [chat](/learn/features/chat) and the AI can now [propose](/learn/features/proposals) a calendar event. Give it a title and a start time and it drafts the rest: an end time, time zone, location, description, and the people to invite. Adding participants keeps the event to that list. You stay in control. It is a proposal you review before anything lands, and the AI still will not change the time, title, attendees, or meeting link of an event that already exists. Meetings have a shared chat, Chat with everyone, and now guests are in it too. They can send and read messages right alongside your team, the simplest way to bring an outside collaborator into the conversation as it happens. To keep your organization's data private, the AI steps out of the shared chat whenever a guest is present, with a short note explaining the pause. Your own private meeting agent keeps working as usual. A meeting can cover a dozen different things. Capture as lets you act on just one of them: hover any row in the live [digest](/learn/features/meetings#transcription) and turn that section into a note, a task, a typed item, or an [artifact](/learn/features/artifacts) like a screen-share recap. Scoped to that one part, the AI works from focused context, so what comes out is about that decision or action, not the whole conversation. Need the exact words instead? The same hover menu copies that segment of the transcript, grouped by speaker. The Meet button in [Today](/learn/features/today) splits in two. Meet now starts a meeting straight away and opens a "Who are you meeting with?" popover, where you can copy a guest link, add colleagues in one click, share your screen solo, or start a voice chat with an agent. Meet later opens the scheduling popover instead, for picking a time. One button, two clear intents: start talking now, or put it on the calendar for later. ## More in this update **Diagrams render in [chat](/learn/features/chat) replies.** When the AI includes a diagram, it now renders inline once it is complete, instead of flashing raw markup as it streams. **Open a [task](/learn/features/tasks#the-tasks-view) in a peek.** Click a task's title in the Tasks view and it opens in a popover over the list, so you can read or edit it without leaving your tasks. **A date chip on an event's location pill.** It reads Today, Tomorrow, Yesterday, or a short date, and clicking it jumps to that day on the calendar. **Know when a [type](/learn/features/types#archiving-a-type) is archived or restored.** A notification tells you when someone in your org archives or restores a type, with a link to its panel. **Filter any [Library](/learn/features/interface#library) section.** Created by and Visibility pills now sit on every section page, saved in the URL so the view is bookmarkable. **Your own [skills](/learn/features/skills), front and center.** The Skills section and search now list the skills you and your team have made, with Tana's built-in ones filtered out. **Open org links in the [desktop app](/learn/features/apps).** Click a link to your org's Tana in a browser and it asks whether to open in Tana or stay in the browser, then remembers your choice. Set it from Preferences in the web app. **Find events you organized in [Created by](/learn/features/today).** Calendar events are now attributed to their organizer, so filtering by Created by surfaces the meetings you set up. The throughline this time: less time spent capturing the meeting, more spent acting on it. The [changelog](/changelog) has the rest of this release, including a handful of call and sign-in fixes. ## Try this The AI can schedule a meeting and prep your team for it in one go, drawing on what it already knows about your work. Drop this into a chat and it drafts the event and a prep doc for you to approve: --- #### Tana takes it from here URL: https://tana.inc/blog/tana-takes-it-from-here Tana does more on its own: meetings wrap themselves into outcomes, there's one place to create without leaving the call, and your tasks and mentions show more at a glance. Plus a unified Library, Mermaid diagrams, and Outlook calendar sync. This update shares a thread: Tana does more on its own. Meetings wrap themselves into outcomes the moment everyone leaves, there's one place to create or capture without leaving the call, and your tasks and mentions show more at a glance. Once everyone leaves a call, Tana runs the [wrap-up](/learn/features/meetings#outcomes) on its own: it proposes outcomes and writes a summary, with no manual step. Want them while you are still in the call? Hit Wrap up. When you pin a document to a meeting, the wrap-up treats it as the strongest signal of what the meeting was about, and updates that document rather than creating a new one. The meeting toolbar is simpler. Capture, Skills, and Create collapse into a single create menu, with a spyglass beside it to find and pin things. From that one menu you can turn the last minute, or the whole meeting, into a typed item, make a private note or task just for you, or run a skill or summary. One place, less hunting. Browse is now Library, the home for everything that is not pinned to a space, and it shares one filter bar with [Search](/learn/features/interface). Filter pills jump you to meetings or chats, or narrow by who created an item, and your spaces and types each get a dedicated section so they are easy to reach. Once you have found something, the new ["Send to"](/learn/features/docs#send-to) menu routes it anywhere: start a chat about it, run a skill, send it to an integration, pin it to a meeting, copy its link, or export it as Markdown. A task now shows a state icon wherever it appears, filling like a pie as it moves through its workflow, so you can tell where something stands without opening it. Give any [type](/learn/features/types#workflows) a workflow to make it task-like. Inline mentions carry more too: a task's state, a person's avatar, an image thumbnail, or the item's type. Hover one for a preview, or right-click to pin it to a date, assign it, or change its status. You can now add diagrams to any document. Type "/mermaid", ask the AI in chat, or set a code block's language to Mermaid, then switch between a live preview and the source. When the AI writes a diagram, it self-corrects unsupported syntax on its own. ## More in this update **Connect your Outlook calendar.** Microsoft and Outlook calendars now sync into Tana, so those meetings show up alongside the rest. **Activity is now a dashboard.** Promoted into the sidebar, it shows your notifications and recently updated items side by side, with an unread count. **A guided welcome session for new team members.** New workspaces open with a live, guided meeting: an agent tuned to your work sets up spaces and types with filled-in examples, and walks you through the essentials. **[Agents](/learn/features/agents) know what time it is.** Agents are now timezone-aware, so "today" matches your own calendar day and a [scheduled routine](/learn/features/agents#schedules) set to 09:00 in Oslo lands on the right Oslo morning. **Reassign right from the board.** Kanban cards carry an assignee avatar. Click it for a searchable people picker and reassign without opening the card. **Paste a link, get a mention.** Pasting a link to a Tana item now drops in an inline [mention](/learn/features/docs#mentions), not a raw URL. **Meeting summaries open with an illustration.** A wide pen-and-watercolour image, drawn from what the meeting was about, now tops each summary. **Muted by default in larger meetings.** Join a call that already has five or more people and you start muted, so you don't cut in. **[Archive a type](/learn/features/types#archiving-a-type).** Archive a type and it drops out of every menu, picker, and search right away, while existing items keep it with a muted "(archived)" label. **[Restore a deleted document](/learn/features/docs#deleting-a-doc).** A soft-deleted item now shows a "Restore document" button, so you can bring back something removed by mistake. That is the gist. The full list, every new, improved, and fixed item, lives in the [changelog](/changelog). ## Try this Diagrams are the easiest new feature to try yourself. Drop this prompt into your chat and see what Tana draws: --- ### Guides #### Build a shared issue tracker with a type URL: https://tana.inc/learn/guides/track-issues-with-a-type Create an Issue type so your team tracks work the same way: shared fields, one board, and the AI filing new issues in, complete and consistent, from a meeting or a chat. {/* DRAFT for review. Teaches the structure side via an Issue type. Collaboration-first; value woven through the teaching. */} Every product and tech team tracks issues: bugs to fix, changes to make, things that need doing, each with a priority, an owner, and a state. In Tana you turn that into one shared tracker by giving issues a **type**. Create an Issue type once, and every issue shares the same fields and shows up on one board, whether a teammate files it by hand or the AI files it from a standup. This guide sets that up: the type, the board, and letting the AI keep it fed. ## Create the Issue type Ask the AI to "create an Issue type," or add one from the create menu, in the [space](/learn/features/spaces) your team works in so everyone shares it. A [type](/learn/features/types) is for a kind of thing you have many of, and an Issue is the textbook case. Add the fields an issue always needs: status, priority, the area it affects, and an assignee. Every Issue from now on carries these, so nothing arrives half-described. Give the type a workflow, a set of states like Triage, In progress, and Done. With a workflow, the type's page becomes a [kanban board](/learn/features/types#the-kanban-board): move an issue from Triage to Done and everyone sees it move. ## Let the AI file issues in, complete The point of the type is that new issues land already in shape. When one comes up in a [meeting](/learn/features/meetings) or a [chat](/learn/features/chat), the AI creates an Issue with the fields filled, status, the area, who raised it, as a [proposal](/learn/features/proposals) you review and accept. Nothing lands until you say so. To make this dependable, set the type's **AI instructions**: "capture what needs to happen and why, set priority from how it is described, and for a bug include steps to reproduce." Now every issue the AI files matches how your team writes them, and you stop chasing people for the missing details. ## See every issue in one place Open the Issue [type page](/learn/features/types#the-type-page) and you have every issue across the team, as a list or as the board. Filter to all the open ones, or just the ones for one area, with nobody assembling a report. Because the type lives in your team's space, it is the same board for everyone: the shared source of truth for what is open and who has it. ## Add a one-click action Attach a [skill](/learn/features/skills) to the Issue type and it becomes a one-click action on every issue: "file this in GitHub," "post it to the team's channel." The skill does the same job the same way every time, so sending an issue upstream is one click for anyone on the team, not a copy-paste ritual. (Filing to GitHub or Linear needs the [integration connected](/learn/features/integrations).) --- #### Capture meetings from Zoom, Teams, and Meet URL: https://tana.inc/learn/guides/capture-external-meetings Capture your Zoom, Teams, and Meet calls with the Tana desktop app, with no moving the call or asking anyone to switch, and get the transcript, screenshots, and outcomes in Tana to share with your team. {/* DRAFT for review. Flow verified against feature/meetings.mdx (External meetings). Pitched above the in-flux capture UX; honest troubleshooting drawn from real failure modes in the User insights space. Screenshot deferred until capture UX settles. */} Most of your calls happen with people who are not in Tana, customers, partners, candidates, on Zoom, Teams, or Meet. You do not have to move those calls or ask anyone to switch tools to get them into Tana. The desktop app captures them from the side, so the transcript, the screenshots, and the outcomes land in Tana just like a call you hosted there, ready to share with your team. It is a one-time setup, then a click per call. ## Before your first capture Capture runs in the Tana **desktop app**, so install and open it if you have not. Then, once: - **Turn on meeting detection** in the desktop app. - **Grant permissions.** On macOS, Tana needs screen recording and microphone access so it can hear the call and screenshot shared screens. ## Capture a call Join your Zoom, Teams, or Meet call the way you always do. You do not move it or change the link; Tana works from the side. When a call starts, the desktop app shows a **Meeting detected** notification. Click **Capture** on the calendar event, or use the ad-hoc capture button if the meeting is not on your calendar, in which case Tana creates a matching event for it. Then go back to your call and run it normally. {/* TODO screenshot (deferred until capture UX settles): the "Meeting detected" notification with the Capture button. */} Tana captures the audio for transcription and takes screenshots of shared screens as you go, and it identifies speakers and lines them up with the transcript. There is no bot in the call and no video recording, just the words and the shared screens. For anything sensitive, stop the capture to pause it. When the call ends, or you click **End capture**, Tana processes the conversation into a summary, the outcomes it found, and screenshots from what was shared, all as [proposals](/learn/features/proposals) you review. The same live wrap-ups you get in a Tana call happen here too, so the event fills in without you opening it. Only one at a time: a capture and an in-app Tana call cannot run together, so Tana asks you to stop one before starting the other. ## Capture, or move the call to Tana Two ways to handle a call that lives in another tool: - **Capture** records from the side and leaves the call where it is. Use it when you cannot change the link, or when the other people are not on Tana. - **Move to Tana** replaces the meeting's video link with a Tana call: the organizer clicks **Move to Tana** and attendees are notified. Use it when you want the full in-call experience, live outcome capture, the meeting agent, and shared surfaces. ## If a capture does not start **No "Meeting detected" notification.** Check that meeting detection is on, and that screen recording and microphone permissions are granted to the desktop app. **The capture produced no transcript.** This is almost always permissions. Recheck microphone and screen-recording access, then capture again. **The call did not show up right away.** Synced calendar events can take a moment; give it a beat or refresh. **Tana won't start a capture.** You are likely already in a Tana call, or another capture is running. Only one runs at a time, so stop the other first. --- #### Catch up on your team's work, then act on it URL: https://tana.inc/learn/guides/catch-up-and-act Behind after time away or back-to-back meetings? Ask Tana what your team decided and what is on you, then turn it into filed follow-ups in the same chat, each one reviewed as a proposal before it lands. {/* DRAFT for review. Teaching exemplar: the steps are the lesson. Each one teaches a transferable Tana skill (scoping a retrieval prompt, verifying grounded answers, chat as a command interface, the propose/review/accept loop), not just the procedure for catching up. */} Coming back from a few days away, or surfacing from a week of back-to-back meetings, you hit the same wall: the team kept moving and now you have to reconstruct what happened. Tana can do that reconstruction for you, and then act on it without you leaving the conversation. What you are really learning here is what a Tana [chat](/learn/features/chat) is for. It is two things at once: a way to **retrieve** across everything your team has done, and a way to **act** on what you find. Catching up is just a good first place to see both. The same moves work anywhere in Tana. ## Catch up, then act Open a [chat](/learn/features/chat) and ask in plain language: _"What did the team decide this week, and what is waiting on me?"_ Look at what that one question is doing, because it is the pattern behind every good retrieval prompt. _"What did the team decide"_ sends Tana searching your shared record, the meetings held while you were out, the decisions captured from them, the issues raised. _"waiting on me"_ narrows that to the items that mention or are assigned to you. Scoping by **time** (this week, since Monday) and by **relationship** (on me, for my team, from Acme) is how you turn a vague ask into a focused answer instead of a wall of everything. The more precisely you scope, the sharper the reply. The answer comes back with its receipts. Each point is assembled from real items, a specific meeting, a logged decision, an issue, and every one is a link you can open to see the full context the one-line summary was drawn from. Make opening a few of them a habit. Tana builds the answer from what your team actually recorded, and only from what your permissions let you see, so it is grounded rather than guessed. But a thirty-second skim of the sources is what turns a plausible-looking summary into one you are willing to act on. Learning to trust and verify an AI answer this way is a skill that pays off everywhere in Tana, not just here. Here is the shift that makes this more than a digest. Stay in the same chat and tell Tana what to do about what you found: _"Draft replies to the two decisions that need my input, file the bug from Tuesday's standup as an Issue, and add a task to review the migration by Friday."_ Two things to notice. You can stack several actions into one message, and Tana carries the context from the catch-up straight into each one, it already knows which bug, which decision, which migration. The chat that just searched for you is now creating and updating on your behalf. That is the second half of what a chat is: not only "what happened" but "do something about it", in one continuous thread. Nothing you just asked for is applied on its own. Each change comes back as a [proposal](/learn/features/proposals): a reply drafted, an issue to be created, a task to be added. A proposal shows you exactly what will happen, the full body of the new issue, the precise edit to a doc, before any of it is real. You edit what is off, accept what is right, and discard the rest. This is the most important thing to carry out of this guide: the propose, review, accept loop is the same everywhere AI acts in Tana, in [meetings](/learn/features/meetings), through [skills](/learn/features/skills), here in chat. Learn the control once and it holds for all of it. And because your team shares this record, accepted work is live the moment you keep it: the issue lands on the team's board, the task shows up assigned, with no separate step to circulate it. ## Make it a habit Catching up is a natural Monday-morning move, or the first thing to do after time away. Once the shape of the ask is familiar, you do not have to keep typing it: hand it to an [agent](/learn/features/agents) on a [schedule](/learn/features/agents#schedules), and the catch-up, with its follow-ups already drafted, is waiting for you each morning to review. The same retrieve-then-act pattern runs forward too, to [prepare for what is coming up](/learn/guides/prepare-for-meetings). --- #### Connect GitHub URL: https://tana.inc/learn/guides/connect-github Set up the GitHub integration so the AI can file and manage issues, review and merge pull requests, read code, and hand work to Copilot, from your meetings and chat. Tana connects to your GitHub account so the AI can turn what you discuss into filed issues, work with pull requests, and read your code, without switching tools. Talk through a bug or a change in a meeting or in chat, file the issue while the context is fresh, and hand it to Copilot to start a fix. This guide covers the one-time setup, what to expect from the authorization flow, and how to use the integration in chat. ## What you can do with GitHub in Tana Once GitHub is connected, ask the AI in chat to: - **File issues**: create a structured issue from a discussion, with a title, body, labels, and assignees - **Update issues**: change the title, body, labels, assignees, or the open or closed state - **Search and read issues**: look up issues by keyword, useful for checking duplicates, and read an issue with its comments - **Work with pull requests**: list, create, review (approve, request changes, or comment), and merge (merge, squash, or rebase) - **Comment**: add a comment to an issue or a pull request - **Read code**: browse a repository's directories and read file contents at any branch, tag, or commit - **Include screen-share screenshots**: screenshots shared on a call are embedded in the issue body for visual context - **Hand work to Copilot**: assign an issue to GitHub Copilot so it can start a fix and open a pull request You can also attach skills to Tana types that file GitHub issues one-click from your documents. See [Skills](/learn/features/skills) for how that works. ## Connect GitHub You only need to do this once. The connection is per-account, not org-wide. 1. Open Settings with , or from the account menu in the sidebar. 2. Open **Integrations**. 3. Find **GitHub** under personal integrations and click **Connect**. 4. A GitHub authorization window opens. Sign in if you aren't already, and authorize access. 5. Review the access GitHub lists for Tana, then approve it. 6. The window closes and Tana shows **Connected** next to GitHub. ## Permissions Tana requests Tana asks GitHub for the access it needs to work with your issues, pull requests, and code: reading repositories, issues, and pull requests, and creating or updating issues and pull requests on your behalf. Tana never reads or writes anything outside what you approve during connect. Your access token is stored securely on Tana's servers, never in your browser. You can review or revoke Tana's access at any time from your GitHub account settings, under connected applications. ## Use it in chat Once GitHub is connected, the AI can call GitHub tools when a prompt asks for it. Some prompts to try: - "Check the acme/web repo for open issues about the login bug, then file a new one if there isn't a duplicate." - "Create a GitHub issue in acme/web for the bug we just discussed, label it a bug, and assign it to Copilot." - "Read the README in acme/web and summarize the setup steps." - "What open pull requests in acme/web are waiting on my review?" - "Approve PR #142 in acme/web and merge it with a squash." The AI picks the right GitHub tool from your prompt and asks for clarification when something is ambiguous, for example which repository. ## From issue to pull request GitHub is more than an issue tracker in Tana. A common loop: 1. **File a well-scoped issue** from the meeting. The AI can read the repository first to ground the issue in the real files, and checks for duplicates when you ask. 2. **Hand it to Copilot.** Assign the issue to Copilot when you file it, and GitHub Copilot can start a fix and open a pull request. 3. **Review and merge from chat.** Ask the AI to review the pull request, approve it, request changes, or comment, and merge it with a merge, squash, or rebase when it's ready. The AI never assumes the repository. If you don't name one, it asks, and can list your repositories so you can choose, before filing. ## How Tana files an issue A few things happen when the AI creates an issue: - **Confirms the repo**: it never guesses the target repository. If you haven't named one, it asks and can list your repositories so you can choose. - **Duplicate check**: when you ask it to, the AI searches existing issues first, so you don't file the same thing twice. - **Structured body**: the AI writes the body in GitHub-flavored markdown, with context, current and expected behavior, and steps to reproduce, quoting the reporter where it helps. - **Screenshots as context**: screenshots shared on a call during the meeting are embedded in the issue body. ## Disconnect GitHub To remove the connection from Tana: 1. Open Settings → **Integrations**. 2. Open the **Connected** menu next to GitHub and choose **Disconnect**. The same menu has **Reconnect**, which you can use to refresh access. Disconnecting stops the AI from reading or writing to GitHub but does not change anything already in GitHub or in Tana. To fully revoke Tana's access from GitHub's side, also remove Tana from your GitHub account's connected applications. ## Troubleshooting **The AI says it can't reach GitHub.** The connection has likely expired or been revoked. Reconnect from Settings → Integrations. **The AI keeps asking which repository.** This is by design. It never guesses where to file. Name the repository in your prompt, or pick from the list it offers. **A merge didn't go through.** Branch protection rules, required reviews, and merge conflicts are enforced by GitHub. Resolve them on GitHub, then ask again. **Something else?** See [Integrations](/learn/features/integrations) for the broader integration overview, or reach out at [support@tana.inc](mailto:support@tana.inc). --- #### Connect HubSpot URL: https://tana.inc/learn/guides/connect-hubspot Set up the HubSpot integration so Chat can search contacts, companies, and deals, log notes to CRM records, and update lifecycle stages without leaving Tana. Your customer conversations happen in Tana; your customer record lives in HubSpot. Connect the two and the AI moves between them for you: it pulls the contact, company, and deal history into [meeting prep](/learn/guides/prepare-for-meetings), and pushes what the call produced, the notes, the new deal, the stage change, back to the CRM while the context is fresh. This guide covers the one-time setup, what to expect from the OAuth flow, and how to start using the integration. ## What you can do with HubSpot in Tana Once HubSpot is connected, ask the AI in [chat](/learn/features/chat) to: - **Find contacts and companies**: search by name, email, company, or domain - **Read deal context**: list recent deals or pull a contact's deals into a meeting - **Log notes**: drop meeting takeaways onto a contact, company, or deal as a HubSpot note - **Create deals**: open a new deal and attach it to a contact or company - **Update lifecycle stage and properties**: move a contact from Lead to MQL, set a lead status, or write to any contact or company property You can also attach a [skill](/learn/features/skills#skills-on-types) to a type, so a HubSpot action like "log this to the deal" becomes one click on every item of that kind, the same for everyone on the team. ## Connect HubSpot You only need to do this once. The connection is per-account, not org-wide, so each teammate connects their own, and the AI acts in HubSpot with your access. Open Settings with or from the account menu in the sidebar, then open **Integrations**. Find **HubSpot** in the list and click **Connect**. {/* TODO screenshot: Tana Settings → Integrations panel with the HubSpot "Connect" button highlighted. */} A HubSpot authorization window opens. Sign in if you aren't already, and pick the HubSpot account you want to connect. {/* TODO screenshot: HubSpot account picker, the screen that appears when a user has access to more than one HubSpot account. */} Review the permissions HubSpot lists for Tana, then click **Connect app**. {/* TODO screenshot: HubSpot OAuth consent screen showing the scopes Tana is requesting. */} The popup closes and Tana shows **Connected** next to HubSpot, along with the account name. {/* TODO screenshot: Tana Settings → Integrations panel showing HubSpot in the connected state with the account name visible. */} If you have access to more than one HubSpot account, you'll pick one while authorizing. You can disconnect and reconnect later to switch accounts. ## Permissions Tana requests Tana asks HubSpot for the access it needs to read and write the records the AI works with: contacts, companies, deals, and notes. Tana never reads or writes anything outside the scopes you grant during connect. You can review or revoke Tana's access at any time from your HubSpot account under **Settings → Integrations → Connected Apps**. ## Use it in chat Once HubSpot is connected, the AI calls HubSpot tools whenever a prompt asks for it. Some prompts to try: - "What's the latest on the Acme deal? Pull the contact details and the open deals." - "Move Sarah Chen's lifecycle stage to MQL and set her lead status to Connected." - "Log this meeting as a note on the Acme deal and tag it to Sarah." - "Create a new deal called Acme expansion, attach it to Acme Corp, and set the stage to Discovery." {/* TODO screenshot: a Tana chat showing the AI calling a HubSpot tool, ideally the "log meeting note" prompt with the response card visible. */} The AI picks the right HubSpot tool from your prompt and asks for clarification only when something is ambiguous (for example, which Sarah, or which pipeline). ## Working with custom properties HubSpot fields use internal property names like `lifecyclestage` and `hs_lead_status`, and the values for those fields come from how your HubSpot account is configured ("MQL", "Customer", "Opportunity", and so on). If a prompt uses display names ("Marketing Qualified Lead"), the AI maps them to your account's values when it can, and asks if it can't. To update a custom property reliably, name the property and the value the way they're configured in HubSpot. ## Disconnect HubSpot To remove the connection from Tana: 1. Open Settings → **Integrations**. 2. Click **Disconnect** next to HubSpot. Disconnecting stops the AI from reading or writing to HubSpot but does not delete any data already in HubSpot or in Tana. To fully revoke Tana's access from HubSpot's side, also remove the Tana app under **Settings → Integrations → Connected Apps** in HubSpot. ## Troubleshooting **The AI says it can't reach HubSpot.** The connection has likely expired or been revoked. Reconnect from Settings → Integrations. **The AI created a record but I can't find it.** Records the AI creates are scoped to the HubSpot account you connected. If you have multiple HubSpot accounts, double-check you're looking at the right one. **A property update was rejected.** HubSpot rejects property updates when the value isn't on the configured option list (for example, writing "MQL" to a `lifecyclestage` that only has `lead`, `marketingqualifiedlead`, etc.). Use the value as it's configured in your HubSpot account. --- #### Connect Jira URL: https://tana.inc/learn/guides/connect-jira Set up the Jira integration so the AI can create and update issues from your meetings and conversations, and search projects and issues for context. Tana connects to your Jira account so the AI can turn what you discuss into filed and updated issues, without you switching tools. Talk through a bug or a task in a meeting or in chat, and the ticket gets created while the context is fresh. This guide walks through the one-time setup, what to expect from the authorization flow, and how to start using the integration in chat. ## What you can do with Jira in Tana Once Jira is connected, ask the AI in chat to: - **Create issues**: file a new issue from a discussion, with summary, description, type, priority, labels, assignee, and parent - **Update issues**: change fields on an existing issue, or move it through your workflow to a new status - **Search issues**: look up existing issues by keyword, useful for checking duplicates before you file a new one - **List projects**: see the projects you have access to, so issues land in the right place - **Attach meeting screenshots**: include screenshots shared on a call as links on the issue, so the ticket keeps its visual context You can also attach skills to Tana types that drive Jira actions one-click from your documents. See [Skills](/learn/features/skills) for how that works. ## Connect Jira You only need to do this once. The connection is per-account, not org-wide. 1. Open Settings with , or from the account menu in the sidebar. 2. Open **Integrations**. 3. Find **Jira** under personal integrations and click **Connect**. 4. An Atlassian authorization window opens. Sign in if you aren't already, and authorize the Jira site you want to connect. 5. Review the access Atlassian lists for Tana, then approve it. 6. The window closes and Tana shows **Connected** next to Jira. ## Permissions Tana requests Tana asks Atlassian for the access it needs to work with your issues and projects: reading projects and issues, and creating or updating issues. Tana never reads or writes anything outside what you approve during connect, and it does not request billing, admin, or organization-management access. Your access token is stored securely on Tana's servers, never in your browser. You can review or revoke Tana's access at any time from your Atlassian account settings, under connected apps. ## Use it in chat Once Jira is connected, the AI can call Jira tools when a prompt asks for it. Some prompts to try: - "Check Jira for open issues about the login bug, then file a new one if there isn't a duplicate." - "Create a Jira issue in the ENG project: write up the bug we just discussed, set priority to High, and assign it to me." - "Move ENG-412 to In Review and add a note about what changed." - "What projects do I have access to in Jira?" The AI picks the right Jira tool from your prompt and asks for clarification when something is ambiguous, for example which project, or which of two similar issues. ## How Tana files an issue A few things happen automatically when the AI creates or updates an issue: - **Duplicate check**: when you ask it to, the AI searches existing issues first, so you don't file the same bug twice. - **Formatted descriptions**: the AI writes the description in Jira's native format, so headings, lists, code, and links render properly in the issue. - **Screenshots as context**: if the issue comes from a meeting, the AI can attach screenshots shared on the call as links in the description. To change status, the AI uses your project's workflow transitions. It can only move an issue to a status your workflow allows from where the issue is now. ## Disconnect Jira To remove the connection from Tana: 1. Open Settings → **Integrations**. 2. Open the **Connected** menu next to Jira and choose **Disconnect**. The same menu has **Reconnect**, which you can use to refresh access or switch to a different site. Disconnecting stops the AI from reading or writing to Jira but does not change anything already in Jira or in Tana. To fully revoke Tana's access from Atlassian's side, also remove Tana from your Atlassian account's connected apps. ## Troubleshooting **The AI says it can't reach Jira.** The connection has likely expired or been revoked. Reconnect from Settings → Integrations. **You work across more than one Jira site.** Tana connects one Jira site at a time, the one you authorize when you connect. To point it at a different site, reconnect from Settings → Integrations and choose the other site. **A status change didn't work.** The AI can only move an issue along the transitions your workflow allows from its current status. If the path isn't available, change the status in Jira directly. --- #### Connect Linear URL: https://tana.inc/learn/guides/connect-linear Set up the Linear integration so the AI can create and update issues from your meetings and conversations, and search issues to avoid duplicates. Tana connects to your Linear workspace so the AI can turn what you discuss into filed and updated issues, without you switching tools. Talk through a bug or a task in a meeting or in chat, and the issue gets created while the context is fresh. This guide walks through the one-time setup, what to expect from the authorization flow, and how to start using the integration in chat. ## What you can do with Linear in Tana Once Linear is connected, ask the AI in chat to: - **Create issues**: file a new issue in a team, with title, description, priority, labels, assignee, and project - **Update issues**: change fields on an existing issue, or move it to a new workflow state - **Search issues**: look up existing issues by keyword, useful for checking duplicates before you file a new one - **List teams**: see the teams you have access to, so issues land in the right place - **Attach meeting screenshots**: include screenshots shared on a call in the issue description, so it keeps its visual context You can also attach skills to Tana types that drive Linear actions one-click from your documents. See [Skills](/learn/features/skills) for how that works. ## Connect Linear You only need to do this once. The connection is per-account, not org-wide. 1. Open Settings with , or from the account menu in the sidebar. 2. Open **Integrations**. 3. Find **Linear** under personal integrations and click **Connect**. 4. A Linear authorization window opens. Sign in if you aren't already. 5. Review the access Linear lists for Tana, then approve it. 6. The window closes and Tana shows **Connected** next to Linear. ## Permissions Tana requests Tana asks Linear for the access it needs to work with your issues: reading your teams and issues, and creating or updating issues. Tana never reads or writes anything outside what you approve during connect. Your access token is stored securely on Tana's servers, never in your browser. You can review or revoke Tana's access at any time from your Linear account settings. ## Use it in chat Once Linear is connected, the AI can call Linear tools when a prompt asks for it. Some prompts to try: - "Check Linear for open issues about the login bug, then file a new one if there isn't a duplicate." - "Create a Linear issue on the Web team: write up the bug we just discussed and set priority to High." - "Move ENG-241 to In Review." - "What teams do I have access to in Linear?" The AI picks the right Linear tool from your prompt and asks for clarification when something is ambiguous, for example which team, or which of two similar issues. ## How Tana files an issue A few things happen automatically when the AI creates or updates an issue: - **Duplicate check**: when you ask it to, the AI searches existing issues first, so you don't file the same bug twice. - **Formatted descriptions**: the AI writes the description in markdown, which Linear renders natively. - **Screenshots as context**: if the issue comes from a meeting, the AI can embed screenshots shared on the call in the description. To change status, the AI moves the issue to another workflow state in its team. ## Disconnect Linear To remove the connection from Tana: 1. Open Settings → **Integrations**. 2. Open the **Connected** menu next to Linear and choose **Disconnect**. The same menu has **Reconnect**, which you can use to refresh access. Disconnecting stops the AI from reading or writing to Linear but does not change anything already in Linear or in Tana. To fully revoke Tana's access from Linear's side, also revoke it from your Linear account settings. ## Troubleshooting **The AI says it can't reach Linear.** The connection has likely expired or been revoked. Reconnect from Settings → Integrations. **You're not sure where an issue landed.** The AI returns a link to each issue it creates, so open that to jump straight to it in Linear. **A status change didn't work.** The AI can only move an issue to a workflow state that exists in its team. If the state you want isn't there, set it in Linear directly. **Something else?** See [Integrations](/learn/features/integrations) for the broader integration overview, or reach out at [support@tana.inc](mailto:support@tana.inc). --- #### Connect Pipedrive URL: https://tana.inc/learn/guides/connect-pipedrive Set up the Pipedrive integration so the AI can find contacts, companies, and deals, log notes to your CRM, and create or update records from your meetings and conversations. Tana connects to your Pipedrive account so the AI can pull CRM context into meeting prep and push outcomes back to Pipedrive, without you switching tools. This guide walks through the one-time setup, what to expect from the authorization flow, and how to start using the integration in chat. ## What you can do with Pipedrive in Tana Once Pipedrive is connected, ask the AI in chat to: - **Find people and companies**: search persons by name, email, or phone, and organizations by name - **Read a person's details**: pull a contact's full profile when you need more than the search result - **List deals**: see recent deals, optionally filtered by status such as open, won, or lost - **Log notes**: add a note to a person, an organization, or a deal - **Create deals**: open a new deal with a title, value, and currency, linked to a person or organization - **Update records**: change a person or organization's name, owner, labels, or custom fields, and link a person to an organization You can also attach skills to Tana types that drive Pipedrive actions one-click from your documents. See [Skills](/learn/features/skills) for how that works. ## Connect Pipedrive You only need to do this once. The connection is per-account, not org-wide. 1. Open Settings with , or from the account menu in the sidebar. 2. Open **Integrations**. 3. Find **Pipedrive** in the list and click **Connect**. 4. A Pipedrive authorization window opens. Sign in if you aren't already. 5. Review the access Pipedrive lists for Tana, then approve it. 6. The window closes and Tana shows **Connected** next to Pipedrive. ## Permissions Tana requests Tana asks Pipedrive for the access it needs to work with your CRM records: reading persons, organizations, and deals, and creating or updating persons, organizations, deals, and notes. Tana never reads or writes anything outside what you approve during connect. Your access token is stored securely on Tana's servers, never in your browser. You can review or revoke Tana's access at any time from your Pipedrive account settings. ## Use it in chat Once Pipedrive is connected, the AI can call Pipedrive tools when a prompt asks for it. Some prompts to try: - "What's the latest on the Acme deal? Find the contact and their open deals." - "Log this meeting as a note on Sarah Chen and on the Acme expansion deal." - "Create a deal called Acme expansion worth 48000 USD and link it to Acme Corp." - "Update Sarah Chen and link her to the Acme Corp organization." The AI picks the right Pipedrive tool from your prompt and asks for clarification when something is ambiguous, for example which Sarah, or which deal. ## Working with custom fields Pipedrive custom fields are identified by an internal field key, and their values come from how your Pipedrive account is configured. The AI can set custom fields when you name the field and the value, but for reliable updates, refer to them the way they are configured in Pipedrive. Updating labels or custom fields replaces the existing values on that record. ## Disconnect Pipedrive To remove the connection from Tana: 1. Open Settings → **Integrations**. 2. Click **Disconnect** next to Pipedrive. Disconnecting stops the AI from reading or writing to Pipedrive but does not change anything already in Pipedrive or in Tana. To fully revoke Tana's access from Pipedrive's side, also remove it from your installed apps in your Pipedrive account settings. ## Troubleshooting **The AI says it can't reach Pipedrive.** The connection has likely expired or been revoked. Reconnect from Settings → Integrations. **The AI created a record but I can't find it.** Records the AI creates are scoped to the Pipedrive account you connected. If you have access to more than one Pipedrive account, double-check you're looking at the right one. **A custom field update was rejected.** Pipedrive rejects updates when the value isn't valid for how the field is configured. Use the field key and the value as they are set up in your Pipedrive account. **Something else?** See [Integrations](/learn/features/integrations) for the broader integration overview, or reach out at [support@tana.inc](mailto:support@tana.inc). --- #### Create AI agents with skills and integrations URL: https://tana.inc/learn/guides/agents-and-skills Create your own AI agents in Tana just by describing them: assistants you equip with skills and integrations that work on demand, in meetings, or on a schedule. {/* DRAFT for review. Doubles as the narration spine for a short explainer. */} You can create your own AI agents in Tana just by describing what you want. No setup, no prompt engineering. An agent is an assistant you delegate to. You equip it with **skills** (reusable instructions) and **integrations** (connected tools like GitHub, Slack, and Linear), and it works for you on demand, in a meeting, or on a schedule while you sleep. And because agents and skills are shared, building a good one is something your whole team gets, not just you. ## What an agent is An [agent](/learn/features/agents) is an assistant you configure for a job and then talk to. It has its own prompt, its capabilities, an optional voice, and an optional [schedule](/learn/features/agents#schedules). Converse with it in chat or by voice, or set it to run on its own. Keep an agent to yourself, share it with a teammate, or open it to the whole org. A capability one person builds becomes the team's with nothing extra to set up, and a useful agent becomes a shared teammate. ## What you equip it with An agent's [capabilities](/learn/features/agents#agent-capabilities) decide what it can do, in two parts: - **Skills** are reusable instructions for specific jobs: "file this as a GitHub issue," "summarize this meeting in our format," "draft a PRD from these notes." A skill does the same job the same way every time, for everyone who uses it, so your whole team files bugs or drafts PRDs in one consistent shape. You can also run a skill on its own, with `/` in [chat](/learn/features/chat), from an item's **Send to** menu, or from the Skills button in a [meeting](/learn/features/meetings#during-the-call). - **Integrations** connect the agent to your tools, like GitHub, Slack, and Linear, so it can act in them rather than just talk about them. You toggle both on in the agent's Customize panel; together they set what the agent can read, create, and reach. ## Build a meeting-prep agent You do not configure agents by hand, you describe them. Here is the whole flow, building one agent that preps you before every meeting, the job [Walk into every meeting prepared](/learn/guides/prepare-for-meetings) puts on autopilot. Click the pencil button at the top of the sidebar, or ask in [chat](/learn/features/chat): "Create an agent that preps me for every meeting by pulling context on the people I'm meeting with and what we discussed last time." Tana scaffolds the agent from that one description: its prompt, a name, and a starting set of capabilities. Open the agent's Customize panel and give it what the job needs. Turn on a [skill](/learn/features/skills) that writes the prep in your format ("summarize our last meeting and list open items per attendee"), and an [integration](/learn/features/integrations) when the context lives in another tool, like Slack or your CRM. Together, skills and integrations set what the agent can read, create, and reach. Not quite right? Tell it: "also include any open tasks assigned to the people in the meeting." You refine an agent the same way you created it, in plain language, never by editing settings by hand. See [Agents](/learn/features/agents#creating-an-agent) for the full reference. Now choose when it runs: - **Chat or voice**, when you want to ask it for a prep on demand. - **On a [schedule](/learn/features/agents#schedules)**, so it runs while you sleep and tomorrow's preps are waiting in your Library each morning. - **As a space's default assistant**, picking up new chats started in your team's space. Because the agent is a doc, you can keep this one to yourself or share it so the whole team gets the same prep. The more of your repeatable work you hand to agents, the more Tana does on its own, so you spend your time on the conversation, not the busywork. --- #### Getting started with Tana URL: https://tana.inc/learn/guides/getting-started New to Tana? The fastest way to see what it does is to run a meeting with a colleague and watch the conversation turn into finished work your team shares, no setup needed. {/* DRAFT for review. Front door for a brand-new, empty-workspace user. Cold-start aware (the conversation is the input; chat creates from scratch, it does not query data you do not have yet). Drives the key activation move: invite a colleague and collaborate. */} Tana is an agentic meeting platform built for teams. You hold your meetings in it, and as you talk the AI turns the conversation into finished work, a filed bug, a logged decision, a drafted recap, that you review before anything lands. You are starting with a clean slate, and that is fine: you do not need to fill it first, because the conversation is the input. The single best way to see what Tana does, and the move that matters most, is to run a meeting with a colleague. ## Run your first meeting, with someone You need no setup and no existing notes. From the [Today](/learn/features/today) view, open the create menu (the pencil icon in the sidebar) and choose **Meeting** to get a call link. **Invite a teammate** from your organization, or send the guest link to anyone outside it, they join with just a name, no account. Then click **Join Meeting**. Have a real conversation, a planning chat, a bug triage, a quick design look. You are not taking notes. When something concrete comes up, hit the **+** in the call toolbar, pick how far back to look, and choose what it is, a bug, a decision, a task, and Tana drafts it from that part of the talk. When the call ends, it writes the summary and pulls out anything you missed. You review each outcome, edit what is off, and accept what you want. Because the meeting is shared, everyone in it has that work right away. That is the whole point: a conversation becomes finished work your team can act on, with no write-up. ## Try it on your own first Want a quick taste before you pull anyone in? Start a [chat](/learn/features/chat) from Today and ask the AI to make something from scratch: - "Draft a one-page PRD for a referral feature." - "Turn these rough notes into a project plan." (paste the notes) - "Outline a technical spec for a rate limiter." Everything it produces is yours to review and keep. Chat gets far more powerful as you go, once you have meetings and have connected tools like [GitHub](/learn/guides/connect-github) or [Linear](/learn/guides/connect-linear), it draws on everything your team has done and acts in the tools you already use. ## What is worth knowing early - **The AI [proposes](/learn/features/proposals), you decide.** Everything you would act on, outcomes, docs, edits, lands as a proposal you review and approve first. The one thing it writes for you automatically is the meeting summary. That control is what makes it safe to let the AI do real work. - **Everything you create stays in your [Library](/learn/guides/organize-your-context)**, findable from the start. No setup, and nothing gets lost. - **Add structure only when it earns its keep.** Once you are making many of a kind, bugs, clients, decisions, give them a [type](/learn/guides/organize-your-context) so they share fields and land on a board. When a body of work needs its own people, put it in a space, and where something lives is also who can see it. - **It compounds.** Every meeting and chat feeds your shared context, so a few weeks in you can [ask](/learn/guides/catch-up-and-act) "what did we decide about this, and why" and get an answer grounded in your team's actual work. ## Get your team in This is the step that changes everything. Tana is built for working together, and almost nothing about it is as good alone: shared meetings, shared outcomes, a context that the whole team builds and draws on. Invite the people you actually work with, and the next meeting you run together already produces work everyone has, while the AI gets sharper about your decisions, your roadmap, and your code with every conversation. When you are ready for the daily rhythm, [How to work in Tana](/learn/guides/how-to-work-in-tana) goes deeper. --- #### How to work with your team in Tana URL: https://tana.inc/learn/guides/how-to-work-in-tana The recommended way for a product or tech team to work in Tana together: how meetings turn into finished work, where to capture, when to add spaces and types, and what a productive day looks like. {/* DRAFT for review. Orientation cornerstone for the Guides section; the other guides link back to this one. Written for the launch ICP (product and tech teams). */} Tana is an agentic meeting platform: your team meets in it, and the AI turns those conversations into finished work, bugs filed, PRDs drafted, decisions logged, before the call ends. It is collaborative from the first meeting. The work the AI produces is shared, so teammates pick it up without a handoff, and the context builds for everyone. This guide is the recommended way to work in it together: how the loop runs, how to set up, and what a productive day looks like. You do not need to set much up to start. Read this once for the shape, then let structure grow as your work earns it. ## The core loop: meetings in, finished work out One loop sits at the center of Tana, and everything else serves it. 1. **You meet.** Hold the call in Tana, or [capture an external Zoom, Teams, or Meet call](/learn/guides/capture-external-meetings) from the desktop app. Tana transcribes as you talk and reads any screen you share. 2. **The AI does the work, live.** As the conversation happens, it pulls out the real outputs, a bug with steps to reproduce, a decision with its rationale, a drafted PRD, and can file them straight into Linear, GitHub, or your other tools. 3. **You approve.** Nothing lands on its own. Every change arrives as a [proposal](/learn/features/proposals) you review, edit, and accept. 4. **Outcomes scatter.** Once accepted, tasks show up in your [Tasks](/learn/features/tasks) view, docs and artifacts in the right space, issues in your tracker, ready for whoever needs them. The shift to feel: you are not taking notes to process later. The work takes shape during the conversation, and you leave the call with it mostly done. Two things make this safe to rely on. The **proposal gate** means the AI can draft, file, and update, but you see every change before it happens, so nothing silently lands in your team's space. And **what's captured** is only the transcript and the screens you share, never anyone's camera or face. For sensitive moments, [off the record](/learn/features/meetings#off-the-record) pauses all capture for everyone. ## What you're working with A few building blocks, in roughly the order you meet them: - **[Meetings](/learn/features/meetings)** are the main way work gets in: video, transcription, screen capture, and live capture of outcomes. - **[Proposals](/learn/features/proposals)** are the review gate: every AI change, seen before it lands. - **The [Library](/learn/features/interface)** is where everything your team creates lives and stays findable, even before you add any structure. - **Spaces and types** are how you add structure once it earns its keep: a [space](/learn/features/spaces) is where a team works together, with its own members and shared context; a [type](/learn/features/types) is for a kind of thing you have many of, like Bug or Decision. - **[Agents](/learn/features/agents) and [skills](/learn/features/skills)** are how you make the AI yours: reusable instructions and assistants that do recurring work your way. Meeting and Task are built in. Bug, Decision, and the rest are types you define, so they carry the fields your team cares about. For how spaces and types fit together, see [Manage your context with spaces and types](/learn/guides/organize-your-context). ## Set yourself up You can do real work on day one with almost no setup. The light path: 1. **Connect your calendar** so your meetings show up in the [Today](/learn/features/today) view, your daily home. 2. **Capture into the Library to start.** Quick notes, chats, and meeting outcomes all land there and stay searchable. No structure required. 3. **Add a type when a kind repeats.** Once you have filed a few bugs or logged a few decisions by hand, make a Bug or Decision type so they share fields and the AI files new ones in the same shape. 4. **Add a space when work needs its own people.** A team, or a major project: a space carries its own members, types, and AI instructions. The rule of thumb: let structure follow the work, not precede it. ## A day in Tana Here is the loop across a real day on a product or tech team. **Before a meeting.** Open the Today view to see what's coming, then ask the AI to prep you: "pull what we decided with Acme last month and any open bugs they reported." An [agent](/learn/features/agents) can do this on a [schedule](/learn/features/agents#schedules), so the prep is waiting each morning. **During standup.** A bug comes up. Capture it as you talk, and Tana files it in Linear with steps to reproduce and a screenshot from the shared screen, before standup ends. No after-the-fact triage, and the whole team sees it land. **In a customer interview.** Tana extracts the pain points, drafts a customer-journey [artifact](/learn/features/artifacts), and starts a PRD from what was actually said. You share it with the team minutes after the call. **In a design review.** Feedback lands on the right issues, updated in place with the screenshot of what was on screen, so the designer leaves with the work tracked rather than a pile of notes to reconstruct. **Right after.** Review the proposals the meeting produced, the summary, the outcomes, the issues. Edit anything that needs it, then accept. This is the one habit worth keeping: review before you move on. **End of day.** Check your [Tasks](/learn/features/tasks) view for what you and the team committed to, and pin anything urgent to tomorrow. The payoff to notice: every one of these leaves a real artifact, in the tool your team already uses, with no separate write-up step. ## Working as a team Tana is most valuable with your team in it, and getting them there is low-friction. **Adoption is joining a call.** When you run a meeting in Tana, everyone in it is working with the AI, with no setup or training. That is the simplest way to get a team using AI together, instead of each person stitching together their own stack of note-takers, bots, and tools. **Share outcomes, not just meetings.** A decision or task can go to people who were not in the room, so the right colleagues see the result without the whole transcript. Where something lives decides who can see it, so a private space stays private and shared work reaches the team. See [Spaces and sharing](/learn/features/spaces#access-modes). **Context compounds.** Every meeting feeds a shared memory. After a few weeks, "what did we decide about auth, and why?" has an answer grounded in the actual calls. The more your team works in Tana, the sharper the AI gets about your codebase, your roadmap, and your decisions. --- #### Manage your context with spaces and types URL: https://tana.inc/learn/guides/organize-your-context How items, spaces, and types fit together in Tana, when to reach for each, and how where something lives decides who on your team can see and work on it. {/* DRAFT for review. Doubles as the narration spine for a walkthrough. The "Spaces vs types" model below reflects Theo's guidance (type = a kind you have many of; space = a few broad collaborative contexts; relate via link fields) and is the key thing to confirm before publishing. */} You can start using Tana without setting anything up. Much of your context is born in [meetings](/learn/features/meetings) and [chats](/learn/features/chat), the tasks, decisions, and notes a conversation leaves behind. All of it lands in your **Library**, always within reach. You add structure, spaces and types, only once it earns its keep. It earns it three ways: - it **shapes** the work, with shared fields and relationships - it makes the work **easy to find** later, for you, your team, and the AI - it sets **who can see and act** on it That last one is in play from day one. Tana is built for working together. This guide walks through how items, spaces, and types fit together, and closes with a simple way to decide what to add and when. ## The Library holds everything The **[Library](/learn/features/interface#library)** is the single view of everything in your organization. It opens as a grid of **space cards**, with one **filter bar** (shared with [Search](/learn/features/interface#search)) to narrow things down. Anything that does not live in a space or on a meeting lives here. So before anyone makes a space or type, the Library already holds everything you and your team create, and nothing gets lost. This is the foundation: spaces and types are not separate places you move things into. They are organizing layers that show up _within_ the Library. The filter bar's round pills scope to a space, jump straight to meetings or chats, filter by who created an item, or open the type palette for any kind, your own types included. Think of the Library as the map your whole team shares, and spaces and types as structure drawn onto it. ## Spaces vs types: when to use which Two ways to add structure, for two different jobs. Use a **[type](/learn/features/types)** for a _kind of thing you have a lot of_: clients, bugs, candidates, invoices. A type gives every item of that kind the same fields, and lets you connect items to each other with link fields. Reach for one whenever you will create many of something and want to filter, track, or relate them. A Client, for instance, can carry fields like industry, owner, and renewal date, and your other items can link to it. Use a **[space](/learn/features/spaces)** for a _broad area of work that has its own people and context_: a team, a major project, a domain you work in. You will have a handful of spaces, not hundreds. Each one carries its own members, its own types and skills, and its own AI instructions. Spaces can nest. A space can hold [sub-spaces](/learn/features/spaces#nested-spaces) for real sub-areas with their own people, like a department space with a sub-space per team. But resist a Clients space with a sub-space per client: you would drown in spaces as your business takes off. Keep one space for the team that works with clients, make Client a type, and link your items to the right client. (With only a handful of clients total, a space each can be fine. Scale decides.) And you do not always need either. Plenty of work is fine living in your Library with no type and no space, until a repeating pattern, or a person you want to share with, makes the structure worth adding. ## What a space gives you A space is where collaboration happens. Adding someone to a space gives them access to everything in it, so a space is as much about _who works on this_ as _what goes in it_. On top of shared access, a space gives that work: - its **members**, and the access that flows from them - its own **[types](/learn/features/types)** and **[skills](/learn/features/skills)** - **AI instructions** that shape how the AI behaves for that work A chat or meeting inside a space follows that space's AI instructions and draws on its types and content, so the AI works the way that team needs. Access flows downward: from the organization, to a space, to an item. Deciding where something lives is also deciding who can see it. See [Spaces and sharing](/learn/features/spaces#access-modes). ## Where things land, and who can see them Whenever you create or capture an item, in a chat, in a meeting, or directly, it lives somewhere: in your Library, or inside a space. Where it lives sets two things at once: - **What it is:** give it a [type](/learn/features/types) to add structure, or leave it plain. - **Who can see it:** an item inherits the access of where it lives. Something in a private space is visible only to that space's members; something in your Library, at the organization level, is visible to everyone in the org. You can set this when you create the item, or move it later from its [location](/learn/features/docs#location-and-access) controls. When the AI proposes a new item, it shows where it will live before you accept, so you can redirect it into the right space. ## Retrieving context Pulling context back when you need it is the other half of managing your context. It works three ways, and spaces and types are what make them sharp: you can navigate to your work, ask the AI to surface it, or let what your team is doing come to you. **Navigate to it.** Start with the **Library**: type a query, or filter by space, by who created an item, or by type. Two focused views build on the same structure: - A **space home** is the dashboard for one space your team shares: its pinned items, a card for each [type](/learn/features/types#the-type-page) in it, and its content list. - A **[type page](/learn/features/types#the-type-page)** lists every item of a type, as a list or as a [kanban board](/learn/features/types#the-kanban-board) when the type has a workflow, so you get "all open Bugs" across the team in one place. **Ask the AI to surface it.** Because your work carries types and lives in spaces, the AI can pull it up the way you would describe it: "show me open bugs for Acme," "what did we decide in last week's planning meeting." A [chat](/learn/features/chat) inside a space also follows that space's AI instructions and draws on its content, so its answers stay grounded in the right context. **Let it come to you.** [Activity](/learn/features/interface#activity) sits right under Today, a two-column dashboard. **Notifications** gathers what teammates did that involves you: added you to a document or meeting, assigned you a task, started a chat, or are waiting in a call. **Recents** is a running list of recently updated items across your team. Click any entry to jump to the source, so the work that needs you finds you. Spaces and types are layers within the Library, so anything you structure stays within reach there too. You never choose between structure and retrieval. Structure just gives you sharper ways to slice the same map, by hand or by asking. ## A simple way to start When you are not sure what to add, let the work tell you: 1. **Start in your Library.** Capture and create freely, with no type and no space. There is nothing to set up, and nothing gets lost. 2. **Add a type when you have many of one kind.** The moment you are creating clients, bugs, or candidates and want to filter, track, or relate them, give them a [type](/learn/features/types) so they share fields and connect to each other. 3. **Add a space when work needs its own people and context.** A team, a major project, a domain you work in: anything that wants its own members, skills, and AI instructions. Keep spaces few. 4. **Relate items with link fields, not more spaces.** When two kinds of work connect, link them with a field rather than spinning up a space for each. A Bug can carry a field pointing to the Feature it affects, so you can move between them without either needing its own space. You can always add structure later, and move an item to a new home once its shape is clear. Structure is something you grow into, not a decision you make up front. --- #### Tana Tutorials: The Basics of Tana URL: https://tana.inc/learn/guides/tana-learn-live-basics A recorded walkthrough of the basics in Tana and how they fit together: run a meeting, review the proposals it drafts, send the work to your tools, and organize everything with spaces and types so it stays findable. A guided walkthrough of the basics in Tana, the agentic meeting platform, and how the pieces fit together. You run a meeting, watch the AI draft proposals from what was said and shown, review and accept the ones you want, send that work to the tools you already use, and organize everything with spaces and types so your team can find it later. It is the fastest way to see the whole loop end to end. ## What Tana is [[0:00](https://youtu.be/lgZhRrXPf0M?t=0)] Tana brings AI and agents into the meeting itself, so you complete work as you talk instead of leaving with notes to process later. It sees both what is said and what is shared on screen, and closes the gap between the conversation and execution: you come out with work that is more or less ready to go, shipped to where work actually happens. See [Getting started](/learn/guides/getting-started) for the same idea in writing. ## Spaces [[3:14](https://youtu.be/lgZhRrXPf0M?t=194)] A [space](/learn/features/spaces) is a container for related work, like a folder or a project, with its own access control: everyone in the org, just you, or a named few. Everything you put in it inherits those permissions. You can also `@`-mention a whole space in a [chat](/learn/features/chat) to use it as reusable context, which is what sets Tana apart from a standalone AI tool. ## Types [[4:22](https://youtu.be/lgZhRrXPf0M?t=262)] A [type](/learn/features/types) (the equivalent of a supertag in Tana Outliner) says what something is: a bug, a dev task, a person. That helps the AI treat it correctly, gives it a template of fields like severity, and lets you link types together, for example an issue linked to a product area. [Track issues with a type](/learn/guides/track-issues-with-a-type) goes deeper. ## Inside a finished meeting [[7:28](https://youtu.be/lgZhRrXPf0M?t=448)] The walkthrough opens just after a meeting, in the after-meeting view: a digest with a title and description, the full raw transcript behind it, and the sections Tana draws out live while you speak. Everything here is collaborative with the people in your org from the start. ## The summary, and sharing [[8:31](https://youtu.be/lgZhRrXPf0M?t=511)] Tana writes a rich [summary](/learn/features/meetings) automatically. Every item carries its own access control, not just spaces, so you can hand a single summary to a customer with a guest link, or keep it to selected people, without changing anything else. ## Wrap-up and proposals [[10:09](https://youtu.be/lgZhRrXPf0M?t=609)] When the meeting ends, the wrap-up writes the summary, makes sure the digest is accurate, and drafts [proposals](/learn/features/proposals) for the actions that came up. In the demo that includes updating an existing issue with new customer-discovery context. You review each one and decide what lands, so everyone with access gets the richer context at once. ## Send work to your tools [[11:17](https://youtu.be/lgZhRrXPf0M?t=677)] From a proposal you can send the work, with its context, to Linear, Jira, or GitHub, or hand it to a coding agent like Claude Code that spins up a session and starts on the issue. You set these up once in Settings, then Integrations. See [Connect GitHub](/learn/guides/connect-github), [Connect Linear](/learn/guides/connect-linear), and [Integrations](/learn/features/integrations). ## Working during the meeting [[13:22](https://youtu.be/lgZhRrXPf0M?t=802)] Live, you have your call tiles, the live digest, and pinned talking points. The `+` menu is where you capture as you go: search for what you discussed and capture it from the last couple of minutes. Context is not just the transcript, if someone is sharing their screen, Tana takes that into account too, so the outcomes are richer. ## Every proposal has a type [[15:35](https://youtu.be/lgZhRrXPf0M?t=935)] Each proposal is labeled with its [type](/learn/features/types), issue, feature request, company, deal, and the AI considers what kind of thing it is while extracting. Because types carry fields and can have a skill attached (say, one that always sends issues to GitHub), this is what makes more powerful workflows possible. ## The Library [[16:50](https://youtu.be/lgZhRrXPf0M?t=1010)] Everything you create in Tana lives in the [Library](/learn/guides/organize-your-context): documents, tasks, artifacts, types, chats. Spaces are containers inside it, and they are where access control lives, the product space shared with the whole org, a research space limited to a few people. ## Browse and filter [[19:05](https://youtu.be/lgZhRrXPf0M?t=1145)] The Library is built for browsing. Filters let you see just meetings (today, upcoming, shared, or with a specific person), or switch to chats, canvases, agents, skills, artifacts, spaces, and types. [Organize your context](/learn/guides/organize-your-context) covers the model. ## Today, and the chat bar [[21:00](https://youtu.be/lgZhRrXPf0M?t=1260)] [Today](/learn/features/today) shows your meetings and a chat bar. The [chat](/learn/features/chat) AI has the same tools you do, plus current knowledge of Tana itself, so it can both do the work and explain how the app works. ## From a feature request to a PRD [[21:55](https://youtu.be/lgZhRrXPf0M?t=1315)] The session ends by running a [skill](/learn/features/skills), reusable instructions you save and rerun, to turn a captured customer feature request into a full product spec, by voice. Because the feature request holds the customer's own words and quotes, the spec links back to the source and flags open questions, shortening the path from a customer conversation to built product. --- #### Use Tana with Claude URL: https://tana.inc/learn/guides/use-tana-with-claude Connect Tana to Claude so you can pull meetings, tasks, and team knowledge into a Claude conversation as context, and save new docs and tasks back to Tana, with every write reviewed as a proposal first. Connect Tana to Claude so you can use your team's meetings, tasks, decisions, and documents as context in a Claude conversation, then save new work back into Tana when you're done. Tana connects to Claude through the Model Context Protocol (MCP), an open standard that lets Claude read from and write to external tools. Once connected, Claude can pull documents, meeting notes, and structured data out of Tana for context, and propose new content back into Tana. This guide covers the one-time setup, what Claude can access, and how to use the connection. ## What you can do with Tana in Claude Once Tana is connected, ask Claude to: **Pull context out of Tana** - **Get meeting context**: read transcripts, screen-share screenshots, attendees, and attached artifacts from a meeting - **Work with tasks**: list open tasks, or plan work from an existing task - **Search Tana**: full-text and semantic search across spaces for notes, docs, and decisions - **Read a specific document**: pull up a design doc, spec, or typed entry with all its fields - **Check calendar events**: see what's on today, or prep an upcoming meeting from its details **Save work back to Tana** - **Create documents**: save a summary, spec, or recap as a doc in Tana - **Create typed entries**: file a Bug, log a Decision, or add any typed document with the right fields - **Create and update tasks**: add follow-ups, or break an existing task into sub-tasks - **Update existing documents**: append notes or edits to a doc already in Tana Every change Claude makes is a **proposal** you review and approve in Tana. See [Working with proposals](#working-with-proposals) below. Nothing is written without your confirmation. ## Connect Tana to Claude You only need to do this once. The connection is per-account. Tana isn't in Claude's built-in connector directory yet, so you add it as a custom connector using Tana's MCP server URL: `https://home.tana.inc/mcp`. In Tana, **Settings → MCP** has a one-click copy for the URL and ready-made setup snippets. ### In Claude Code Add Tana with a single command: ``` claude mcp add tana --transport http https://home.tana.inc/mcp ``` The first time you use it, Claude Code walks you through signing in to Tana. ### In Claude Desktop or claude.ai Claude connects to Tana through Anthropic's connectors flow: 1. In Claude, open **Settings**, then **Connectors**. 2. Choose **Add custom connector**. 3. Paste the Tana MCP server URL: `https://home.tana.inc/mcp`. 4. Click **Connect**. A Tana sign-in window opens. Sign in if you aren't already, and grant access to the organization you want to connect. 5. The window closes and Tana shows as a connected tool in Claude. {/* TODO screenshot: Claude's "Add custom connector" dialog with the Tana MCP URL entered. */} Custom connectors are available on all Claude plans; free accounts can keep one at a time. For the latest steps on Claude's side, see Anthropic's guide to [custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). You can now reference Tana in any Claude conversation. ## What Claude can access Claude works only with the content in the organization you connected, and only when a prompt asks for it: - **Search**: full-text and semantic search across your spaces - **Read**: notes, typed entries and their fields, tables, backlinks - **Meetings**: transcripts, screen-share screenshots, event details, attendees, artifacts - **Files**: text-based attachments like markdown, CSV, and plain text, plus images; other files come back as metadata such as name, type, and size - **Create**: documents, tasks, and typed entries - **Update**: text, fields, task state, assignments, tables - **Delete**: remove documents, with your approval The Tana connector reads and writes only your Tana content. It does not access your Claude memory, chat history, or files you've uploaded to Claude. Tana captures the shared screen during a meeting, not participants' camera video, so the screen-share screenshots Claude can read never include people's faces. ## Using Tana in Claude Ask in plain language; Claude picks the right Tana tool from your prompt. Some prompts to try: - "Read the transcript from yesterday's standup in Tana." - "Find my notes about the Q3 roadmap in Tana." - "List all open bugs in Tana" or "Show me all Feature Requests assigned to me." - "Prep my 2 pm meeting: read the details and attached artifacts." - "Save this summary as a doc in Tana called 'API Migration Plan'." - "Add a task in Tana to review the pull request by Friday." ### Example workflows **1. Turn meeting outcomes into a draft** > "Read the transcript and outcomes from yesterday's design sync in Tana, then draft a one-page recap with agreed decisions and owners I can paste into Slack." Claude finds the event, reads the transcript and any pinned artifacts, and produces a recap grounded in what was actually said. It's read-only, so nothing is written to Tana. **2. Research across Tana and draft a spec** > "Search Tana for everything related to our authentication system, the bugs, design docs, and decisions, then draft a technical spec for the new SSO feature, citing the source docs." Claude searches across your spaces, reads each match, and produces a spec that links back to the source documents in Tana. Useful when context is scattered across many notes and meetings. **3. Capture work output back in Tana** > "I just finished this Q2 metrics analysis. Create a doc in Tana titled 'Q2 Metrics Analysis' with the content above, and create three follow-up tasks for the action items." Claude proposes the document and three tasks. They appear in Tana for review. You approve them and they land in Tana. ## Working with proposals Every write Claude makes, whether creating a document, updating a field, or deleting an item, goes through Tana's proposal system. The change appears as a pending proposal in Tana that you review and approve before it takes effect. This is the same review loop Tana's own Chat uses, so nothing is added, changed, or removed in Tana without your confirmation. To view proposals created from external tools like Claude, click **Browse** in the sidebar, then view **Chats**. Always check proposals before approving, especially updates to existing documents. See [Proposals](/learn/features/proposals) for how the review surface works. ## Tips - **Be specific about spaces**: if similar document names exist in different spaces, mention the space so Claude finds the right one. - **Reference meetings by date or title**: Claude can look up events by date range or by name. - **Ask for a specific kind of document**: a Bug or a Decision lands with the right fields, in the right space. ## Disconnect Tana To remove the connection in Claude Code: ``` claude mcp remove tana ``` In Claude Desktop or claude.ai, open **Settings**, then **Connectors**, and disconnect **Tana**. Disconnecting stops Claude from reading or writing to Tana. It does not delete any data already in Tana. You can also review or revoke access from your Tana account settings. ## Troubleshooting **Claude says it can't reach Tana.** The connection has likely expired or been revoked. Reconnect with the steps above. **Claude can't find a document.** Paste the document's Tana link straight into the conversation and Claude opens exactly that item, no searching needed. Otherwise, name the space, or reference the item by its type or exact title. Semantic search helps when you don't remember the exact wording. **A proposal didn't appear in Tana.** Proposals land in the organization you connected. If you have access to more than one, confirm you're looking at the right one. --- #### Walk into every meeting prepared URL: https://tana.inc/learn/guides/prepare-for-meetings Ask Tana to draft your meeting prep from your team's record, capture it as a reusable skill so it runs the same way every time, then hand that skill to an agent on a schedule so a prep is waiting before every meeting. {/* DRAFT for review. Teaching exemplar: the steps are the lesson. Uses meeting prep to teach the ask -> skill -> scheduled-agent escalation. Skills are the centerpiece; agent-building is handed off to agents-and-skills rather than duplicated. */} Good meetings start before the meeting. But prep usually means digging: who is this person again, what did we decide last time, what is still open, what should I cover. That is the scramble in the five minutes before the call, if it happens at all. This guide gets you out of that scramble, and along the way it teaches a pattern you will reach for constantly in Tana: do something once by asking, capture it as a [skill](/learn/features/skills) so it runs the same way every time, then hand that skill to an [agent](/learn/features/agents) so it happens without you. Meeting prep is the example. The climb from a one-off ask, to a reusable skill, to a scheduled agent is the real lesson. ## From one ask to automatic prep Open a [chat](/learn/features/chat) and say who and what: _"Prep me for my 2pm with Acme. Pull what we decided last time, any open issues they reported, and who I am meeting."_ Tana drafts the prep from your team's own record: the past meetings with these people, the decisions that came out of them, the issues still open, and the people involved. With your CRM [connected](/learn/guides/connect-hubspot) it folds in the deal and contact history. Because it works within your permissions and only from what your team actually recorded, the result is grounded in real context, not a generic briefing. Spend a moment getting the shape right, which items to pull and how to lay them out, because that shape is the thing you are about to make permanent. You do not want to retype that prompt before every meeting, and you want the prep to come out the same way each time. That is exactly what a [skill](/learn/features/skills) is: reusable AI instructions you write once and run whenever you need them. The fastest way to make one is to ask. Right after Tana gives you a prep you like, tell it to _"save that as a skill called Meeting prep"_, and it turns the instructions it just followed into a reusable skill, no setup and no prompt engineering. You can still open and edit it by hand, or build one from the create menu, but describing it to the AI is the normal path. Either way a skill is just a title, a short description, and the recipe in its body: pull the last meeting's decisions, the attendee's open issues, who they are, the CRM history if it is connected, laid out as talking points. From then on, anyone runs that prep by typing **/** in a chat and picking the skill, then naming the meeting to prep, instead of describing the whole thing from scratch. Here is why this step matters more than it looks. The prep becomes **consistent**, every meeting gets the same thorough treatment, with nothing dropped in a rush. And because skills are **shared**, a teammate covering your call runs the identical skill and walks in just as prepared. A skill is how you capture a good way of working once so the whole team has it every time, which is the same reason you would build one for filing a bug or drafting a recap. The last move is to stop running it at all. An [agent](/learn/features/agents) is an assistant you configure for a recurring job and then equip with skills, and "prep me for my meetings" is the textbook case. You describe the agent in plain language and turn on your meeting-prep skill in its Customize panel, the same skills-and-integrations setup every agent uses. Then give it a [schedule](/learn/features/agents#schedules): pick weekday mornings and a time in your timezone, and the agent runs while you sleep. Each morning it preps the day's meetings and leaves a prep doc for each one in your Library, so the work is waiting for you to review rather than assemble before the first call. Building and equipping that agent is its own short flow, walked through end to end in [Create AI agents with skills and integrations](/learn/guides/agents-and-skills). The point here is the shape of the escalation: the skill you wrote in the previous step is exactly what the agent runs on the schedule. ## The prep gets sharper over time One reason to invest the few minutes this takes: the prep compounds. In your first week with a new account it is mostly introductions. A month of meetings later it is the full relationship, what was promised, what slipped, what to raise next, because the skill draws on a record your team keeps adding to. You build the skill and the agent once, and they keep getting better on their own as the team works in Tana. --- ### Tutorials #### Turn a customer call into product feedback URL: https://tana.inc/learn/tutorials/customer-call-to-product-feedback Run a customer call in Tana and walk out with structured product feedback your team can act on: the pain points, a customer-journey map, and screenshots and annotations of exactly where they struggled. {/* DRAFT for review. Specialized meeting tutorial. Centered on the default product-feedback skill (validated wow: screenshots + annotations) and the Customer Journey artifact (built-in). Capture pitched above the in-flux UX. */} Customer calls are full of signal and almost impossible to capture by hand. You are listening, asking, and scribbling at once, and the texture is gone by the time you write it up. In Tana, the call does that part for you. Run a customer call in Tana and walk out with structured product feedback your team can act on: a summary, the specific pain points, and screenshots and annotations of exactly where they struggled. It uses one of Tana's default skills, so there is nothing to set up to get your first one. ## Run the call Start a meeting in Tana and join. The richest signal comes from the screen, so ask them to share their workflow, or share your product and watch them use it. Tana transcribes the conversation and reads the shared screen, so you can stop scribbling and actually listen. Run the call you were going to run. As they walk their process or react to a feature, Tana follows both what they say and what is on screen. It captures the shared screen, never anyone's camera. Run the default **product feedback** [skill](/learn/features/skills), from the Skills button in the [meeting](/learn/features/meetings) or with `/` in [chat](/learn/features/chat). Tana turns the conversation into structured feedback: a summary, the specific pain points, and screenshots with annotations marking exactly what they reacted to. This is the part that lands, the feedback is tied to the moment it happened, not reconstructed from memory. For the bigger picture, generate a customer-journey [artifact](/learn/features/artifacts): a before-and-after map of how they work today and where it could go. It is ready to share with the product team or a stakeholder as it is. Review what Tana produced, it arrives as a [proposal](/learn/features/proposals) you accept, then file the pain points as typed insights in your team's space, so the whole product team sees them, not just you. From there, push a specific item to [Linear](/learn/guides/connect-linear) when it is ready to act on. ## What you walked away with A customer call used to leave you with messy notes and a write-up to do. Now it leaves you with product feedback the team can act on, the pain points, the journey, the exact screenshots, shared minutes after the call. And it compounds. Because every call files into the same shared insights, the patterns surface on their own: the third customer this month to hit the same wall, the feature five interviews keep circling. Your team's understanding of its users gets sharper with every conversation, and the AI draws on all of it. --- #### Turn a design review into tracked work URL: https://tana.inc/learn/tutorials/design-review-tracked-work Run a design review in Tana and leave with your tracker already updated: feedback routed to the right existing issues, new changes filed, each tied to what was on screen and assigned to an owner. {/* DRAFT for review. Specialized activation tutorial (design review -> tracked work, primarily updates to existing issues/spec). Pitched above the in-flux meeting-capture UX: experience and loop level, not click-by-click. Payoff screenshot deferred until capture settles. Assumes a tracker (Linear/GitHub) or Tana tasks; pairs with the Connect GitHub and Linear guide. */} A design review produces a lot of feedback and almost no record of it. Half lands in scattered notes, half stays in someone's head, and afterward someone has to translate "we discussed some stuff" into actual issues, usually by hand, usually later. In this tutorial you run a design review in Tana and leave with the work already tracked. Most feedback lands on issues that **already exist**, the issue for that screen, the spec, the PRD, updated in place with the new comment and the screenshot. Genuinely new changes get filed as new issues. Either way, the backlog is current before the call ends. It works best with your tracker connected (Linear or GitHub), so the work lands where your team already lives. See [Connect GitHub](/learn/guides/connect-github) and [Connect Linear](/learn/guides/connect-linear). You need a design you can share on screen, a Figma file, a prototype, a build. ## Run the review Start a meeting in Tana, join, and share the design on your screen. Tana reads the screen you share and transcribes the conversation, so you do not narrate for the record or take notes. Walk the design and react out loud: "the empty state needs a call to action," "this spacing feels off on mobile," "the error copy is too harsh." Move between screens freely. Tana follows both the conversation and what is on screen, so each comment stays connected to what you were looking at. It captures the shared screen, never anyone's camera. As you go, or when you are done, have Tana pull the feedback together. It searches your existing issues and specs and, by default, updates the work each comment belongs to: a note added to the issue for that screen, a new acceptance criterion on the spec, the screenshot of what was on screen attached. Only genuinely new changes become new issues. You get updates to real work, not a pile of duplicates, and you do not have to set anything up for this to happen. If a review is squarely about one tracked doc, you can pin that doc to the meeting as a strong hint, but it is optional. Tana looks for the matching work on its own. Everything arrives as a [proposal](/learn/features/proposals), so nothing changes until you say so. For each item you see whether it updates an existing issue or creates a new one, where it lands, and who it is assigned to, and for updates you see the before and after. Tidy the wording, drop anything that was just thinking out loud, reassign as needed, and accept. By the end of the call, the work is where your team already looks. The designer and engineers open their tracker and the feedback is already on the right issues, assigned, with the visual context attached. Nothing to write up, nothing to re-file. {/* TODO screenshot (deferred until meeting-capture UX settles): the review's proposals, showing a mix of updates to existing issues and a new one, each with its screenshot. */} ## What you walked away with The review used to end with a vague sense of "lots of feedback" and someone left to turn it into issues later. Now it ends with the tracker already updated: existing work enriched, new work filed, each item tied to exactly what was on screen. The part a note-taker cannot do is the routing. Because Tana knows your issues and your spec, the feedback lands _on the right things_ instead of becoming a fresh list you have to reconcile against work that already exists. That is the difference between a meeting that produced talk and a meeting that moved the work forward. --- ## Blog ### Bring every meeting into Tana URL: https://tana.inc/blog/bring-every-meeting-into-tana Published: 2026-07-08 Capture meetings from any tool, keep your calendar in sync both ways, and pin your own sidebar. Plus a sharper meeting view and a calmer voice agent. This update is about Tana fitting the way you already work. Your calendar now syncs both ways, capturing the meetings you hold in other tools is smoother and more reliable, and the sidebar is yours to arrange. The meeting itself, and the voice agent in it, got sharper too. Events you create and manage in Tana now sync out to your connected calendar. Make an event in Tana and it appears in Google Calendar or Outlook moments later, and changes to its title or time, and deleting it, propagate back too. New connections write Tana events to your primary calendar automatically. If you connected a calendar earlier, turn it on by choosing which calendar to write to in [calendar settings](/learn/features/meetings#calendar-sync). Capturing a meeting held somewhere else now works better. Because it records the audio your computer plays, it works across any meeting platform rather than a fixed set, and it is lighter on your machine and more reliable. A small always-on-top window opens a couple of minutes before a scheduled meeting so you can start recording in one click, with pause and stop controls right there. You can also start a capture from the Today page for a meeting that is not on your calendar. If a teammate is already capturing the same meeting, everyone else sees it so it is not recorded twice. It is rolling out as an opt-in. On the latest desktop app, turn on **Use experimental meeting capture** in Settings, Preferences. See [capturing external meetings](/learn/features/meetings#capture-with-system-audio-opt-in) for the details. The sidebar is now yours to shape. Instead of listing every space and agent automatically, it keeps a clean set of primary links and a **Pinned** area you fill with the things you actually reach for. Pin any document, space, or agent, drag to reorder, and right-click to create a new section and group your pins. Your full set of spaces is still there in the Library whenever you need it. The meeting view is now one calm column that carries the work instead of a stack of documents. What the AI captures during the call is sorted into two clear places: items wait under **For Review** until you accept them, with keep and reject buttons right on the card, and accepted ones move to **Outcomes**. During the call the live digest steps back to a slim status line, so the shared focus takes center stage, and the full timeline stays one click away. When the meeting ends you get an editable, shareable summary with a Summary and Timeline toggle. See [how outcomes work](/learn/features/meetings#review-and-use) for the details. ## More in this update The voice agent has a calmer, more ambient look and clearer audio, and you can set a default voice for Tana's built-in agents in Organization Settings. Invite anyone to a meeting straight from Tana. Add teammates by name or type any email address, including people outside your organization, and everyone you add gets a real calendar invite in their inbox. Transcription follows your organization's language across meetings, external capture, the voice cursor, and dictation, while still picking up other languages spoken in the room. Guests in a Tana meeting can ask the AI questions in their own private chat, separate from the shared meeting chat. It answers but cannot create or change anything. Say "Hey Tana" and give a command in the same breath, like "Hey Tana, file that as a bug", and the agent acts on it instead of just greeting you. Tana opens faster, especially on slower connections and right after an update. Incoming-call notifications now reach you in the browser, not just the desktop app, and take you straight to the meeting. The full list of what shipped lives in the [changelog](/changelog). ## Try this --- ### From conversation to action URL: https://tana.inc/blog/from-conversation-to-action Published: 2026-06-19 The AI can turn a conversation into a calendar event, guests can join the shared meeting chat, and a new Capture as action grabs the exact part that mattered. Plus Meet now or later from Today, diagrams inline in chat, and more. This update is about the conversation, and everything you want to do with it. The AI can turn it into a calendar event, guests can join the shared chat, and you can grab the exact part of a meeting that mattered without keeping the rest. Ask in [chat](/learn/features/chat) and the AI can now [propose](/learn/features/proposals) a calendar event. Give it a title and a start time and it drafts the rest: an end time, time zone, location, description, and the people to invite. Adding participants keeps the event to that list. You stay in control. It is a proposal you review before anything lands, and the AI still will not change the time, title, attendees, or meeting link of an event that already exists. Meetings have a shared chat, Chat with everyone, and now guests are in it too. They can send and read messages right alongside your team, the simplest way to bring an outside collaborator into the conversation as it happens. To keep your organization's data private, the AI steps out of the shared chat whenever a guest is present, with a short note explaining the pause. Your own private meeting agent keeps working as usual. A meeting can cover a dozen different things. Capture as lets you act on just one of them: hover any row in the live [digest](/learn/features/meetings#transcription) and turn that section into a note, a task, a typed item, or an [artifact](/learn/features/artifacts) like a screen-share recap. Scoped to that one part, the AI works from focused context, so what comes out is about that decision or action, not the whole conversation. Need the exact words instead? The same hover menu copies that segment of the transcript, grouped by speaker. The Meet button in [Today](/learn/features/today) splits in two. Meet now starts a meeting straight away and opens a "Who are you meeting with?" popover, where you can copy a guest link, add colleagues in one click, share your screen solo, or start a voice chat with an agent. Meet later opens the scheduling popover instead, for picking a time. One button, two clear intents: start talking now, or put it on the calendar for later. ## More in this update **Diagrams render in [chat](/learn/features/chat) replies.** When the AI includes a diagram, it now renders inline once it is complete, instead of flashing raw markup as it streams. **Open a [task](/learn/features/tasks#the-tasks-view) in a peek.** Click a task's title in the Tasks view and it opens in a popover over the list, so you can read or edit it without leaving your tasks. **A date chip on an event's location pill.** It reads Today, Tomorrow, Yesterday, or a short date, and clicking it jumps to that day on the calendar. **Know when a [type](/learn/features/types#archiving-a-type) is archived or restored.** A notification tells you when someone in your org archives or restores a type, with a link to its panel. **Filter any [Library](/learn/features/interface#library) section.** Created by and Visibility pills now sit on every section page, saved in the URL so the view is bookmarkable. **Your own [skills](/learn/features/skills), front and center.** The Skills section and search now list the skills you and your team have made, with Tana's built-in ones filtered out. **Open org links in the [desktop app](/learn/features/apps).** Click a link to your org's Tana in a browser and it asks whether to open in Tana or stay in the browser, then remembers your choice. Set it from Preferences in the web app. **Find events you organized in [Created by](/learn/features/today).** Calendar events are now attributed to their organizer, so filtering by Created by surfaces the meetings you set up. The throughline this time: less time spent capturing the meeting, more spent acting on it. The [changelog](/changelog) has the rest of this release, including a handful of call and sign-in fixes. ## Try this The AI can schedule a meeting and prep your team for it in one go, drawing on what it already knows about your work. Drop this into a chat and it drafts the event and a prep doc for you to approve: --- ### Bring your own tools URL: https://tana.inc/blog/bring-your-own-tools Published: 2026-06-11 Tana reaches further this update: its AI can use the tools on your own MCP servers, the Tasks view groups and filters your work into bookmarkable slices, and a new search popover gets you to anything in Tana from wherever you are. This update is about reach. Tana's AI can now use the tools on your own servers, a reworked Tasks view groups and filters your work into slices you can bookmark and share, and a new search popover gets you to anything in Tana from wherever you happen to be. Tana already connects to GitHub, Slack, Linear, Jira, and HubSpot. Now you can connect anything else that speaks the Model Context Protocol, your own internal server or a third party's, and its tools become available to Tana's AI. Add a server from settings and authorize it once over OAuth. Each connection becomes a [skill](/learn/features/skills), so its tools only enter a chat when that skill is in scope, and you can allow or deny each tool from the skill's panel. Your connected servers stay private to you. It runs both ways, too. Tana is itself [an MCP server](/learn/features/mcp), so Claude, Cursor, or any MCP client can work with Tana from the other side. See [Custom MCP servers](/learn/features/integrations#custom-mcp-servers) for the full picture. The [Tasks](/learn/features/tasks) view is now built around filter pills, assignee, creator, type, and space, that live in the URL, so any slice of your tasks, everything assigned to you, what you have delegated, only your open issues, becomes a link you can bookmark or share, and the browser's Back and Forward walk your filter history. Group the list by type, status, or assignee, with a "+" on every group heading that adds a task already matching that group and your active filters. With nothing filtered, the view shows your most recent tasks rather than an empty screen. [Search](/learn/features/interface#search) now opens as a popover right where you are, including while you are writing in a document. Start typing for full-text search across Tana, or open it empty to browse. When nothing is typed, the popover shows the [Library](/learn/features/interface#library) as a browsable index: each kind of thing, meetings, tasks, types, chats, and the rest, in its own section with a "See all" page. It is the fastest way to land on something without losing your place. Reach for it with Cmd+P on macOS, or Ctrl+P on Windows and Linux. ## More in this update **Filter by who can see it.** A new visibility filter in [search and the Library](/learn/features/interface#search) narrows any list to what is private to you, shared with you, restricted, open, or shared by link. **Set an [outcome's](/learn/features/meetings#outcomes) state from the meeting.** Outcome tiles show a state control inline for anything with a workflow, a plain task or a typed item like a Bug, so you can move it along without opening it. **See where any item lives.** The location button on a panel now names the [Library section](/learn/features/interface#library) an item belongs to, like "Meetings" or "Docs", and links straight there. **Recent meetings, front and center.** The [Meetings preview](/learn/features/interface#library) on your Library and space home leads with recent meetings, with a dropdown to switch between recent, upcoming, today, and past. **[Reopen an archived type](/learn/features/types#archiving-a-type).** A "Recently archived" list in settings keeps every type you have archived, so you can find one and unarchive it. **A [title chip](/learn/features/interface#panel-title-chip) when you scroll.** Scroll down any panel and a compact chip with the item's icon and type appears in the toolbar. Click it to jump back to the top. **[Dictation](/learn/features/chat#voice-input) keeps your last words.** Send a dictated message the moment you stop speaking and the tail of what you said now makes it in, instead of getting dropped. **Copy a long prompt for a [coding tool](/learn/features/integrations#coding-tools).** When a hand-off prompt is too long for a tool's launch link, Tana offers a "Copy full prompt" button so you can paste the whole thing. **Open a [video](/learn/features/docs#images-and-attachments) in its own player.** Opening a video item now plays it in a dedicated player panel with the usual toolbar, instead of a generic view. **[Transcription](/learn/features/meetings#transcription) spells your team's names right.** Meetings and dictation now lean on your organization's name and your teammates' names, so "Tana" and the people in the room come through correctly. That is the gist. The full list, every new, improved, and fixed item, lives in the [changelog](/changelog). ## Try this The new search popover and Library are about getting to anything fast. Let the AI do the gathering: drop this into a chat and it pulls a scattered topic into one place. --- ### Tana takes it from here URL: https://tana.inc/blog/tana-takes-it-from-here Published: 2026-06-05 Tana does more on its own: meetings wrap themselves into outcomes, there's one place to create without leaving the call, and your tasks and mentions show more at a glance. Plus a unified Library, Mermaid diagrams, and Outlook calendar sync. This update shares a thread: Tana does more on its own. Meetings wrap themselves into outcomes the moment everyone leaves, there's one place to create or capture without leaving the call, and your tasks and mentions show more at a glance. Once everyone leaves a call, Tana runs the [wrap-up](/learn/features/meetings#outcomes) on its own: it proposes outcomes and writes a summary, with no manual step. Want them while you are still in the call? Hit Wrap up. When you pin a document to a meeting, the wrap-up treats it as the strongest signal of what the meeting was about, and updates that document rather than creating a new one. The meeting toolbar is simpler. Capture, Skills, and Create collapse into a single create menu, with a spyglass beside it to find and pin things. From that one menu you can turn the last minute, or the whole meeting, into a typed item, make a private note or task just for you, or run a skill or summary. One place, less hunting. Browse is now Library, the home for everything that is not pinned to a space, and it shares one filter bar with [Search](/learn/features/interface). Filter pills jump you to meetings or chats, or narrow by who created an item, and your spaces and types each get a dedicated section so they are easy to reach. Once you have found something, the new ["Send to"](/learn/features/docs#send-to) menu routes it anywhere: start a chat about it, run a skill, send it to an integration, pin it to a meeting, copy its link, or export it as Markdown. A task now shows a state icon wherever it appears, filling like a pie as it moves through its workflow, so you can tell where something stands without opening it. Give any [type](/learn/features/types#workflows) a workflow to make it task-like. Inline mentions carry more too: a task's state, a person's avatar, an image thumbnail, or the item's type. Hover one for a preview, or right-click to pin it to a date, assign it, or change its status. You can now add diagrams to any document. Type "/mermaid", ask the AI in chat, or set a code block's language to Mermaid, then switch between a live preview and the source. When the AI writes a diagram, it self-corrects unsupported syntax on its own. ## More in this update **Connect your Outlook calendar.** Microsoft and Outlook calendars now sync into Tana, so those meetings show up alongside the rest. **Activity is now a dashboard.** Promoted into the sidebar, it shows your notifications and recently updated items side by side, with an unread count. **A guided welcome session for new team members.** New workspaces open with a live, guided meeting: an agent tuned to your work sets up spaces and types with filled-in examples, and walks you through the essentials. **[Agents](/learn/features/agents) know what time it is.** Agents are now timezone-aware, so "today" matches your own calendar day and a [scheduled routine](/learn/features/agents#schedules) set to 09:00 in Oslo lands on the right Oslo morning. **Reassign right from the board.** Kanban cards carry an assignee avatar. Click it for a searchable people picker and reassign without opening the card. **Paste a link, get a mention.** Pasting a link to a Tana item now drops in an inline [mention](/learn/features/docs#mentions), not a raw URL. **Meeting summaries open with an illustration.** A wide pen-and-watercolour image, drawn from what the meeting was about, now tops each summary. **Muted by default in larger meetings.** Join a call that already has five or more people and you start muted, so you don't cut in. **[Archive a type](/learn/features/types#archiving-a-type).** Archive a type and it drops out of every menu, picker, and search right away, while existing items keep it with a muted "(archived)" label. **[Restore a deleted document](/learn/features/docs#deleting-a-doc).** A soft-deleted item now shows a "Restore document" button, so you can bring back something removed by mistake. That is the gist. The full list, every new, improved, and fixed item, lives in the [changelog](/changelog). ## Try this Diagrams are the easiest new feature to try yourself. Drop this prompt into your chat and see what Tana draws: ---