History

History Management

TagForge automatically saves every interaction—whether it's a chat conversation or a prompt generation cycle. This guide explains how to manage your data.

📂 Session System

TagForge organizes interactions into Sessions. Each session acts as a dedicated workspace for a specific topic or project.

Creating Sessions

• Manual: Click the (+) button located in the Chat or Prompt Generator tabs. This initializes a new, empty workspace.
• Automatic: A new session is automatically created upon application startup.

Switching Sessions

Click the Arrow Button on any session in the sidebar to load it.

• Fast Switching: Sessions load instantly from local storage, allowing seamless transitions between topics.

---

🗑️ Managing Data

Renaming Sessions

Keep your workspace organized by giving sessions descriptive names:

1. Click the Pencil Icon on the target session.
2. Type the new name and press Enter to save.

Filtering Sessions

Use the Search Box in the sidebar to quickly locate specific conversations.

• Type keywords to filter the list in real-time.
• Clear the box to restore the full view.

Deleting Sessions

1. Locate the session in the list.
2. Click the Trash Can icon to permanently delete it.

[!CAUTION]
No Undo: Deleting a session permanently removes the JSON file from your disk. There is no "Recycle Bin" for these files.

Auto-Cleanup

TagForge performs an automated cleanup routine at startup to maintain a tidy workspace.

• Logic: Any empty sessions (0 messages) from previous runs are automatically removed.
• Benefit: This prevents your history from being cluttered with unused entries.

---

💾 Local Storage & Backups

TagForge follows a strict Local-First policy.

File Location

Your history is stored in standard JSON format within your user profile.

• Location: ~/.tagforge/sessions/
• Format: Human-readable JSON. You can open these in any text editor for manual inspection.

📦 Import & Export (Backup)

You can create portable backups of your entire session history:

1. Go to Settings.
2. Locate the History Management section.
3. Export: Click "Export History" to save all sessions into a compressed .tfb file.
4. Import: Use "Import History" to restore a previously saved .tfb file.

[!TIP]
Use .tfb backups to move your history between different computers or to keep a secure archive of important prompt engineering cycles.

Privacy Guarantee

[!NOTE]
Your history never leaves your device. It is not synced to the cloud, not sent to the developer, and not accessible by AI providers (except for the active message history during a specific generation request).