rune-session-bridge

Persists decisions, conventions, and progress to .rune/ state files across sessions.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/dangvu008/VietTruyen --skill rune-session-bridge-dangvu008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rune-session-bridge
Source: https://github.com/dangvu008/VietTruyen/tree/main/.agents/skills/rune-session-bridge
Command: npx skills add https://github.com/dangvu008/VietTruyen --skill rune-session-bridge-dangvu008

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI coding sessions lose all context when they end, forcing developers to re-explain architectural decisions, conventions, and task progress every new session. This Skill automatically saves session state to structured .rune/ files and reloads it at the start of the next session. ## Core Features & Use Cases - Save Mode: Appends architectural decisions, coding conventions, task progress, and session summaries to .rune/decisions.md, .rune/conventions.md, .rune/progress.md, and .rune/session-log.md, then commits them to git. - Load Mode: Reads all state files at session start, verifies integrity, loads active invariants via a Node.js script, and presents a structured summary with the recommended next task. - Checkpoint Mode: Creates an exact resume point in .rune/checkpoint.md capturing git state, load-bearing decisions, and ordered remaining tasks for mid-work handoffs. - Detach Mode: Manages asynchronous oracle-model dispatches via idempotent pending records in .rune/oracle-pending/ with timeout and orphan cleanup. - Use Case: A developer ends a session mid-refactor; the next session automatically loads the checkpoint, sees the branch and uncommitted files, and resumes from the exact step where work stopped. ## Quick Start Ask the agent to save the current session's decisions and progress to the .rune directory so the next session can resume where this one left off.

Frequently Asked Questions about rune-session-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve AI agent context between sessions?

Use Save Mode to append decisions, conventions, and progress to .rune/ state files at session end. Load Mode reads these files at the next session start and presents a summary with the recommended next task.

How to resume work from an exact point in a previous session?

Trigger Checkpoint Mode with /checkpoint to write .rune/checkpoint.md capturing git state, load-bearing decisions, and ordered remaining tasks. The next session detects the checkpoint first and presents the resume command.

Does session state loading verify file integrity?

Yes, Load Mode runs an integrity check on all .rune/*.md files before loading. TAINTED results block the load entirely, while SUSPICIOUS results require explicit user approval before proceeding.

What happens when the learnings log grows too large?

The .rune/learnings.jsonl file auto-compacts when it exceeds 100 entries, keeping only the latest entry per key and type combination. Instincts are capped at 20 entries with lowest-confidence eviction.

Can multiple parallel agents dispatch oracle calls without duplication?

Yes, Detach Mode enforces idempotency through bundleHash-keyed lookup in .rune/oracle-pending/. A duplicate dispatch returns the existing sessionId instead of creating a new record, and records older than 24 hours are cleaned up automatically.