--- title: Developer docs description: The full reference for writing, debugging, packaging, and publishing Notochord Gems. section: dev order: 0 updated: 2026-11-05 translation_of: zh source_sha: 82c2c2c1b695 --- # Developer docs A gem is a folder: a manifest, plus optional tools, agents (each a prompt file with a header), SOPs, pages, a skill for the AI, an intro document for people (`docs/`, which will become the store's listing page), data declarations, and event subscriptions. Once it is installed, the gem's page lists what it can do; anything the user has to configure (accounts, mailboxes, the knowledge base) stays off until the user turns it on. ## Where to start 1. [What a Gem is](/en/dev/gem-overview.md) — structure, lifecycle, and its relationship to sessions 2. [Manifest reference](/en/dev/manifest.md) — every field in the manifest 3. [Permission model](/en/dev/permissions.md) — how network, model, knowledge-base, email and account access is requested and checked; storage, files and document extraction need no permission 4. [Data & storage](/en/dev/storage.md) — storing a gem's own data with `ctx.data`: collections, logs, documents, blobs, plus migrations, encryption, and isolation 5. [Knowledge API](/en/dev/knowledge.md) — reading and writing the user's facts and documents through `ctx.knowledge` 6. [Tools API](/en/dev/tools.md) — built-in tools and custom tools 7. [Events & triggers](/en/dev/events.md) — the three ways a flow starts (manual call, schedule, platform event), their inputs and limits 8. [Local development & debugging](/en/dev/local-dev.md) — Gem Studio and the draft flow 9. [Packaging & publishing](/en/dev/publishing.md) — what a package contains, the checks at install, signing and trust levels ## Machine-readable interfaces - [`config.notochord.ai/v1/index.json`](https://config.notochord.ai/v1/index.json) — the full index of static config the client pulls from the CDN - [`config.notochord.ai/v1/config.json`](https://config.notochord.ai/v1/config.json) — LLM vendors, service connection templates, email presets, local models, site links - [`config.notochord.ai/v1/gem-templates.json`](https://config.notochord.ai/v1/gem-templates.json) — Gem Studio templates - [`download.notochord.ai/gems/index.json`](https://download.notochord.ai/gems/index.json) — the gem store listing (what the app's Store tab reads) - [`/llms.txt`](/llms.txt) — the site-wide AI index
Notochord
简体中文English