# Permaweb LLM Wiki

> Canonical, live knowledge for agents building with Arweave, AO, and PermawebOS patterns.

This website is a reader for the public GitHub repository below. The repository is the source of truth. The reader fetches the current `main` branch on each session, so its visible content follows upstream changes without a site rebuild.

## Agent instructions

1. Start with the canonical index.
2. Read maintained synthesis in `topics/` before reading raw evidence.
3. Follow relative Markdown links for exact implementation evidence.
4. Prefer local scripts, successful run artifacts, and scoped resources over generic documentation.
5. Do not infer that AO is required for every app. Use immutable Arweave data plus GraphQL unless process-enforced mutable state is the hard part.
6. Cite the exact repository path and immutable blob URL when possible.
7. Treat wallet addresses as primary identity and browser/local storage as cache or draft state, not canonical persistence.

## Canonical entry points

- Repository: https://github.com/xylophonez/permaweb-llm-wiki
- Index: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/index.md
- Repository rules: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/AGENTS.md
- Repository README: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/README.md
- Recursive file tree: https://api.github.com/repos/xylophonez/permaweb-llm-wiki/git/trees/main?recursive=1

## Maintained topic maps

- AO: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/topics/ao
- Arweave: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/topics/arweave
- PermawebOS: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/topics/permawebos
- Meta: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/topics/meta
- Resources: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/resources
- Evidence scripts: https://github.com/xylophonez/permaweb-llm-wiki/tree/main/scripts

## High-value decision pages

- When to use AO: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/ao/when-to-use-ao.md
- AO process blueprints: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/ao/process-blueprints.md
- Token blueprints: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/ao/token-blueprints.md
- GraphQL: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/arweave/graphql.md
- Deploying web apps: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/arweave/deploying-web-apps.md
- Wallet operations: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/arweave/wallet-operations.md
- Seed pattern: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/permawebos/seed-pattern.md
- Core UI loop: https://raw.githubusercontent.com/xylophonez/permaweb-llm-wiki/main/topics/permawebos/core-loop-policy.md

## Freshness and trust

The site reports the commit SHA it loaded. For stable citations, replace `/main/` in a raw URL with that SHA. If rendered content and the repository disagree, the current repository commit wins.