# neosian

> Memory and context for the agent you already use. One Rust binary,
> CLI/MCP/HTTP interfaces, state on your own files or Postgres.

Release: 2.12.1. Read installed pages with `neosian docs TOPIC` or the MCP
`docs` tool. They are versioned with the executable and are authoritative
for that version. The release's neosian-docs.json carries the same pages.

- [Quickstart](https://neosian.com/docs/quickstart): install and connect clients.
- [Profiles](https://neosian.com/docs/profiles): portable workspaces, bindings, grants and explicit capture.
- [Memory](https://neosian.com/docs/memory): mounts, current-document search, versions and upkeep.
- [Knowledge](https://neosian.com/docs/knowledge): Markdown imports, optional collections, references and readable bundles.
- [Governance](https://neosian.com/docs/governance): ownership, content-bound review, effective/expiry state and retrieval policy.
- [Skills](https://neosian.com/docs/skills): versioned instructions, portable text packages, dependencies and profile revision guards.
- [Changes](https://neosian.com/docs/changes): durable references, checkpoints, explicit gaps and storage recovery.
- [Exchange](https://neosian.com/docs/exchange): one-way snapshots/deltas, local replica checkpoints, conflicts and erasure.
- [Messaging](https://neosian.com/docs/messaging): messages, reminders and claims.
- [Stores](https://neosian.com/docs/stores): formats and HTTP conformance.
- [Agents](https://neosian.com/docs/agents): recording through client hooks.
- [Native memory](https://neosian.com/docs/native-memory): explicit local source capture and hook reminders for Claude Code and Codex.
- [CLI](https://neosian.com/docs/cli): command grammar and operator actions.
- [MCP](https://neosian.com/docs/mcp): tools, prompts and transports.
- [Topology](https://neosian.com/docs/topology): local, Postgres and remote access.
- [Wire](https://neosian.com/docs/wire): storage HTTP protocol version 6.
- [Migration](https://neosian.com/docs/migration): v1 compatibility and retired APIs.

Version 2 has no Python product, dedicated SDK, agent runtime or model
provider integration. Custom backends implement the tested HTTP contract.
Memory, turns and mailbox remain format 1; Postgres remains schema 4.
Error identifiers are append-only; `neosian schema errors` lists them.
Profile format 1 selects sources and bounded context independently of machine
or agent account. New profile capture is off. Server grants authorize shared
access; local bindings hold environment references, never exported secrets.

Memory-search version 1 adds authorized keyword search over current documents
and selected metadata with excerpts and source references. Remote sources
advertise the optional capability; history search remains a separate operation.

Knowledge format 1 supports previewed Markdown/bundle imports into explicit
mounted collections. Optional field rules are advisory; structure and source
provenance live in versioned content. References never grant target access.
Apply/export requires paused writers; full-history archives remain separate.
Knowledge batches default to 10,000 documents and 256 MiB with explicit local
budgets. Paged reads and disk staging avoid retaining all collection bodies.
Replica budgets are separate from the unchanged format-1 exchange bundle bounds.
Read the stores page for byte settings, recovery behavior and remaining limits.

Skill changes preview until --write; imports use explicit /mount/skills/name.
Supporting text and dependencies are checked through mounted reads. Profile pins
guard current source/version/hash, never load erased or historical fallbacks.
Apply/export needs paused writers. Skills execute in the user's agent.

Reviewed upkeep format 1 provides bounded scans, source-preserving proposals,
preview and explicitly approved apply over existing scoped storage. The digest
binds content, not authority. Pause writers and inspect partial/lost-response
outcomes before fresh proposals. No model execution, scheduler or DDL is added.

Governance format 1 is optional versioned knowledge content. Owner/reviewer
labels and hashes never grant authority. Profile all/effective/approved policies
select knowledge context and skills; optional knowledge-policy version 1 filters
search before excerpts/paging. Raw authorized reads/history remain inspection
paths. Expiry does not delete; body erasure includes review/provenance metadata.

Change-feed version 1 is an optional wire-6 capability. Scope events and memory
mutations recover together; Postgres requires a separate operator-installed
extension 1 on schema 4. Check current grants, handle explicit gaps and retain
opaque cursors. References survive content erasure, never grant access and never
start agents. Mailbox context pins current documents without copying bodies.

Exchange format 1 carries current memory from one authorized tracked scope to
a dedicated local FileStore replica. Pause source writers; preview and explicitly
apply with a durable receipt. Reject reordered bundles, local drift and missing
checkpoints. Gaps require a fresh snapshot. Source history, raw turns, lifecycle
state and bindings are excluded. Bundles/backups require separate erasure.

Setup shows running, PATH and registered executable paths, storage and capture.
`setup --check` inspects saved settings and probes MCP with temporary file storage.
Configured source access is not checked; client connection and hook delivery are
not observed. Restart the client and review hook trust after saving registrations.

Codex setup installs the native `$neosian-upkeep` entry for its skill picker.
It loads live `builtin:upkeep` instructions over MCP in the current conversation.
Setup checks missing/outdated entries, preserves local edits and supports a
persistent `--codex-skills off` opt-out (`on` restores it). Profile selections
and mounted permissions still apply; this does not install stored memory skills.

Claude Code setup installs a host-owned cache mod through the public plugin CLI.
An observed one-hour subscription cache is maintained near minute 55 while idle,
until session close. Expired or uncertain caches warn and wait for normal user
activity. `/neosian-cache` provides status, on/off and duration controls. Cache
estimates cannot guarantee a server hit; actual receipts stop unexpected retries.
Memory/MCP/search paths gain no model dependency. Read `neosian docs agents`.

Native memory capture defaults off. `native-memory add` previews a selected
Markdown file/directory, client, project, local store and mounted scope;
`--write` consents to future hook capture. Copies and receipts commit together,
refuse edited/deleted/erased destinations, and never change source files.
Profiles and remote destinations are unsupported. Capture runs at hook boundaries,
not continuously; read `neosian docs native-memory` for bounds and recovery.