Changelog
Release notes and version history for TRW. Track how the operating layer, memory engine, and delivery tooling evolved over time. This page covers shipped releases only, so it stays a reliable history instead of turning into a speculative roadmap.
Latest versions
0.55.13
trw-mcp
0.9.6
trw-memory
0.32.20
platform
v26_TRW
Framework
These are the latest in-repo versions of each package. The installer (install.sh) and pip always resolve the most recent release published to PyPI, which may briefly trail the numbers above between a tag and its publish. Run pip index versions trw-mcp to see what is installable right now.
Releases
User-Space Memory Tier
- Opt-in user memory tier at ~/.trw — portable learnings follow you across every repo on the box instead of being relearned per project
- Scope routing: trw_learn classifies portability automatically, keeping repo-local gotchas with the project and cross-cutting knowledge box-wide
- Federated recall: trw_recall merges project and user tiers into one ranked result, with a cap so user hits never bury a precise project match
- Non-destructive by default — the tier is off until you opt in, and enabling it never moves or rewrites existing project learnings
Leaner Sessions & Resilient Recovery
- Compact-by-default session start: learnings cap to top-K and diagnostics collapse to a one-line health summary, with a verbose mode on demand
- Torn-log resilience: append-only run logs drop only a single corrupt line instead of failing the whole read after a concurrent write
- Build-check failure attribution: each test failure is tagged likely-yours, likely-pre-existing, or unknown for fast triage
- Intentional-code marker: deliberately counterintuitive code can be flagged so the bundled reviewer and simplifier agents leave it alone
- Tool surface trimmed to the tools in use, plus an installer device-auth fix so first-run login points at the real API host
trw-memory: Durability & Corruption Resilience
- Resilient reads quarantine a single bad row instead of collapsing an entire query, keeping degraded reads correct and bounded
- PII scanner hardening: GitHub PAT and AWS access-key patterns are now caught before they can be stored in plaintext
- Hybrid BM25 + dense + RRF retrieval ordering is preserved by default when the candidate pool is large enough, with per-branch latency telemetry
- Re-entrant transaction bracket collapses many writes into a single commit, removing per-row overhead on batch passes
- Linux-conditional native SQLite dependency with graceful stdlib fallback on macOS and Windows, keeping installs green
Multi-Client Distill Channels & Stability Hardening
- Per-client write surfaces for Claude Code, Cursor, Codex, OpenCode, Copilot, and Antigravity CLI, activated automatically on install and update
- First-class, full-ceremony support for the Antigravity CLI profile with environment discovery, config deep-merge, and specialist subagents
- Feedback-submission redaction hardened: secrets, headers, metadata, and connection strings pass the redaction chokepoint before any network call
- Throttle, deadline, and watchdog controls eliminate a multi-minute learn stall, and several validation and sync paths are now bounded by repo size
- Capability-tier resolver maps the portable frontier/balanced/local vocabulary to each client, plus an in-IDE tool to submit feedback without leaving the editor
Governance & Multi-Client Support
- Boot-time security gating: every tool dispatch passes through one verified audit, telemetry, and kill-switch surface
- Eight first-class client profiles: Claude Code, Cursor IDE, Cursor CLI, Aider, Codex, Copilot, Gemini, OpenCode
- Tamper-evident memory: learnings are signed on write so storage-layer tampering is detectable across sessions
- Backend deploy hardening with structural packaging discovery and a dependency-drift gate
Memory Defense & Continuous Calibration
- Memory-poisoning defense in observe-mode: suspicious entries surface in a shadow partition before any enforcement
- Calibration window before promotion to enforce mode - no premature flips on unvalidated thresholds
- Canary entries auto-verify on recall to detect storage-layer tampering
- Batch memory writes with per-item recovery: one bad entry no longer fails the whole batch
frontier 4.7 Framework Calibration
- Every prompt surface recalibrated for Claude frontier 4.7 - instruction style, default effort, and tokenizer behavior
- Client-profile-aware prompt rendering: no hardcoded CLI assumptions across the framework
- Tool and skill descriptions standardized to a consistent, model-friendly pattern
Instruction Accuracy & Tool Filtering
- Instruction files now automatically filter to show only available tools, preventing agents from calling unavailable tools
- New CLI command to validate instruction accuracy against the active tool set
- Delivery gate warns when project instructions reference tools not available in the current configuration
OpenCode Release Hardening
- OpenCode support release hardened with full-package verification
- Outcome-correlation writes now persist cleanly for SQLite-backed learnings
- Session-boundary and template-version regressions aligned to current runtime behavior
- Bundled OpenCode artifacts remain synchronized with source skills, hooks, and agents
Architecture & Optimization
- Configuration decomposition into focused domain modules
- Optimized tool responses — significant token reduction per call
- Agent consolidation to focused roles with clean upgrade path
- Instruction file optimization and reduced hook overhead
- Contextual learning injection on phase change
- Platform OAuth and authentication hardening with cold-start resilience
Codex Provider Support
- Full Codex bootstrap: one command generates all project configs, instructions, and skill definitions with merge-safe updates
- Codex client profile: light-ceremony mode optimized for Codex's context constraints and workflow
- Skill path normalization: existing configs auto-corrected on update for consistent directory references
- Bootstrap stability: fixed edge case where project initialization could fail in certain directory layouts
Architecture & Code Quality Sprint
- Resolved critical architectural layering issues to enforce clean dependency boundaries across the codebase
- Major module decomposition: large modules split into focused, maintainable units across both packages
- Exception handling audit: all error handlers reviewed and justified, plus security fixes in bundled scripts
- trw-memory 0.6.0: improved CLI error handling, cleaner module organization, and a new abstract storage interface
Developer Experience Sprint
- Embeddable server mode: MCP server can now be used as a library for testing and integration, with full type annotation support
- Config system refactored: large configuration module split into focused, maintainable components
- Import cycle cleanup: circular dependencies eliminated for faster startup and cleaner architecture
- New CLI commands: auto-generated config reference, project uninstall with dry-run mode, and --version flag
Session Resilience Hardening
- Activity heartbeat: tool calls now signal liveness so long-running sessions are never incorrectly marked stale
- Database maintenance: proactive storage cleanup prevents unbounded growth during long sessions
- Reliable session boundaries: session start events are always recorded, ensuring delivery gates work regardless of tool call order
- Fixed multiple stale-run detection bugs: active sessions are now correctly identified and prior session data is properly isolated
Executable Assertions & Self-Verifying Memory
- Machine-verifiable assertions attached to memory entries — learnings auto-verify against your codebase to detect staleness
- Assertion-aware recall: entries with failing assertions are automatically deprioritized in search results
- Security-first verification: path traversal protection, pattern limits, and binary file detection
- Comprehensive test coverage across both packages for all new verification capabilities
Device Auth & One-Line Install
- One-line install: a single shell command detects your environment, installs from PyPI, and configures your project
- Device authorization flow — authenticate your CLI via browser with QR code support
- OAuth social login with Google and GitHub, including Google One Tap for instant sign-in
- CLI auth commands: login, logout, and status with multi-organization support
Observation Masking & Source-Available Prep
- Adaptive context budget: tool responses automatically compress as sessions grow longer, significantly reducing token costs
- Source-available publication prep: BSL 1.1 license, public README, secrets scrubbed
- Redundancy detection: repeated identical tool responses are automatically suppressed to save context
- Instruction cache invalidation on upgrade — version bumps force re-render across all projects
Framework v24.4 & Structured Logging
- Framework version bump to v24.4 — coordinated release across all packages
- Structured logging overhaul: consistent, queryable log events across all modules
- Expanded cross-package integration test suite covering end-to-end tool workflows
- Workstreams reliability fix — parallel agent work is properly preserved during cleanup
Client Profiles & Adaptive Ceremony
- 8 built-in client profiles: claude-code, cursor-ide, cursor-cli, opencode, codex, copilot, gemini, and aider
- Profile-aware ceremony: process overhead adapts to each platform's context window and capabilities
- Response optimizer: tool responses automatically compacted for LLM context efficiency
- Multiple delivery reliability fixes and internal code quality improvements
Multi-Platform Support & Full Tool Suite
- Multi-platform ceremony: full, light, and off modes — spans Claude Code, Cursor IDE, Cursor CLI, OpenCode, Codex, Copilot, Gemini, and Aider
- Complete orchestration toolkit: tools, resources, skills, and bundled agents for the full development lifecycle
- Learning injection: high-impact learnings auto-promote into instruction files for future sessions
- Installer UX overhaul with health checks and cross-platform server management
Workstreams Safety & Type System
- Pre-spawn safety checks: agent creation blocked when uncommitted changes could cause conflicts
- Comprehensive type system: strong typing at all major cross-module boundaries for reliability
- Scoring accuracy improvements: calibrated weights and removed placeholder dimensions
- File ownership enforcement: prevents multiple agents from editing the same files simultaneously
Documentation Overhaul
- Complete rewrite of all documentation pages with progressive disclosure and scannable layouts
- Expanded references covering the full tool, skill, and agent catalog
- SEO overhaul: structured data, custom social cards for key pages, and expanded sitemap
- Full API reference with endpoint docs, auth details, examples, and error formats
Interactive Memory Visualizations
- Interactive memory dashboard: growth timeline, tier migration, smart search, knowledge graph, and forgetting curve visualizations
- Cross-widget interactions: search highlights matching data across dashboard sections
- Homepage growth timeline showing how framework knowledge compounds across tasks
trw-memory: Standalone Memory Engine
- Standalone persistent memory engine — purpose-built for AI coding agents with fast local storage
- Hybrid search combining sparse keyword and dense vector retrieval for high-quality recall
- Knowledge graph, tiered storage lifecycle, semantic dedup, and LLM-powered consolidation
- Integrations with popular AI frameworks: LangChain, LlamaIndex, CrewAI, and OpenAI-compatible APIs
Next steps
Use quickstart to confirm the current install and access flow, configuration to understand changed defaults, and the API reference when a release touches hosted platform behavior.