{
  "markdown": "# soul.md\n\n> **Your identity, not theirs.** One file, every AI.\n\n`soul.md` is an open format for your AI identity — values, voice, skills, taste. A plaintext file you own, version in git, and carry between tools. **Manoma** is the reference MCP server that makes any LLM read your soul.md.\n\n- **User-owned** — lives on your machine, in your repo. No cloud, no account, no vendor.\n- **Portable** — works with Claude Desktop, Cursor, Zenflow, and any MCP-aware client.\n- **Built to outlive models** — git-diffable, forkable, versioned. A format, not a walled garden.\n\nSee the [soul.md format specification](SPEC.md).\n\n---\n\n## Install\n\nOne line in your Claude Desktop, Cursor, or Zenflow config:\n\n```json\n{\n  \"mcpServers\": {\n    \"manoma\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"manoma-mcp\"]\n    }\n  }\n}\n```\n\nThen drop your soul.md at `~/soul.md`.\n\n### Get a soul.md\n\n- **Web builder** — [manoma.ai/build](https://manoma.ai/build) — fill the form, download the file.\n- **Template** — `cp templates/founder.md ~/soul.md` (also: `engineer.md`, `designer.md`, `pm.md`).\n\n---\n\n## Tools the MCP server exposes\n\n**Read** — `get_context(mode?)`, `get_injection(mode?, message?)`, `get_skill_depth(skill)`, `list_sections()`.\n\n**Write-back** — `add_decision(...)`, `add_lesson(...)`, `update_now(...)`.\n\nResources expose every section as `soul://section/<path>`, plus `soul://full` for the whole file.\n\nFull details in [mcp/README.md](mcp/README.md) and [SPEC.md](SPEC.md).\n\n---\n\n## Repo\n\n```\nmanoma/\n├── mcp/         — MCP server (npx manoma-mcp)\n├── templates/   — starter soul.md files\n├── SPEC.md      — format specification\n└── README.md\n```\n\n---\n\n## Philosophy\n\nEvery AI vendor wants to own your memory. `soul.md` is the opposite bet: your identity as a plaintext file you control, interchangeable between tools, diff-able in git, outliving any individual model.\n\nThe schema is the thing. The runtime is just how it's read.\n\nContributions, forks, and parallel implementations welcome.\n\nMIT.\n",
  "bytes": 1994,
  "sha": "8140a0010a47c00c8455944c1eca0b8a2466cb77063603e9bc2e91f407a56549",
  "repo_slug": "paperdavid/manoma",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_paperdavid_manoma_072f35c8/readme"
}