you.md

Getting Started

you.md creates a persistent identity context that any AI agent can read. Think of it as a .env file for your identity -- your bio, projects, values, communication style, and preferences, all in one place.

Web Quickstart

1. 1Go to you.md/create
2. 2Pick a username and enter your name
3. 3Your profile is created instantly -- no account needed
4. 4Sign up at you.md/sign-up to claim ownership
5. 5Open the dashboard, type /share to get your shareable context link

CLI Quickstart

$ npx youmd init

1. 1The agent walks you through creating your identity interactively
2. 2Run youmd login to connect to you.md
3. 3Run youmd push to publish your profile
4. 4Run youmd chat then type /share to get your context link

Share Your Identity

The core feature. Once your identity is built, share it with any AI agent in seconds. The /share command works in both the web dashboard and the CLI.

/share Command

Type /share in either the web dashboard terminal or inside youmd chat on the CLI. Both generate the same copyable block:

> /share

--- BEGIN YOU.MD CONTEXT ---
name: Houston Golden
role: Founder & builder
projects: you.md, ...
values: ship fast, build in public
preferences: terminal-native, monochrome
--- END YOU.MD CONTEXT ---

[copied to clipboard]

Paste this into any AI conversation -- Claude, ChatGPT, Cursor, Copilot, or any agent. It instantly knows your bio, projects, values, and preferences.

Use /share --private to include your private layer (contact info, internal notes, sensitive preferences). Only share this with agents you trust.

Context Links

Your public context is always available at you.md/ctx/[username]. Any agent can fetch this URL directly to load your context into their conversation.

Sync

You.md works across web and CLI. Create your profile on either platform and keep them in sync.

Connecting Web + CLI

1. 1Create your profile on either web or CLI
2. 2Get an API key from the dashboard (/tokens)
3. 3youmd login -k YOUR_KEY or youmd login --web
4. 4youmd pull downloads your web profile to local files
5. 5Edit files in any editor (Cursor, Obsidian, VS Code)
6. 6youmd push compiles and publishes back to you.md
7. 7youmd sync --watch auto-syncs on every file save

Local File Structure

.youmd/
  profile/
    about.md
    now.md
    projects.md
    values.md
    links.md
  preferences/
    agent.md
    writing.md
  voice/
    voice.md
    voice.linkedin.md
  you.json
  you.md
  manifest.json

CLI Reference

Install globally with npm i -g youmd or run commands directly with npx youmd.

API

You.md exposes HTTP endpoints for programmatic access to identity context.

Public Endpoints

# Fetch a public profile
GET /api/v1/profiles?username=houston

# Public context (agent-readable, plain text)
GET /ctx/[username]

# JSON context
GET /ctx/[username].json

Context links at /ctx/[username] return a plain-text identity block optimized for AI consumption. Agents can fetch this URL directly.

Authenticated Endpoints

For private context, include an access token:

GET /ctx/[username]?scope=private
Authorization: Bearer your_access_token

Privacy

You.md uses a two-layer privacy model:

Access tokens can be generated from the dashboard via /tokens. Each token has configurable scope and can be revoked at any time.

Dashboard Commands

The web dashboard terminal supports the following slash commands: