rait-09_obsidian-agent-client/docs/usage/chat-export.md
RAIT-09 f3143d6284 docs: add custom export tag and update FAQ for v0.7.0 features
- Add Frontmatter tag setting to chat-export.md
- Update FAQ with new agent switching behavior
- Add multi-session and broadcast command FAQs
- Add custom frontmatter tag FAQ
2026-01-19 21:03:18 +09:00

2.5 KiB

Chat Export

Save your conversations with AI agents for future reference.

Manual Export

Click the export button in the chat header to export the current conversation.

Export button in chat header

Export Settings

Configure export options in Settings → Agent Client → Export:

Setting Description
Export folder Folder where chat exports will be saved (default: Agent Client)
Filename Template for filenames. Use {date} and {time} as placeholders
Frontmatter tag Tag added to exported notes (default: agent-client). Supports nested tags like projects/agent-client
Auto-export on new chat Automatically export when starting a new chat
Auto-export on close chat Automatically export when closing the chat view
Open note after export Automatically open the exported note
Include images Save images attached in messages (default: enabled)
Image location Where to save images: Obsidian's attachment folder, custom folder, or embed as Base64
Custom image folder Folder path for images when using custom location

Export Format

Chats are exported as Markdown files with YAML frontmatter:

---
created: 2025-12-13T00:31:12
agentDisplayName: Claude Code
agentId: claude-code-acp
session_id: f95b4847-cb9c-441a-9f0b-08eb243ff5dd
tags: [agent-client]  # Customizable in settings
---

# Claude Code

## 0:31:12 - User

@[[Agent Client Plugin]]
Summarize this, please.


---

## 0:31:16 - Assistant

### 🔧 Read File

**Locations**: `/Users/rait09/Documents/dev_vault/Agent Client Plugin.md:0`

**Status**: completed

## Summary: Agent Client Plugin for Obsidian

This is an Obsidian plugin that integrates AI coding agents (Claude Code, Codex, Gemini CLI) directly into your vault.
...

What Gets Exported

  • Messages: Full conversation history with timestamps
  • Images: Attached images (saved as files or embedded, based on settings)
  • Tool calls: Tool name, locations, status, and diffs
  • Thinking: Agent's reasoning (as collapsible callouts)
  • Plans: Task plans with status indicators
  • Note mentions: Auto-mention and manual mentions in @[[note]] format

Use Cases

  • Documentation: Keep records of conversations and decisions
  • Learning: Review agent explanations later
  • Sharing: Share solutions with others
  • Debugging: Reference what the agent did for troubleshooting