1.2.0

What's new in v1.2.0

Vault Health monitor in sidebar

The TUI sidebar now shows a live Vault Health section (visible after /echoes-init):

• Colored status bullet — green below 170 pages, yellow at 170–200, red above 200
• Pages — current page count in EchoesVault/pages/
• Usage — percentage of the 200-page soft limit (can exceed 100%)
• Consider migrating to RAG — shown automatically when pages exceed 200

Stats update in real time: at plugin startup and after every vault-modifying operation (commit_memory, append_to_daily_log, create_or_update_page, activate_vault).

Bug fix: TUI failed to load after install

Added @opentui/solid and solid-js as explicit dependencies. Previously the TUI crashed on install with Cannot find module '@opentui/solid/jsx-dev-runtime' because these packages were not bundled with the plugin.

Docs

Added Updating section to README with the correct force-update command.

How to update

run opencode plugin echoes-vault-opencode@1.2.0 --force

Stable 1.1.0

Added information about the current EchoesVault status.

Stable 1.0.6

Minor plugin changes. Removed the warning about missing TUI during installation.

Stable 1.0.5

Append TUI entrypoint

Stable 1.0.4

Release v1.0.4: The Genesis Release — Obsidian Memory, Google OKF & Smart Context Triggers

We are incredibly excited to announce the first major public release of EchoesVault (v1.0.0) for OpenCode!

AI agents are notorious for their short-term memory, losing crucial project context the moment a session ends. Inspired by Andrej Karpathy's file-based memory concepts and standard software engineering documentation workflows, EchoesVault fixes this by turning your repository into a persistent, human-readable knowledge base.

---

🎮 New Intuitive Lifecycle Workflow

We completely overhauled the command naming conventions to match a developer’s actual mental model. Instead of mechanical "resume" and "save" tags, the lifecycle now operates on a strict, natural timeline:

• /echoes-init: Run once per project. Bootstraps the directories, registers skills, and briefs the agent.
• /echoes-start: Run at the beginning of every coding session. The agent automatically ingests context and audits the index.
• /echoes-end: Run when you are done working. The agent surgically distills the entire session's architectural wins into a dense technical summary.

---

📦 Google OKF & Obsidian Synergy

EchoesVault isn't just a custom folder structure; it's a bridge between your local IDE, human developers, and third-party AI compliance tools.

• Google OKF Compliant: EchoesVault is built natively on Google's newly announced Open Knowledge Format (OKF). By enforcing standard Markdown link paths and mandatory type properties in YAML frontmatter, your vault is fully interoperable with global enterprise AI parsers and renders beautifully on GitHub/GitLab.
• Obsidian Native: The entire EchoesVault/ directory is a fully valid Obsidian vault. Open it in Obsidian to explore your project's architectural evolution via Graph View, use interactive backlinks ([[wikilinks]]), and display gorgeous, clean warnings via native Obsidian markdown callouts (> [!warning] DEPRECATED).

---

🧠 Token-Efficient Agentic Skills

This release solves the critical scaling and "lazy LLM" issues found in traditional flat-file memory dumps.

• Consolidated Trajectory Tracking: /echoes-start now automatically concatenates and ingests the last 3 daily logs instead of just one. This ensures the AI understands the momentum and direction of your development, not just the last hotfix.
• Surgical Incremental Updates: The commit_memory_to_echoes_vault tool no longer forces the AI to reprint or overwrite index.md completely. It now processes precise array payloads (indexAppends and indexUpdates), saving thousands of output tokens and preventing truncation bugs on larger projects.
• Autonomous Mid-Session Scratchpad: Rather than waiting until the end of the day, the agent uses the echoes_append_to_daily_log skill seamlessly in the background. It is tuned to exact event triggers—Task Completion, Context Switch, Architectural Agreement, or Explicit Directives—safeguarding context against IDE crashes or sudden window closures.

---

📊 Introducing /echoes-status (With Built-in Scale Alerts)

We introduced a lightweight, token-cheap diagnostic command: /echoes-status. It scans the vault to give you an instantaneous health dashboard:

• Total Topics & Deprecated Count: Tracks the density of your encyclopedia.
• Session State: Confirms whether today's log has active entries.
• Scale Warning (>200 Pages): To prevent context window inflation, if the vault detects more than 200 active pages, it automatically appends an Obsidian-friendly > [!warning] SCALE ALERT, safely prompting the user when it’s mathematically time to graduate from flat files to a hybrid Vector/RAG system.

---

🛠️ API Reference Summary

Slash Commands

• /echoes-init — Initialize the folder ecosystem and set agent guardrails.
• /echoes-start — Boot up a session, ingest the 3-day log history, and lint the registry.
• /echoes-status — Get an instant, lightweight metric dashboard of vault scale and health.
• /echoes-end — Distill session delta, commit new knowledge, and wrap up.

Background Tools & Skills

• echoes_append_to_daily_log — Event-driven mid-session timestamped logging.
• echoes_search_vault_pages — Targeted keyword grep utility to enforce "Read-Before-Write" rules.
• echoes_create_or_update_page — On-the-fly markdown page generation with atomic index synchronization.

---

Installation

Add it to your opencode.json configuration file:

{
  "$schema": "[https://opencode.ai/config.json](https://opencode.ai/config.json)",
  "plugin": ["echoes-vault-opencode"]
}