Whoami

whoami — User Identity Profile Management

Overview

whoami enables AI Agents to automatically recognize user identity during conversations. Through a remotely stored profile, any AI can quickly "know you" on first interaction without requiring repeated introductions.

Core capabilities:

• Read user profile from remote and inject into conversation context
• Save/update user identity information to remote
• Execute subsequent tasks (calling other skills, writing code, etc.) based on user preferences
• Share the same user profile across AI tools

Workflow Decision Tree

User initiates conversation
    │
    ├─ Is ~/.whoamiagent configured?
    │   ├─ YES → Run `get` to read remote profile → Inject into context → Continue with task
    │   └─ NO  → Script auto-opens browser login page → Agent tells user to log in and get API Key → **Agent STOPS and WAITS for user to reply with API Key** → Agent runs `setup` to save config
    │
    ├─ User requests to update info?
    │   └─ YES → Organize into Markdown → Write to temp file → Run `update --file` to write to remote → Confirm success
    │
    └─ User asks "do you know me?"
        └─ Run `get` → Display profile summary

1. Configure API Key (First Use)

If not yet configured, simply running get or setup will auto-open the browser login page. After logging in, the user generates an API Key on the Dashboard and provides it to the Agent.

Once the Agent receives the API Key, run:

python3 <skill-dir>/scripts/whoami_profile.py setup wai_xxxxxxxxxxxxxxxx

Or use interactive setup (also auto-opens browser):

python3 <skill-dir>/scripts/whoami_profile.py setup

Config file is saved at ~/.whoamiagent, format:

WHOAMI_API_KEY=wai_xxxxxxxxxxxxxxxx

2. Get User Profile

When you need to understand the user's identity, run the script to fetch the remote profile:

python3 <skill-dir>/scripts/whoami_profile.py get

• If a remote profile exists, the script outputs Markdown content
• If no remote profile exists, the script outputs a prompt; guide the user to create one

After loading the profile, use its content as context to understand the user, then continue executing the user's actual task.

3. Update User Profile

When the user provides new personal information, overwrite-update to remote.

Recommended: Write content to a temp file first, then use --file flag (avoids shell argument length limits and special character issues):

# Step 1: Agent writes the full profile Markdown to a temp file
#         (use write_to_file or echo/cat to create the file)
# Step 2: Run update with --file
python3 <skill-dir>/scripts/whoami_profile.py update --file /tmp/whoami_profile_tmp.md

The script reads the file content, uploads it, and automatically deletes the temp file after reading.

Alternative (for short content only):

python3 <skill-dir>/scripts/whoami_profile.py update "Short profile content"

Note: update is an overwrite operation. Always pass the complete profile content. The remote automatically retains the last 3 historical versions.

Length limit: Profile content must not exceed 5000 characters (~2000 Chinese characters or ~2000 English words). The API will return an error if exceeded. Keep the profile concise and within this limit when generating.

Profile format spec: See <skill-dir>/references/profile_format.md

4. View Profile Metadata

python3 <skill-dir>/scripts/whoami_profile.py info

Outputs profile metadata such as character count and line count.

Examples

Example 1: Auto-load at conversation start

User says: "Help me write a Python script to process CSV"

Agent behavior:

1. Run whoami_profile.py get to fetch user profile
2. Learn user preferences from profile (e.g., "prefers concise code style", "uses pandas")
3. Generate code matching the user's style

Example 2: User saves info proactively

User says: "Remember that I'm Mofan, an indie developer skilled in Python and ML"

Agent behavior:

1. Run whoami_profile.py get to fetch existing profile
2. Merge new info into existing profile, organize into complete Markdown
3. Write the complete profile to a temp file (e.g., /tmp/whoami_profile_tmp.md)
4. Run whoami_profile.py update --file /tmp/whoami_profile_tmp.md to overwrite-update
5. Confirm save success

Example 3: First-time setup

User says: "Do you know me?"

Agent behavior:

1. Run whoami_profile.py get
2. If API Key is not configured, the script auto-opens the browser login page. Agent MUST:
   • Tell the user: "I've opened the login page in your browser. Please log in, generate an API Key on the Dashboard, and paste it here."
   • STOP here and wait for the user to reply with the API Key. Do NOT run any other commands or take any further actions until the user responds.
   • Once the user provides the API Key (starts with wai_), run whoami_profile.py setup wai_xxx to complete configuration
   • Then run whoami_profile.py get again to fetch the profile
3. If already configured, display profile summary

Important Notes

1. Config file path is ~/.whoamiagent (cross-platform: macOS/Linux/Windows), shared by all AI tools
2. Profile uses Markdown format, readable by both humans and AI
3. After loading profile, you must continue executing the user's actual task — do not stop at the loading step
4. update is an overwrite operation — always pass complete content; remote retains 3 history versions
5. Profile max 5000 characters — keep it concise, avoid redundant descriptions
6. refers to the directory path where this SKILL.md is located
7. Script uses only Python standard library, zero third-party dependencies
8. When API Key is not configured, the agent MUST stop and wait for the user to respond. Do not retry the command, do not run other whoami commands, and do not proceed with any actions. The user needs time to log in via browser, generate an API Key, and paste it back. Only after the user provides the API Key should the agent continue.