Repository navigation
Releases
v0.4.6 — Defensive theme-token fallback
Fixed
- Contain missing host theme-token failures inside Flema rendering.
- Fall back from the requested semantic token to
text, then to readable unstyled text if both lookups fail. - Preserve MCP-owned shared rail rendering, attachment ownership, and disposal behavior.
Release safety
AI PR Reviewcompleted on the exact final PR head with 0 critical, high, or medium findings.- The single low informational finding was answered and its conversation resolved.
- Both required
validatechecks passed. - npm
prepublishOnlypassed typecheck, all 522 tests, build, and 207-file package verification.
Install
pi install npm:opencode-flema-engram-sidebar@0.4.6For Gentle Shell:
PI_CODING_AGENT_DIR="$HOME/.gentle-shell/agent" \
pi install npm:opencode-flema-engram-sidebar@0.4.6v0.4.5 — Gentle Shell sidebar theme compatibility
Fixed
- Use the supported
accentsemantic theme token for the native Flema rail title. - Prevent an unsupported
railTitlelookup from breaking the shared Gentle Shell/MCP sidebar render. - Add strict-theme regression coverage for the shared rail integration.
Validation
- Live Gentle Shell restart confirmed native, MCP, and Flema sidebars render together.
- CI
validatepassed on PR #86. - npm prepublish checks passed: typecheck, 520 tests, build, and 207-file package verification.
Install
pi install npm:opencode-flema-engram-sidebar@0.4.5For Gentle Shell:
PI_CODING_AGENT_DIR="$HOME/.gentle-shell/agent" \
pi install npm:opencode-flema-engram-sidebar@0.4.5v0.4.3 — Reliable Gentle Shell rail cards
What’s changed
- Keep Engram sidebar cards independent in Gentle Shell 4.6+ while preserving the legacy framed sidebar and overlay fallbacks.
- Contain third-party rail render and card-group failures, and clamp rows using the host TUI width functions so one bad participant cannot suppress the entire rail.
- Pin
@opentui/solidto 0.5.9 for Node 24 fresh installs. - Update installation examples and release-facing site metadata to 0.4.3.
- Extend the local MCP stdio smoke timeout to accommodate slower startup.
Verification
- 513 tests passed.
- TypeScript typecheck and build passed.
- Package verification passed (207 files).
- Required GitHub CI
validatepassed on the release-preparation PR.
Full changelog: v0.4.2...v0.4.3
v0.4.2
What's changed
- Refresh Gentle Shell/Pi sidebars immediately after successful Engram saves.
- Invalidate shared adapter caches before refresh and prevent stale in-flight reads from repopulating them.
- Preserve Cloud-aware project state while falling back to the newly saved local observation when Cloud is unavailable.
- Refresh the official OpenCode TUI after successful namespaced Engram save tool completions, with event deduplication and listener cleanup.
- Update installation documentation and the project site for
0.4.2.
Verification
- 508 tests passed
- TypeScript typecheck and build passed
- Package verification passed for 207 files
- Native RDD review approved across risk, resilience, readability, and reliability lenses
Full changelog: v0.4.1...v0.4.2
v0.4.1 — Pi global-scope compatibility and cloud-first fallback
v0.4.1 — Pi global-scope compatibility and cloud-first fallback
Highlights
- Fix
All adapters failedsidebar error: acceptscope: "global"in observation/project schemas — live Engram 3.6 returns this scope in all-project results, causing project enumeration to fail - Cloud-first Pi adapter: Pi/Gentle Shell now resolves projects from cloud first, falling back to local Engram when cloud returns empty or errors
- OpenCode unchanged: existing
createConfiguredAdapterlocal-first behavior is preserved
Changes
| File | Change |
|---|---|
src/schemas/observation.ts |
Accept scope: "global" |
src/schemas/project.ts |
Accept scope: "global" in project scopes |
src/adapters/types.ts |
Extend Observation.scope and ListObservationsOpts.scope |
src/adapters/composite.ts |
Add fallbackOnEmpty option and listProjectsAcrossAdapters |
src/adapters/factory.ts |
Add createPiConfiguredAdapter (cloud-first) |
src/pi.ts |
Use createPiConfiguredAdapter for Pi extension |
Verification
- Full suite: 504/504 tests pass
- TypeScript typecheck: pass
- Build: pass
- Live Gentle Shell: sidebar shows
flema-engram · OK,/engram-refreshreturnsEngram refreshed
Install
pi install npm:opencode-flema-engram-sidebar@0.4.1
# or for Gentle Shell:
PI_CODING_AGENT_DIR="$HOME/.gentle-shell/agent" pi install npm:opencode-flema-engram-sidebar@0.4.1v0.4.0 — Pi / Gentle Shell Engram sidebar
Highlights
- Adds a collapsible, active-theme-aware Engram sidebar for Pi and Gentle Shell.
- Shares Gentle Shell's sidebar rail without replacing other participants, with a bounded passive-overlay fallback for plain Pi.
- Adds independent session-scoped widget visibility controls; the below-input widget stays hidden by default.
- Publishes refreshed Engram status, preserves one live rail participant across remounts, and supports command and mouse collapse/expand.
- Adds a semantic themed frame for expanded and collapsed views.
- Filters completed historical summaries from active blocker counts while preserving real blocker observations.
- Refreshes the README, package metadata, and bilingual GitHub Pages landing for the OpenCode and Pi/Gentle Shell package.
Install
npm install opencode-flema-engram-sidebar@0.4.0The package exposes the OpenCode integration from the root export and the Pi extension from opencode-flema-engram-sidebar/pi.
Verification
- 499/499 tests passed.
- TypeScript typecheck, build, and 207-file package verification passed.
- Public npm installation and root/
./piimports passed. - GitHub Actions CI and GitHub Pages deployment passed on the tagged
maincommit. - The deployed landing was fetched over HTTPS and verified for the 0.4.0, Gentle Shell, and ODD content.
Compatibility notes
A clean Node 22 installation succeeded but emitted transitive warnings: @opentui/core@0.5.17 declares Node >=26.4.0, and glob@9.3.5 is deprecated. These warnings do not prevent installation or package imports, but remain follow-up dependency risks.
Delivery
v0.1.4 – Engram sidebar fixes for attach mode
What's Changed
- Fixed Engram sidebar health and project resolution when using
opencode attach - Added
all_projects=trueto observations/sessions queries for correct project derivation - Improved health aggregation in
CompositeEngramAdapterto combine local and cloud status - Added dynamic workspace path resolution using
api.state.pathin attach sessions - Updated README.md with explicit instructions for
opencode attachand the🔌 Target:debug line - Published opencode-flema-engram-sidebar@0.1.4 to NPM
- Fixed GitHub Page logo (temporary CSS brain mark; ready for custom image)
Details
This release resolves the issue where the sidebar showed OFFLINE and Project: unresolved when using opencode attach <url>. The plugin now correctly loads from NPM, detects the attach URL, queries Engram with all_projects=true, aggregates health status, and uses the remote workspace path.
See the sidebar debug line 🔌 Target: Local=<host>:7437 | Cloud=<URL> to confirm connection targets.
v0.1.2
Flema Engram 0.1.2
- Exporta el plugin TUI por defecto desde la raíz del paquete.
- Mantiene los exports MCP nombrados.
- OpenCode puede configurarse con el spec simple opencode-flema-engram-sidebar.
- Actualiza la documentación del flujo de instalación.
v0.1.1
Fix reactive sidebar refresh rendering after Alt+R. Preserve project-scoped observations across Flema and other OpenCode repositories. Synchronize the MCP default version with package metadata. Published npm package version opencode-flema-engram-sidebar@0.1.1. Verification: 204 tests passed, typecheck passed, build passed, package verifier passed, GitHub CI passed.