User Environment

User Environment

Purpose: User identity, authentication, preferences, AI persona configuration, and personal context. The User environment is the personality layer that makes Nexus personal - like a coworker who knows you.

Multi-Tenant Architecture

Nexus is multi-tenant - multiple users can engage with AI from different access points: - VS Code Server - Phone applications - Web applications - Voice interfaces

When authenticated, the user's stable ID (u_XXXX) is embedded in ALL data written across ALL environments.

User Data Structure

Identity

• name - Full name (e.g., Christopher Foust)
• stable_id - Unique ID (e.g., u_z1p5)
• role - Position/role (e.g., Owner, Developer, Vendor)
• company - Company affiliation (e.g., Corlera)
• email - Contact email

AI Persona Preferences

• ai_persona_name - What they call the cloud AI (e.g., Lena)
• local_ai_name - What they call the local AI (e.g., LARS)
• response_style - How they want AI to respond:
• clear_concise - Direct, to the point
• friendly - Warm, conversational
• professional - Formal, business-like
• technical - Detailed, precise
• voice_preference - TTS voice for cloud AI
• local_voice_preference - TTS voice for local AI

Personal Context

• family - Family members, relationships
• interests - Hobbies, interests
• important_dates - Birthdays, anniversaries
• timezone - User's timezone (e.g., America/Denver)
• location - City/region for weather context

Session State

• current_session - Pointer to active session ID
• preferences - UI and behavior preferences

Key Patterns

• user:{user_id}:profile - Core profile data
• user:{user_id}:preferences - AI and system preferences
• user:{user_id}:current_session - Active session pointer
• user:{user_id}:context - Personal context (family, interests)

Notes

• Formerly called "Core" environment in early Nexus versions
• Central to stable ID resolution via user_helper.py
• Authentication happens at access point, stable ID flows through system