Repository navigation
ctx v5.49.0
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/ctxBinary 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