topskychen/tilde

> *Your AI agents' home directory*
**tilde** is a privacy-first Model Context Protocol (MCP) server that acts as the universal memory and profile layer for AI Agents.
Configure once. Use everywhere. Your data, your control.
Supports profile management, skills, resume import, and team sync.
---
The Problem
Every time you switch AI tools, you face the same issues:
- **🔄 Repetition**: "I'm a Senior SWE", "I prefer Python", "Don't use ORMs"
- **🧩 Fragmentation**: Preferences learned in Cursor aren't available in Claude
- **🔒 Privacy Concerns**: Unsure who has access to your personal context
The Solution
**tilde** acts as a "digital passport" that your AI agents can read:
---
Features
- **🏠 Local-First**: Your data stays on your machine by default
- **📋 Structured Profiles**: Identity, tech stack, knowledge, skills
- **🔌 MCP Standard**: Works with any MCP-compliant agent
- **✏️ Human-in-the-Loop**: Agents can *propose* updates, you *approve* them
- **🔧 Extensible Schema**: Add custom fields without modifying code
- **🔒 Skills Privacy**: Control which skills are visible to agents (public/private/team)
- **🤖 Agent-Callable Skills**: Define skills that AI agents can invoke on your behalf
- **📄 Resume Import**: Bootstrap your profile from existing resume/CV
- **📚 Knowledge Sources**: Books, docs, courses, articles - unified learning model
- **👥 Team Sync**: Share coding standards across your team
---
Quick Start
Installation
Development Installation
Configure Cursor
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global access):
Once configured, you'll see tilde in your MCP servers with all available tools and resources:
Configure Antigravity
Add to .gemini/antigravity/settings.json in your project:
Configure Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Example Usage
Once configured, your AI agent can access your profile. Try asking:
> **"What is my name?"**
The agent will use the get_profile tool to fetch your identity and respond with your name and role:
Create Your Profile
Edit ~/.tilde/profile.yaml:
---
MCP Resources
tilde exposes these resources to agents:
| Resource URI | Description |
|-------------|-------------|
| tilde://user/profile | Full user profile |
| tilde://user/identity | Name, role, experience, custom fields |
| tilde://user/tech_stack | Languages, preferences, environment |
| tilde://user/knowledge | Knowledge sources, domains, projects |
| tilde://user/skills | Skills (filtered by visibility) |
| tilde://user/experience | Work history |
| tilde://user/education | Education background |
| tilde://user/projects | Personal/open-source projects |
| tilde://user/publications | Papers and publications |
| tilde://team/context | Team coding standards and patterns |
---
MCP Tools
| Tool | Description |
|------|-------------|
| get_profile | Retrieve full or partial profile |
| get_team_context | Get team-specific context |
| propose_update | Agent proposes a profile update (queued for approval) |
| list_pending_updates | List updates awaiting user approval |
---
CLI Commands
Document Ingestion
Resume Import
Bootstrap your profile from an existing resume:
The resume importer extracts:
- **Identity**: Name, role, years of experience
- **Experience**: Work history with companies, roles, dates
- **Education**: Degrees, institutions, graduation years