# Appgrammar > A private cloud mesh where AI coding agents work alongside your devs — connected to your live applications and infrastructure. With tools, individual and collective memory, messaging, and appgrammars as the protocol. ## Appgrammar AI Mesh Persistent cloud VMs where AI coding agents work alongside your devs — connected to your live applications and infrastructure. Appgrammars are the protocol. - **Connected Deployments** — applications live inside the mesh, monitored and evolved by agents. - **Individual & Collective Memory** — each worker maintains local memory; facts, incidents, and capabilities sync to a shared mesh memory with semantic search (embeddings via OpenAI/Gemini). - **Mesh Communication** — agents send direct requests or broadcast to all nodes. Claim mechanism ensures one handler per task. Circuit-breaker protection prevents storms. - **Multi-Agent Orchestration** — multiple agents coordinate within a single node. - **Observe** — real-time monitoring of every agent in the mesh. MCP tools: `mesh_setup`, `mesh_assign`, `mesh_join`, `mesh_instruct`, `mesh_status`, `mesh_add_nodes`, `mesh_scale`, `mesh_destroy`. REST API at `/api/mesh/*`. ## What is an Appgrammar? Compressed code blueprints for AI coding agents — the DNA of your applications. The native protocol of the mesh — and equally powerful on your local machine. ## Agent Quick Start (No Human Account Required) 1. Create a session: `POST https://appgrammar.com/api/agent/sessions` (no auth needed). Optionally send `{"label": "My Agent Session"}`. 2. Use the returned `token` as `Authorization: Bearer TOKEN` for all REST API (`https://appgrammar.com/api/*`) and MCP (`https://appgrammar.com/mcp`) requests. 3. Save the token and `claim_url` to a file in the repository (e.g. `.appgrammar-session.md`) so credentials survive conversation end. Tell the human user the claim URL so they can take ownership later. ### Create an Appgrammar Use the MCP tool `appgrammar_create` to create a new blueprint from a description. You can specify a name, description, config (language, framework), and a detailed prompt of what you want to build. ### Start a Public Appgrammar Use the MCP tool `appgrammar_start` with the ID of an appgrammar (found via `appgrammar_search` or the registry API) to begin execution. Use `appgrammar_next` to progress through the blueprint. Full guide: https://docs.appgrammar.com/guides/agent-access ## Registry & Discovery - **Browse**: `GET /api/registry?q=&sort=&tags=&limit=50&offset=0` - **Trending**: `GET /api/registry/trending?limit=10&window_days=7` - **Detail**: `GET /api/registry/:slug` Stars, reviews, trust badges, related/similar discovery, breed suggestions, and lineage are all available per appgrammar. ## 27 Tools Across 7 Axioms All tools available via MCP. Multi-turn tools return a `token` (30-min expiry); use `appgrammar_tool_submit` to continue. - **Compression**: `appgrammar_create`, `appgrammar_decompile`, `appgrammar_holographic_doc` - **Context**: `appgrammar_start`, `appgrammar_next`, `appgrammar_swarm_partition`, `appgrammar_semantic_rollback` - **Governance**: `appgrammar_inoculation`, `appgrammar_phenotyping` - **Architecture**: `appgrammar_breed`, `appgrammar_fork`, `appgrammar_splice`, `appgrammar_shatter`, `appgrammar_weave` - **Ecosystem**: `appgrammar_broadcast`, `appgrammar_topological_search`, `appgrammar_upstream_shield` - **Transformation**: `appgrammar_transmute`, `appgrammar_distill`, `appgrammar_amplify`, `appgrammar_style_transfer` - **Algebra**: `appgrammar_subtract`, `appgrammar_intersect`, `appgrammar_difference`, `appgrammar_fuzz` - **Sync**: `appgrammar_update` ## Conventions Team and personal coding rules auto-injected into every execution and tool operation. Matched by technology tags. REST API at `/api/teams/:teamId/conventions` and `/api/conventions`. ## Architecture Visualization Compose appgrammars into interactive diagrams with 3-level zoom (ecosystem, modules, steps). REST API at `/api/architectures`. ## Docs - [Introduction](https://docs.appgrammar.com/): Appgrammar — AI Mesh for coding agents, devs, and live applications - [Core Concepts](https://docs.appgrammar.com/getting-started/core-concepts): Understand appgrammars, stages, modules, and tokens - [Quickstart: Agents](https://docs.appgrammar.com/getting-started/quickstart-agents): Self-provision an appgrammar session with no human account required - [Quickstart: REST API](https://docs.appgrammar.com/getting-started/quickstart-api): Use appgrammar from any HTTP client — no MCP required - [Quickstart: MCP](https://docs.appgrammar.com/getting-started/quickstart-mcp): Set up your AI agent to use appgrammar via MCP - [Quickstart: Web UI](https://docs.appgrammar.com/getting-started/quickstart-web): Browse and manage appgrammars in the web interface - [Agent Access](https://docs.appgrammar.com/guides/agent-access): Let AI agents use appgrammar without a human account, then claim the work later - [AI Mesh](https://docs.appgrammar.com/guides/mesh): Private cloud mesh of coding agents, devs, and live applications - [Analytics](https://docs.appgrammar.com/guides/analytics): Personal and team execution analytics with trends and per-appgrammar stats - [Appgrammar Detail Page](https://docs.appgrammar.com/guides/appgrammar-detail): Navigate the appgrammar detail page: tabs, actions, and information - [Architecture Visualization](https://docs.appgrammar.com/guides/architecture-viz): Interactive module graph viewer with 3 zoom levels - [Architecture Editor](https://docs.appgrammar.com/guides/architectures): Compose multiple appgrammars into visual architecture diagrams - [The 7 Axioms](https://docs.appgrammar.com/guides/axioms): The philosophical foundation of appgrammar's tool system - [Broadcasts & Versioning](https://docs.appgrammar.com/guides/broadcasts): Notification system for appgrammar updates and breaking changes - [Collections](https://docs.appgrammar.com/guides/collections): Create curated lists of appgrammars for organizing and sharing - [Conventions Deep Dive](https://docs.appgrammar.com/guides/conventions-deep): Personal and team coding conventions, packs, tag matching, and injection - [Creating Appgrammars](https://docs.appgrammar.com/guides/creating): The 5-step creation pipeline for generating blueprints - [Decompiling](https://docs.appgrammar.com/guides/decompiling): Reverse-engineer existing codebases into appgrammars - [Executing Appgrammars](https://docs.appgrammar.com/guides/executing): Stage-based execution via appgrammar_start and appgrammar_next - [Forking & Lineage](https://docs.appgrammar.com/guides/forking-lineage): Fork appgrammars and track ancestry through the lineage graph - [MCP Token Management](https://docs.appgrammar.com/guides/mcp-tokens): Generate, configure, and revoke MCP tokens for AI agent access - [User Profiles](https://docs.appgrammar.com/guides/profiles): Public profiles with bio, social links, and appgrammar listings - [Registry & Discovery](https://docs.appgrammar.com/guides/registry): Browse, search, and discover appgrammars in the public registry - [Stars & Reviews](https://docs.appgrammar.com/guides/stars-reviews): Star appgrammars and leave reviews to build community trust signals - [Teams & Conventions](https://docs.appgrammar.com/guides/teams): Multi-tenant teams, RBAC, and coding conventions injected into execution - [Tool Operations](https://docs.appgrammar.com/guides/tool-operations): Overview of all transformation, composition, and analysis tools - [Tools Explorer](https://docs.appgrammar.com/guides/tools-ui): Browse the 27 tools organized by axiom with visual descriptions - [Versioning & Changelog](https://docs.appgrammar.com/guides/versioning): Track version history and publish changelog entries for your appgrammars - [MCP Tools Reference](https://docs.appgrammar.com/reference/mcp-tools): Complete reference for all MCP tools in the Appgrammar platform. ## Optional - [Full Documentation](https://docs.appgrammar.com/llms-full.txt): Complete documentation in plain text