# pinocchio    docs

> 

- Documentation: https://pinocchio-docs.thally.app
- GitHub: https://github.com/victorchukwuemeka/pinocchio-docs
- Full docs for LLMs: https://pinocchio-docs.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pinocchio-docs.thally.app/ai.txt
- Structured docs index (JSON): https://pinocchio-docs.thally.app/api/docs-index
- OpenAPI spec: https://pinocchio-docs.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pinocchio-docs.thally.app/api/docs/{page-id}
- Search API: https://pinocchio-docs.thally.app/api/search?q={query}
- Capability manifest (skill): https://pinocchio-docs.thally.app/skill.md
- Agent guidance (editing these docs): https://pinocchio-docs.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pinocchio-docs.thally.app/api/mcp
- Agent readiness: https://pinocchio-docs.thally.app/api/agent-readiness
- Changelog feed (JSON Feed): https://pinocchio-docs.thally.app/changelog/feed.json
- Changelog feed (RSS): https://pinocchio-docs.thally.app/changelog/rss.xml

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://pinocchio-docs.thally.app/): Pinocchio is a zero-dependency Rust library for writing Solana programs. Learn what it is, who it is for, and when to choose it over Anchor.
- [Quickstart](https://pinocchio-docs.thally.app/quickstart): Build a minimal Solana program with Pinocchio and run it in a local test, with no validator or network.

### Design your docs

- [Troubleshoot your first build](https://pinocchio-docs.thally.app/guides/troubleshooting): Fix the setup, build, and test errors new Pinocchio users commonly hit, each verified on a real machine.

## Guides

### Work with Thally

- [Create a site](https://pinocchio-docs.thally.app/guides/create-a-site): Three ways to go from nothing to a published Thally site, and how publishing works after that.
- [Work with the CLI](https://pinocchio-docs.thally.app/guides/work-with-the-cli): The thally commands you will actually use day to day.
- [Connect AI tools](https://pinocchio-docs.thally.app/guides/connect-ai-tools): Every Thally site is agent-readable out of the box — here is what that gives you.

## API Reference

### Overview

- [Overview](https://pinocchio-docs.thally.app/api/introduction): What this API reference covers and how to try every request live.
- [Authentication](https://pinocchio-docs.thally.app/api/authentication): How to authenticate requests, and how to document your own scheme.

## Changelog

- [Changelog](https://pinocchio-docs.thally.app/changelog): Record product changes that alter how readers use the documented experience.

Interactive API reference available at https://pinocchio-docs.thally.app/api