Emend
Local OSS

user-profiles

Manage user profiles extracted from interactions.

emend user-profiles

Manage user profiles. Profiles are normally derived automatically from published interactions (emend publishemend user-profiles regenerate), but you can also seed them manually with add.

Command: emend user-profiles list

List profiles. With --user-id, queries a single user; without it, lists profiles across every user in the org.

emend user-profiles list [OPTIONS]
PropType
--user-idstr
--limitint
--statusstr
emend user-profiles list --user-id user_123 --status current

Command: emend user-profiles search

Semantic search over profiles for a specific user. A --user-id is required — cross-user profile search is not currently supported.

emend user-profiles search "<query>" --user-id <uid> [OPTIONS]
PropType
QUERYstr (positional)
--user-idstr
--limitint
--thresholdfloat
emend user-profiles search "dietary preferences" --user-id user_123 --limit 5

Command: emend user-profiles add

Manually add a profile, bypassing interaction-based inference. Useful for seeding known facts during testing or migration.

emend user-profiles add --user-id <uid> --content "<text>"
PropType
--user-idstr
--contentstr
emend user-profiles add \  --user-id user_123 \  --content "Prefers non-stop flights in the morning"

Command: emend user-profiles regenerate

Re-run the profile inference pipeline over a user's existing interactions. Useful after a prompt or extractor change.

emend user-profiles regenerate --user-id <uid> [--wait]
PropType
--user-idstr
--waitflag
emend user-profiles regenerate --user-id user_123 --wait

Command: emend user-profiles delete

Delete a specific profile, or all profiles for a single user when --profile-id is omitted.

emend user-profiles delete --user-id <uid> [--profile-id <pid>]
PropType
--user-idstr
--profile-idstr

Command: emend user-profiles delete-all

Delete every profile across all users. Prompts for confirmation unless --yes is set.

emend user-profiles delete-all [--yes]
PropType
--yes / -yflag
Danger
Irreversible. Consider running emend user-profiles delete --user-id <uid> for a single user first.