Memory

What Quox keeps between conversations, and how to see and manage it.

Maturity: Beta. The memory store is Stable; memory in chat and the agent memory tools are Beta; vector (semantic) search is Experimental. Read from QuoxCORE 1b8bf54d and the memory status record.

At a glance
What it is	What Quox keeps between conversations: facts, preferences, decisions, constraints and observations, plus the things they are about (hosts, services) and how those relate.
Where it runs	In the memory service on your QuoxCORE server, a SQLite database with full-text search. Each organisation's memories are separate.
When to reach for it	You want Quox to remember how you work and what your systems are, instead of being told every time.
How to start	Tell Quox "remember that backups run at 02:00", or run `quox memory create --type fact --content "backups run at 02:00"`.

What is stored

Kind	Example
Fact	"web-01 runs the public site"
Preference	"keep answers short"
Decision	"we deploy on Tuesdays"
Constraint	"never restart the database in office hours"
Observation	something an agent noticed while working
Entity and relation	web-01, and that it runs behind the load balancer

Core memories are a small pinned set that always goes with you into chat.

How Quox uses it in chat

When you ask something, Quox adds your core memories and the best keyword matches to the conversation, within a small size and time budget. Some agents also have memory tools, so they can save, search and update memories as they work; those tools are attached to specific agents, not all of them.

Search

Search is keyword search (full-text) by default. Vector, or semantic, search is Experimental: it needs an embedding provider, and if it is not available Quox quietly uses keyword search instead.

How Quox adapts to you

Alongside the store, Quox keeps a few working features. They are on in the free tier:

Working set: what you are focused on right now and the threads left open.
Style: how you like answers, across four dimensions: formality, verbosity, technicality and directness.
Beliefs and failures: how sure Quox is about something, and patterns from things that went wrong before.

Bring your history

You can import past chats from ChatGPT, Claude, Gemini and Perplexity. Imported memories arrive in cold storage, set apart, so they do not flood your conversations; secrets are redacted on the way in.

Manage it from the CLI

bash

quox memory list
quox memory search --query "backup window"
quox memory create --type preference --content "keep answers short"
quox memory pin <id>
quox memory forget <id>
quox memory export

Free and paid

	Free	Advanced Memory add-on
Memories	2,000	No cap
Episodic items	2,000	No cap
Preferences	200	No cap
Context budget	2,000 tokens	No cap
Style, beliefs, failures, working set, import	Included	Included

The add-on is in the store, where its current price is shown.

Trust and provenance

Each memory records where it came from (you said it, an agent inferred it, it was imported) and a trust score, so something you stated outranks a guess. When a new fact contradicts an old one, the newer one can supersede it. Memory changes are written to the audit log on a best-effort basis.

Limits

Semantic search is Experimental. Keyword search is what you get by default.
Recall of whole past conversations is off by default and Beta when switched on.
Memory tools are attached to some agents, not every agent.
Moving imported memories from cold to warm or hot happens in the browser today; it does not yet have a server-side store.
The audit trail for memory changes is best-effort, not guaranteed for every operation.

Agents: which agents carry memory tools.
Architecture: where the memory service sits.
QuoxCLI: the quox memory commands.

Last verified 2026-10-29 against QuoxCORE 1b8bf54d (code) and the memory status record.