Skip to content

ctx v5.49.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 00:44
· 24 commits to root since this release
v5.49.0
d00aaeb

v5.49.0 — the MCP server instructions are a setting, with a new default wording

Minor release after v5.48.4. No migration. Two new settings.

MCP instructions (#327, supersedes #315 by DamieMoon):

  • The text the MCP server sends with initialize (and server/discover) is now
    two hot, global-only settings: mcp.instructions_enabled (default true;
    false sends nothing) and mcp.instructions (the text).
  • New default wording: "ctx is your memory across sessions. Before you answer
    from memory or start work, look it up: 'search' for a lightweight lookup,
    'query' for a question that needs a synthesized answer. When you learn
    something that should outlast this session, save it with 'store' and put
    its source into metadata.source." Measured on #315 with Claude Code (1,080
    headless runs, 24 prompts, three models): a lookup before the first file
    at the start of work rose from 72 % with the old wording to 100 %, with no
    added lookups on tasks ctx cannot help with.
  • ctx keeps an append-only history of every wording it has shipped. An
    instance without an own text, or whose stored text equals any shipped
    wording, follows the newest one across updates. An own text is never
    overwritten; it records the shipped wording it was written against.
  • GET /api/settings, ctx settings get mcp.instructions and the settings page
    show the comparison: what is sent (off, shipped, custom), the wording this
    release ships, the base of an own text and whether ctx has changed its
    wording since. ctx settings get mcp.instructions --text
    value|current|base| prints one text raw, for diff.
  • Bounds: at most 2,048 characters (UTF-16 code units), valid UTF-8, no
    control characters other than tab and line breaks, not blank. A PUT
    outside the bounds is a 422.
  • The metadata description of the MCP tools store and update names
    metadata.source, so clients that do not pass server instructions to the
    model (Hermes) see the key too.
  • The boot record config: effective carries mcp_instructions (the state,
    never the text).

Behaviour change: every MCP client receives the new default wording at
initialize instead of "ctx is a persistent knowledge store with hybrid
retrieval. ...". To keep the old one, set mcp.instructions to it (ctx
settings get mcp.instructions --text 1 prints it); to send nothing, set
mcp.instructions_enabled to false.

For operators: after an update, ctx settings get mcp.instructions says
whether the shipped wording changed since an own text was written.

Not verified: clients other than Claude Code and the Go SDK client of the
tests against the new middleware; the measurement covers single-turn runs
with German prompts against a stub server.

Installation

With Go (build from a clone):

git clone --branch v5.49.0 --depth 1 https://github.com/GottZ/ctx && cd ctx
go -C go build -o ctx ./cmd/ctx && sudo install -m 0755 go/ctx /usr/local/bin/ctx

Binary download:
Download the binary for your platform (and SHA256SUMS), verify both, then install:

gh attestation verify ctx-<os>-<arch> -R GottZ/ctx   # signed build provenance
# offline: add --bundle ctx.intoto.jsonl (Sigstore bundle attached to this release)
sha256sum -c --ignore-missing SHA256SUMS            # download integrity
chmod +x ctx-*
sudo mv ctx-* /usr/local/bin/ctx