# Pico Engine docs (llms.txt) Machine-readable index for agents working with picos and KRL. ## Start here - Local dev: `npm install -g pico-engine` then `pico-engine` (or repo `npm start`) - Agent loop: repo `CLAUDE.md` + `pico-engine mcp --stdio` (see packages/pico-engine/README.md) - Validate KRL: `krl-check` / `npm run krl-check` ## Docs - Pico overview: pico-overview.md - Developing with Picos: developing/README.md - Developing: Programming Workflow: developing/workflow.md - Developing: Event Loop Introduction: developing/event-loop.md - Developing: Tips: developing/tips.md - Developing: Event and Query URLs with Postman: developing/postman.md - Developing: KRL misconceptions and common errors: developing/misconceptions.md - Tip: initializing entity variables: developing/initializing-entity-variables.md - Tip: arrays and maps: developing/arrays-and-maps.md - Tip: decoding form-encoded data: developing/decoding-form-data.md - Tip: importing tables and CSV: developing/tabular-data.md - Tip: converting time formats: developing/converting-time-formats.md - Tip: what's in a name: developing/names-and-scope.md - Tip: cookies and redirects: developing/cookies-and-redirects.md - Webhook signatures: developing/webhook-signatures.md - AI tools over MCP: developing/mcp-ai-tools.md - Tip: events from email: developing/events-from-email.md - Tip: reading the engine's log files: developing/engine-log-files.md - Tip: querying another pico: developing/querying-another-pico.md - Tip: accepting relationship requests: developing/accepting-relationship-requests.md - Tip: one pico per resource: developing/singleton-picos.md - Pico engine operator guide: pico-engine.md - Pico views: pico-views.md - Programming lessons: lessons/README.md - Lesson: Quickstart: lessons/quickstart.md - Lesson: Events and Queries: lessons/events-and-queries.md - Lesson: Pico State: lessons/pico-state.md - Lesson: Modules and External APIs: lessons/modules-and-apis.md - Lesson: Pico views: lessons/pico-views.md - Lesson: Pico-Based Systems: lessons/pico-based-systems.md - Lesson: Relationships: lessons/relationships.md - Lesson: Scatter-Gather: lessons/scatter-gather.md - Lesson: Gossip Lab: lessons/gossip.md - Cookbook: cookbook/README.md - Cookbook: pico views: cookbook/xmlui/README.md - Cookbook: pico views instructions: cookbook/xmlui/instructions.md - Cookbook: moving picos: cookbook/moving_picos/README.md - Cookbook: moving picos instructions: cookbook/moving_picos/instructions.md - Cookbook: echo: cookbook/echo/README.md - Cookbook: echo instructions: cookbook/echo/instructions.md - Cookbook: score tracker: cookbook/score_tracker/README.md - Cookbook: score tracker instructions: cookbook/score_tracker/instructions.md - Cookbook: child pico tasks: cookbook/child_tasks/README.md - Cookbook: child pico tasks instructions: cookbook/child_tasks/instructions.md - Cookbook: two picos talking: cookbook/two_picos/README.md - Cookbook: two picos talking instructions: cookbook/two_picos/instructions.md - Cookbook: guard rules: cookbook/guard_rules/README.md - Cookbook: guard rules instructions: cookbook/guard_rules/instructions.md - Cookbook: layered rulesets: cookbook/layered_rulesets/README.md - Cookbook: layered rulesets instructions: cookbook/layered_rulesets/instructions.md - Cookbook: collection: cookbook/collection/README.md - Cookbook: collection instructions: cookbook/collection/instructions.md - Cookbook: configuration and secrets: cookbook/secrets/README.md - Cookbook: configuration and secrets instructions: cookbook/secrets/instructions.md - Cookbook: bootstrap and channels: cookbook/bootstrap/README.md - Cookbook: bootstrap and channels instructions: cookbook/bootstrap/instructions.md - Cookbook: KBlog: cookbook/kblog/README.md - Cookbook: KBlog instructions: cookbook/kblog/instructions.md - Cookbook: querying JSON: cookbook/json_query/README.md - Cookbook: querying JSON instructions: cookbook/json_query/instructions.md - Wrangler: the pico operating system: wrangler/README.md - Wrangler: the wrangler ruleset: wrangler/wrangler.md - Wrangler: managing channels: wrangler/channels.md - Wrangler: relationships: wrangler/relationships.md - Wrangler: pico data store: wrangler/pds.md - Wrangler: pico views (io.picolabs.xmlui): wrangler/xmlui.md - Wrangler: OAuth (io.picolabs.oauth): wrangler/oauth.md - Wrangler: portable subtrees (io.picolabs.portable_subtree): wrangler/portable-subtree.md - Event Exchange Protocol: exp/README.md - EXP: Event API (Sky): exp/event.md - EXP: Query API (Sky): exp/query.md - Bundled rulesets: rulesets/README.md - KRL manual: krl/README.md - Contributing: contributing.md ## Bundled ruleset API (generated from KRL) - io.picolabs.wrangler: rulesets/io.picolabs.wrangler.md - io.picolabs.pds: rulesets/io.picolabs.pds.md - io.picolabs.subscription: rulesets/io.picolabs.subscription.md - io.picolabs.pico-engine-ui: rulesets/io.picolabs.pico-engine-ui.md - io.picolabs.oauth: rulesets/io.picolabs.oauth.md - io.picolabs.portable_subtree: rulesets/io.picolabs.portable_subtree.md ## Manifold (mesh framework — separate repo) Application layer on wrangler (owner, thing, community). Not shipped inside pico-engine. - Index: https://github.com/Picolab/manifold-api/blob/main/docs/llms.txt - Generated ruleset APIs: https://github.com/Picolab/manifold-api/tree/main/docs/rulesets ## OpenAPI - Event Exchange Protocol (Sky) HTTP: docs/openapi.yaml