AI Passport

One identity. Every AI.

AI Passport is an open identity layer for AI systems. It allows users—not AI providers—to own, manage and securely share their AI identity across applications.

Links: Spec site · CLI npm · SDK npm · GitHub · Manifesto · Cursor Setup

Quick start

npm install -g @ai-passport-core/cli
ai-passport init
ai-passport grant cursor --yes
ai-passport plugin run git --path . --yes
ai-passport export cursor

Without global install: npx @ai-passport-core/cli init

Demo

~21s — question, get_passport_context, and TypeScript/Node.js answer from your passport.

Mission

One identity. Every AI.

Supporting line: Your AI identity. Everywhere.

North star: A user should be recognized by any AI, with explicit permission, without having to start over.

What it does

| Feature | Description | |---------|-------------| | Local passport | Encrypted identity at ~/.ai-passport/ | | Permissions | Grant / revoke per AI consumer (Cursor, etc.) | | Git plugin | Detect languages, frameworks, project from repo | | MCP server | Cursor reads passport via ai-passport mcp serve | | Memory provider | Local vault + grant-scoped context (RFC 0007) | | Portable schema | Open passport.schema.json format |

Cursor integration

See docs/CURSOR_SETUP.md for the full setup and "wow moment" test.

MCP config (after global install):

{
  "mcpServers": {
    "ai-passport": {
      "command": "ai-passport",
      "args": ["mcp", "serve", "--consumer", "cursor"]
    }
  }
}

CLI commands

| Command | Description | |---------|-------------| | ai-passport init | Create encrypted passport | | ai-passport onboard [consumer] | First-time setup + MCP config | | ai-passport info | Passport ID, grants, schema version | | ai-passport grant <consumer> | Approve scoped access | | ai-passport authorize <client> | Sign in — issue short-lived token | | ai-passport token exchange <token> | Exchange token for context JSON | | ai-passport revoke <consumer> | Revoke all grants | | ai-passport export <consumer> | Filtered JSON context | | ai-passport plugin run git | Analyze repo → coding profile | | ai-passport memory init | Initialize local memory vault | | ai-passport memory status | Memory provider status | | ai-passport memory store <ns> <text> | Store a scoped memory record | | ai-passport memory query [consumer] | Query grant-scoped memory (CLI) | | ai-passport grant <consumer> --memory <ns> | Grant with memory namespaces | | ai-passport mcp serve | Start MCP server (stdio) |

Programmatic API

SDK (recommended):

import { Passport } from '@ai-passport-core/cli/sdk';

const passport = await Passport.load();
const info = await passport.info();
const context = await passport.export('cursor');

See SDK.md for the full API.

Low-level:

import { PassportManager } from '@ai-passport-core/cli';

const manager = new PassportManager();
const info = await manager.info();
const context = await manager.export('cursor');

Documentation

• Manifesto — contribution compass (8 principles)
• Vision (constitution)
• Architecture
• Cursor Setup
• SDK
• Technical Specification
• Roadmap
• Planning & TODO
• Security
• API Contract
• Open Specification
• Compatibility Checklist
• RFC Process
• Sign in with AI Passport (draft)
• Ecosystem
• VS Code Setup

Demo (20–30 sec GIF)

.\scripts\demo.ps1

See docs/DEMO.md · Record a new GIF with the AI answer on screen (~25s).

Development

git clone https://github.com/Mendocan/ai-passport.git
cd ai-passport
npm install
npm run build
npm run passport -- init --from-example
npm test

Status

Phase 4 complete — Open spec index, compatibility checklist, RFC process.
Phase 5 complete — Sign in, cloud sync.
Phase 6 (memory) — RFC 0007 Accepted; CLI @0.3.1 on npm (confidence decay, knowledge graph).

License

MIT — see LICENSE.