--space, or ANONA_SPACE_ID. In every
get, a null field means “not set here: the platform default applies”.
How set works
set changes the fields you name and keeps the rest. The API’s PUT is a
full replace, so sending only the changed field would clear every other one;
set reads the stored settings, applies your changes, and writes the whole
record back. Two consequences:
--clear FIELDunsets one field so it follows the platform default again. It is repeatable. Setting and clearing the same field in one command exits2.setwith no field named exits2and sends nothing.
set commands racing on the same
space can each overwrite the other’s change. Run them one after the other.
reset --yes clears every override in the group. Without --yes it exits 2
and sends nothing.
--json: get and set print the stored settings (after the write, for
set). reset prints {"reset": true, "space_id", "settings"}, written by the
CLI, since the API answers with no body.
chat-settings
--json: {"space_id", "memory_limit", "memory_token_budget", "auto_record", "memory", "chat_model"}.
reason-settings
--depth on the reason command itself still wins over the space’s
setting.
--json: {"space_id", "model", "depth"}.
extraction-settings
labels.json is a JSON array of groups. Each entry in values is an object
with value (and an optional description), not a plain string:
labels.json
type is value (one of the listed values), multi-values (any number of
them), text (one free-form value) or multi-text (any number of free-form
values). The two enumerated types need values; the free-form ones take none.
key is lowercase letters, digits, - or _, with no colon or spaces, and
not anona. Add "tag": true to stamp key:value onto each memory as a tag,
so retrieve can filter on it.
A --labels-file that cannot be read or is not a JSON array exits 2. The
server checks the rest (a label group’s shape, a reserved key) and answers
validation_error (exit 1). Settings change what future writes extract;
memories already stored are not re-extracted. See
Verifying a change.
--json: {"space_id", "mode", "guidance", "custom_prompt", "labels", "free_form_entities"}.
Permissions
On a space shared with you, changing settings is owner only: a member getsspace_owner_only (exit 4).