Obsidian Conversation Backup for Bot

๐Ÿฆž Automatic conversation backup system with beautiful chat-style Obsidian formatting.

Features

  • โšก Zero token cost - Pure shell scripting, no LLM calls
  • ๐Ÿ’พ Incremental backups - Hourly snapshots of new messages only
  • ๐Ÿ’ฌ Chat formatting - Colored Obsidian callouts with emojis and timestamps
  • ๐Ÿ“Š Token monitoring - Telegram warnings at 800k/900k tokens
  • ๐Ÿ“… Hourly breakdowns - Organize conversations by clock hour
  • ๐ŸŽฏ Smart filtering - Skips empty messages and system notifications

Quick Start

# Install the skill
bot skills install YOUR-USERNAME/bot-obsidian-backup

# Run installer
cd ~/.bot/skills/obsidian-conversation-backup
./install.sh

# Add to crontab for automatic hourly backups
crontab -e
# Add: 0 * * * * /path/to/scripts/monitor_and_save.sh

What It Does

Protects your Bot conversations from data loss when running /new by automatically backing up to Obsidian vault with beautiful formatting.

In Obsidian, conversations look like:

Chat format example

๐Ÿ‰ User messages in blue callouts
๐Ÿฆž Zoidbot messages in green callouts

Documentation

See SKILL.md for complete documentation, configuration options, and advanced usage.

Requirements

  • Bot
  • Obsidian vault
  • jq (JSON parser)
  • cron (for automatic backups)

License

MIT License - See LICENSE file

Contributing

Issues and pull requests welcome!

S
Description
Hanzo Bot skill: obsidian-conversation-backup (by laserducktales)
Readme
35 KiB
Languages
Shell 100%