CLI

reflexio interactions

Publish, list, search, and delete user-agent conversations.

Manage interactions — the raw conversations between a user and your agent. Publishing an interaction feeds the profile and playbook extractors; everything else is available through the same group for inspection and cleanup.

reflexio publish at the top level is a shortcut for reflexio interactions publish. The options and examples on this page apply to both.

Command: `reflexio interactions publish`

Publish one or more interactions for a user. Supports three input modes:

Single-turn — pass --user-message and --agent-response for a one-shot capture.
File / stdin — stream a JSON or JSONL payload via --file or --stdin.
Inline — pass --data '{...}' (or --data @path/to/file.json).

Terminal

reflexio interactions publish [OPTIONS]

Options

Prop	Type	Default	Description
`--user-id?`	`str`	`none`	User identifier. Optional if the JSON payload already contains `user_id`, required for single-turn mode.
`--session-id`	`str`	`—`	Non-empty session ID for grouping multiple interactions. Required unless each JSON payload includes `session_id`.
`--source?`	`str`	`"cli"`	Non-sensitive producer/workflow label matching `^[a-z0-9][a-z0-9._:-]{0,127}$`. Never use user identifiers or PII.
`--agent-version?`	`str`	`none`	Agent version string. Used downstream for playbook scoping.
`--wait?`	`flag`	`false`	Block until the server completes extraction. Without this, the server queues extraction and returns a bare acknowledgement.
`--user-message?`	`str`	`none`	Single-turn user message (pairs with --agent-response).
`--agent-response?`	`str`	`none`	Single-turn agent response (pairs with --user-message).
`--data?`	`str`	`none`	Inline JSON payload, or `@path/to/file.json` to load from disk.
`--file?`	`path`	`none`	Path to a JSON or JSONL file containing one or more payloads.
`--stdin?`	`flag`	`false`	Read the JSON/JSONL payload from stdin.
`--skip-aggregation?`	`flag`	`false`	Run profile/playbook extractors but skip the aggregation step that promotes user playbooks into the agent playbook layer.
`--force-extraction?`	`flag`	`false`	Bypass stride_size checks and always run extractors, even if the configured sliding window has not elapsed.

Payload format

When using --data, --file, or --stdin, the payload is a JSON object (or JSONL stream of objects) with at minimum an interactions array:

json

{
  "user_id": "user_123",
  "session_id": "session_abc",
  "source": "support-agent:v2",
  "agent_version": "v1",
  "interactions": [
    { "role": "user", "content": "Find me a flight to Tokyo" },
    { "role": "assistant", "content": "Searching flights..." }
  ]
}

Fields set in the payload override the corresponding CLI flags. tools_used and other InteractionData fields are forwarded verbatim so the server can emit [used tool: ...] markers for playbook extraction.

Examples

Terminal

# Single-turn capture
reflexio interactions publish \
  --user-id user_123 \
  --session-id session_abc \
  --user-message "Find me a flight to Tokyo" \
  --agent-response "Searching flights..."

# JSONL file, blocking until extraction finishes
reflexio interactions publish --file conversations.jsonl --session-id session_abc --wait

# Inline payload with force extraction
reflexio interactions publish \
  --data '{"user_id":"user_123","session_id":"session_abc","interactions":[{"role":"user","content":"hi"},{"role":"assistant","content":"hello"}]}' \
  --force-extraction

# Stream from stdin
cat conversations.json | reflexio interactions publish --stdin --user-id user_123 --session-id session_abc

Command: `reflexio interactions list`

List recently published interactions, optionally filtered by user.

Terminal

reflexio interactions list [OPTIONS]

Prop	Type	Default	Description
`--user-id?`	`str`	`none`	Filter by user ID.
`--limit?`	`int`	`20`	Maximum number of interactions to return.

Terminal

reflexio interactions list --user-id user_123 --limit 10

Command: `reflexio interactions search`

Run a semantic search over published interactions.

Terminal

reflexio interactions search --query "flight booking" [OPTIONS]

Prop	Type	Default	Description
`--query?`	`str`	`—`	Search query string. Required.
`--user-id?`	`str`	`none`	Filter by user ID.
`--limit?`	`int`	`10`	Maximum number of results.

Terminal

reflexio interactions search --query "morning commute" --user-id user_123

Command: `reflexio interactions delete`

Delete a single interaction.

Terminal

reflexio interactions delete --interaction-id <id> --user-id <uid>

Prop	Type	Default	Description
`--interaction-id?`	`str`	`—`	Interaction ID to delete. Required.
`--user-id?`	`str`	`—`	User ID that owns the interaction. Required.

Command: `reflexio interactions delete-all`

Delete every interaction across all users. Prompts for confirmation unless --yes is passed.

Terminal

reflexio interactions delete-all [--yes]

Prop	Type	Default	Description
`--yes / -y?`	`flag`	`false`	Skip the interactive confirmation prompt.

This is irreversible. The server deletes interactions, not their derived profiles/playbooks — run reflexio user-profiles delete-all and reflexio agent-playbooks delete-all separately if you also want to wipe downstream state.