Summary
Portable human context that follows you between AI tools instead of living inside one chat product's memory. Exposes profile artifacts as MCP resources so Claude can read your preferences, constraints, and communication style without you repeating them every session. Includes validation hooks, redaction policies, and interop formats for handoffs between assistants or orchestrators. Reach for this when you want stable context across coding agents, editors, or analysts without manually pasting system prompts. Integrates with SET for repo-local orchestration and generates compact JSON artifacts from markdown profiles. Think of it as the protocol layer underneath assistants, not another assistant itself.
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →ID Protocol
ID is Git-like infrastructure for portable human-AI identity context.
Git versions code. ID versions the reviewed context that tells AI tools how to work with a person.
It is not another assistant. It is the profile, contract, and release layer that can travel across tools.
profile.* -> source
soul.md -> build artifact
context.compact.json -> release bundle
idctl diff -> semantic identity diff
validate -> CI gate
provenance -> blame surface
freshness -> stale detection
What It Covers
- canonical owner-managed profile files
- compact derived
soul.mdfor fast agent bootstrap - portable interop artifacts (
context.compact,interop.v1,mcp) - validation, freshness, and publish-safety checks
- semantic identity diffs via
idctl diff - integration points for
SET,agentsgen, and other repo workflows
Works Across Tools
Claude Code
|
v
profile.* + soul.md + context.compact.json
|
v
ChatGPT / Gemini / Cursor / Continue / OpenAI API
The value is simple: create one reviewed profile, then reuse it across tools without rebuilding user context from scratch.
See docs/WILD.md for concrete cross-tool workflows.
Start In 5 Minutes
Install:
uv tool install id-protocol
Bootstrap:
idctl init --owner-id <owner-id>
idctl refresh-soul --owner-id <owner-id>
make validate
make compact
You end up with:
profile.minimal.mdas the first owner checkpointsoul.mdas the short reviewed handoff layercontext.compact.jsonas the portable compact artifact
Check what changed before sharing or switching tools:
idctl diff --owner-id <owner-id> --since 7d
Core Files
Source of truth:
profiles/<owner>/profile.minimal.mdprofiles/<owner>/profile.core.mdprofiles/<owner>/profile.extended.mdprofiles/<owner>/CHANGELOG.md
Derived layers:
profiles/<owner>/soul.mdprofiles/<owner>/context.compact.jsonprofiles/<owner>/interop.v1.jsonprofiles/<owner>/mcp.context.resource.json
Why This Exists
- system prompts are fragile and usually copied by hand
- chat-native memory is product-siloed and hard to audit
- repo instructions help per repo, not across tools or roles
IDkeeps user context explicit, versioned, reviewable, and portable
soul.md exists because the full profile stack is often too heavy for the first pass. It gives agents a short bootstrap surface without replacing the canonical profile files.
Ecosystem Role
IDowns portable human contextagentsgenowns repo-scoped agent contextSETcan orchestrate both layers
Practical rule:
- use
IDfor the human - use
agentsgenfor the repository - use
SETwhen you want orchestration around both
Quick Paths
Lite:docs/LITE.mdShare:docs/SHARE.mdBench:docs/BENCH.mdWild:docs/WILD.mdIdentity Diff:docs/IDENTITY_DIFF.mdSoul:docs/SOUL.mdIntegrations:docs/INTEGRATIONS.mdReleases:docs/RELEASES.md- full docs index:
docs/README.md
Live Public Metrics
Runs analyzed: 4
| Metric | Value | Meaning |
|---|---|---|
| onboarding latency | 1.15 | Less is better |
| clarification turns | 0.85 | Less hand-offs |
| task success | 0.6 | Higher is better |
| alignment index | 18.3 | Higher is better |
Profile freshness score (owner markoblogo): 0.0
Key artifacts:
- profiles/markoblogo/profile.core.md: score=0.0 age=98 ttl=14
- profiles/markoblogo/profile.extended.md: score=0.0 age=97 ttl=30
Current CLI Surface
idctl init --owner-id <owner-id>
idctl refresh-soul --owner-id <owner-id>
idctl validate
idctl diff --owner-id <owner-id>
idctl export-compact --owner-id <owner-id>
idctl export-interop --owner-id <owner-id>
idctl export-mcp --owner-id <owner-id>
Current Status
Today ID functions as:
- a protocol/spec reference
- a validated tooling reference
- a compact onboarding path
- a Git-like diff/review surface for AI identity context
- an installable CLI package on PyPI/Homebrew
Latest release: v0.4.0 adds idctl diff, wild workflows, and Git-like identity context positioning.
Featured
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →