Skip to main content

Documentation Index

Fetch the complete documentation index at: https://slackhive.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Every save to an agent - system prompt, skills, tools, permissions, channel restrictions - automatically creates a snapshot. The History tab lets you browse the full timeline, see exactly what changed, and restore any previous version. This gives you a safety net: experiment freely, and roll back cleanly if something breaks.

What gets snapshotted

CapturedNot captured
System Prompt (CLAUDE.md)Name
All skill filesSlug
Tool allowlist and denylistDescription
MCP server assignmentsSlack credentials (stored separately)
Capability toggles (Internet Access, Shell Access)Memory (has its own storage)
Channel restrictionsKnowledge Library wiki folders (shared, separate storage)

Skip when nothing changed

If you save without changing anything, no snapshot is created. The history only shows real state changes. This keeps the list clean.

GitHub-style file diffs

Open a snapshot and you see a file-level diff in GitHub’s familiar layout:
  • Left pane - file tree of what changed (added / modified / removed badges)
  • Right pane - the unified diff for the selected file
  • Green additions, red deletions, gray context
  • Each changed file is collapsible
Works for every captured piece - skills, system prompt, MCP assignments, permission lists, and channel restrictions all render as unified diffs.

Restore preview

Before you restore, you can preview what will happen:
  1. Open a snapshot
  2. Click Preview Restore
  3. A new pane shows the file-level diff between now and the snapshot
  4. Every file that would change is listed with its diff
  5. Click Restore to apply, or close the preview to cancel
This means no surprises - you see the exact impact before committing.

How to restore

  1. Open an agent → History tab
  2. Click the snapshot you want
  3. Preview Restore (optional - see above)
  4. Click Restore this version
  5. Confirm
The runner hot-reloads the agent within seconds. The restored state becomes current and is itself snapshotted as a new entry - so restoring is always reversible.

Retention

SlackHive keeps up to 10 snapshots per agent. When a new snapshot would exceed the cap, the oldest is dropped automatically. To preserve a specific version permanently, export the agent config (see Import / Export) before it ages out.

Conversation history

Separate from version history - each Slack thread has its own persistent Claude session.
  • Sessions identified by userId + channelId + threadTs
  • Session context survives runner restarts (the Claude session ID is stored in SQLite and reloaded on start)
  • Same thread next week? Same session - full context preserved, including tool results and prior exchanges
  • Sessions expire after 30 minutes of inactivity
  • The runner runs a cleanup job every 10 minutes to prune stale sessions
After expiry, the next message in the thread starts a fresh session. The agent still has all memories from previous conversations - those live separately in the agent-level memory store.