`reflexio interactions`

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}

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).

reflexio interactions publish [OPTIONS]

Options

Prop

Type

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:

{
  "user_id": "user_123",
  "session_id": "session_abc",
  "source": "chat",
  "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

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

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

# Inline payload with force extraction
reflexio interactions publish \
  --data '{"user_id":"user_123","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

Command: `reflexio interactions list`

List recently published interactions, optionally filtered by user.

reflexio interactions list [OPTIONS]

Prop

Type

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

Command: `reflexio interactions search`

Run a semantic search over published interactions.

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

Prop

Type

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

Command: `reflexio interactions delete`

Delete a single interaction.

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

Prop

Type

Command: `reflexio interactions delete-all`

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

reflexio interactions delete-all [--yes]

Prop

Type

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.

interactions

On this page