One file across every agent.
Write yourself down once. Every AI you use reads it before answering, and proposes updates as it learns you. You approve the good ones.
Home · Docs · Pricing · Stack · Privacy
Anyone using AI seriously pays the same tax: re-explaining themselves every chat, every tool, every session. Creed (creed.md) kills that tax with one file.
Your Creed is a curated personal context profile in plain Markdown, sized to read in under a minute. Connected agents (Claude, ChatGPT, Codex, Cursor, Devin, and any MCP client) read it before they answer you, and propose edits as they learn new things. The file sharpens over time instead of rotting in your notes.
It is not a notes app, a journal, or a memory dump. If you already maintain a hand-rolled CLAUDE.md or a "things ChatGPT gets wrong about me" list, Creed is that file as a real product: first draft written for you, quality scored, one canonical version everywhere, agent edits gated behind your approval.
┌──────────────────────┐ ┌────────────────────┐
│ You (onboarding) │ ──────► │ Your Creed file │
│ (one short pass) │ │ 10 sections, MD │
└──────────────────────┘ └─────────┬──────────┘
│
┌────────────┴────────────┐
▼ ▼
┌─────────────────────┐ ┌──────────────────────┐
│ Agent reads it │ │ Agent proposes an │
│ before answering │ │ update; you approve │
└─────────────────────┘ └──────────────────────┘
Ten sections, five always-on (Identity, Goals, Work, Preferences, Routines) and five optional (Beliefs, Constraints, People, Health, Context). Every section is agent-writable, per-section permissions decide whether edits apply directly or wait for review.
Personal is the core one-user product. Company extends the same file model into a shared workspace: roles, per-section permissions, attribution, invites, pooled AI credits, seat billing.
Prerequisites: Node 20+ and a free Supabase project. (OpenRouter key only for AI features, Stripe only for paid-plan flows.)
git clone https://github.com/connorhpbrn/creed.git
cd creed && npm install
cp apps/creed/.env.example apps/creed/.env.local
(cd apps/creed && supabase link --project-ref <your-project-ref> && supabase db push)
npm run dev # → http://localhost:3000Minimum .env.local to boot:
NEXT_PUBLIC_SITE_URL=http://localhost:3000
NEXT_PUBLIC_SUPABASE_URL=https://<project>.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=<publishable-key>
SUPABASE_SECRET_KEY=<service-role-key>
CREED_ENCRYPTION_SECRET=$(openssl rand -base64 32)Every other variable (OpenRouter, Stripe, GitHub sync, branding, feedback) is documented inline in apps/creed/.env.example. supabase db push creates the full schema: sections, proposals, activity, tokens, MCP, GitHub, AI usage, audit log, rate limits, entitlements, all behind row-level security.
Wire up Stripe for the paid flows (optional)
The hosted app gates /file behind a paid entitlement. Locally you can skip Stripe entirely (unentitled users land on /pricing), or run the full flow: set the four STRIPE_* vars from apps/creed/.env.example with sandbox keys, then
stripe listen --forward-to localhost:3000/api/stripe/webhookand copy the printed whsec_… into STRIPE_WEBHOOK_SECRET. Test payments then auto-grant entitlements.
Deploy your own hosted instance
- Set
NEXT_PUBLIC_SITE_URLto your deployed origin so OAuth and Stripe redirects resolve. - Set
CREED_CSP_ENFORCE=1after watching one deploy cycle in Report-Only mode. - Create a live Stripe webhook endpoint at
https://<your-domain>/api/stripe/webhookand use its signing secret. - Example agent prompts referencing
https://creed.mdare illustrative; real URLs derive from yourNEXT_PUBLIC_SITE_URL.
Open /connections and add the Creed MCP URL to your agent as a custom connector. The client opens a browser, you click Allow, done. No tokens to copy.
Creed is its own OAuth 2.1 authorization server (/authorize, /token, /register, /.well-known/*), so any spec-compliant MCP client connects from the server URL alone. First-class connect flows exist for Claude Code (one-line claude mcp add), Codex, Cursor (one-click), ChatGPT, Devin, OpenClaw, Hermes, OpenCode, Factory, Manus, and custom agents. Clients that do not speak MCP can use the documented /api/creed HTTP API.
Creed also ships a first-party terminal client. It uses the same OAuth screen and discovers every tool, resource, and prompt from the live MCP server, so a new MCP tool appears in the CLI without a second implementation or release.
npx creed-cliAgents get three verbs: read the file, propose an update, or direct-edit where you have granted it. The MCP health dashboard tracks per-agent reads, edits, proposals, and outcomes while keeping CLI activity separate.
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router, Turbopack), React 19, TypeScript |
| UI | Tailwind CSS v4, shadcn/ui, Tiptap editor, Framer Motion |
| Backend | Supabase (auth, Postgres, RLS, realtime), pg_cron retention jobs |
| AI | OpenRouter (managed credits or BYOK), per-feature model routing |
| Billing | Stripe (Personal and Company plans, seats, webhooks) |
| Sync | GitHub push/pull of creed.md, lossless Markdown round-trip |
Full tour at creed.md/stack.
apps/
├── creed/ main product and marketing site
│ ├── app/ routes, APIs, MCP, OAuth, and onboarding
│ ├── components/ product, marketing, auth, and UI components
│ ├── lib/ domain, persistence, integrations, and AI
│ ├── supabase/ canonical migrations and email templates
│ └── tests/ node:test suites
└── status/ independently deployed public status site
packages/
└── creed-cli/ published first-party terminal client
npm run dev # Creed on http://localhost:3000
npm run dev:status -- --port 3001 # status site on http://localhost:3001
npm run test # every workspace test suite
npm run typecheck # every workspace typecheck
npm run lint # every workspace lint
npm run build # every workspace production buildPRs welcome. Read CONTRIBUTING.md first; it is short and saves us both time. AI agents: read AGENTS.md instead, it is the same information written for you.
Found a vulnerability? Do not open a public issue; see SECURITY.md.