Skip to content

Releases: psinetron/echoes-vault-opencode

Stable 1.0.4

16 Jun 14:23
@psinetron psinetron
1.0.4
e05b6c1

Choose a tag to compare

View all tags
Stable 1.0.4 Latest
Latest

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"]
}
Assets 2
Loading