---
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