Repository navigation
To install or upgrade, see Releases and upgrades.
Upgrade notes
- The server upgrade changes only the images. This release has no database migrations, no
chart value changes, no Terraform changes, and no change to the host wire version. Run
helm upgradeon both releases in the usual sequence. You can roll back to 0.11.0. - The
engramsCLI is a Rust binary. The release assets keep their names
(engrams-linux-x64,engrams-linux-arm64,engrams-darwin-arm64), and the commands,
flags,--jsonshapes,hosts.jsoncredential file, and exit codes do not change. Build it
from the repository withcargo build --profile cli -p engram-cli; thecli/directory and
its Bun toolchain are gone. (#1642, #1644, #1645) - The token usage attributes on chat spans changed. They now use the GenAI semantic
convention keys. If a dashboard or a query reads the old keys, change it:gen_ai.usage.cache_read_input_tokensis nowgen_ai.usage.cache_read.input_tokens.gen_ai.usage.cache_creation_input_tokensis now
gen_ai.usage.cache_creation.input_tokens.gen_ai.usage.input_tokensis now the total input, including cache tokens. For the
Claude harness, it was the uncached input only. (#1675)
Added
engrams tui, a terminal client for sessions. It shows the session list and the
transcript with Markdown, tables, diffs, and syntax highlighting. You can send prompts,
answer questions, approve plans, search the transcript (Ctrl+T), edit a draft in
$EDITOR(Ctrl+G), and select text to copy it. Use--no-alt-screento keep the
terminal scrollback and--axfor screen readers. (#1658, #1664)- The TUI and the CLI report the session state to the terminal through the Program Status
Protocol (OSC 7501): working, waiting for you, done, or failed. The TUI also reports your
other sessions.ENGRAMS_PROGRAM_STATUS=0turns it off. (#1663) - An installer for the CLI (
curl -fsSL https://engramsfactory.com/install.sh | sh), the
Homebrew formulaecortexapps/tap/engramsandcortexapps/tap/engrams-nightly, and a
nightly prerelease channel (v<next>-rc.<n>) built frommain. (#1660, #1661) - Chat and tool spans carry
gen_ai.conversation.id(the session id). (#1675)
Changed
- The
engramsCLI moved from Bun to Rust (crates/engram-clion the new
crates/engram-app-clientlibrary). The binary is 3 MB and uses about 8 MB of memory.
(#1644) - The TUI colours adapt to the terminal background and pass WCAG AA contrast. De-emphasized
text uses the terminal DIM attribute, not a grey colour;ENGRAMS_TUI_NO_DIM=1turns it
off. (#1670) - When a session starts without an integration because the person has not connected their
personal credential, the agent is told which integration is off and how to connect it.
Before, only the web start screen showed this. (#1671) - Updates to the AWS SDK, parking_lot 0.13, zip 9,
@hookform/resolvers6, and other
dependencies.
Fixed
- A warm base capture could fail with
pre-capture guest sync exited Some(1)when a command
in the guest wrote its output while the capture cleared the exec journal. (#1672) - The CLI sends
Content-Lengthon every request. Without it, a front end that requires the
header refused requests with no fields (HTTP 411), for exampleauth statusand
task list. (#1652) engrams auth loginandengrams auth statusshow why a key could not be verified.
(#1654)engrams session logsprinted the event-stream envelope instead of the event payload.
(#1644)- The CLI help no longer refers to a design record. (#1662)
Artifacts
Release 0.12.0 at 1e869fdaeb84
| Artifact | Tag | Built from | Digest |
|---|---|---|---|
coordinator |
0.12.0 |
66c352acc4f1 |
sha256:57bb1922f2d2d7e94d844f56302a74650cb455bf2cbe99cb94ed771283826050 |
host-agent |
0.12.0 |
66c352acc4f1 |
sha256:f7a7d889c051e3a94d923d5ff620c4da8994945627ab82c91f64ccf65d8c78dc |
host-operator |
0.12.0 |
66c352acc4f1 |
sha256:3d46f924c6df8170b36a04eae5a8c60e714533c49156cb1f6d74b797633a031d |
web |
0.12.0 |
3532d2a0c6c1 |
sha256:97b878ab944815595f006eabbb3eb2c50614c7ebc0d84087828828423d064473 |
orchestrator |
0.12.0 |
63faefa2982e |
sha256:a0a4a10e699e8d757be1b1d2718760e60df1893caade7b50cdc7bf7b7d698149 |
node-assets |
0.12.0 |
66c352acc4f1 |
sha256:c01ed523d75167ccb2f7efe307f918c792e3fbabd2b0d636de67becc5ae374f1 |
cli-tools |
0.12.0 |
1e869fdaeb84 |
sha256:950065779aa3e7363a4db8bae0d5b3d60d773fec88e1066ec64c5e00872f3f58 |