# Agent Applications

> A vendor-neutral, markdown-first package format for building applications that AI agents can inspect and operate through a documented CLI.

## Docs

- [APP.md Reference](https://agentapplications.io/app-manifest.md): Complete reference for the APP.md manifest file — the root entrypoint and contract for every Agent Application package.
- [Best practices](https://agentapplications.io/authoring/best-practices.md): How to write Agent Application packages that are portable, legible, and safe to operate.
- [Evaluating packages](https://agentapplications.io/authoring/evaluating-packages.md): How to test whether your Agent Application package improves reliability using eval-driven iteration.
- [Optimizing descriptions](https://agentapplications.io/authoring/optimizing-descriptions.md): How to write APP.md and SKILL.md descriptions that enable reliable discovery and activation.
- [Agentic To-Do](https://agentapplications.io/example/agentic-to-do.md): A reference Agent Application package that demonstrates the full v1 contract: manifest, CLI, state, skills, and tests.
- [Manifest Walkthrough](https://agentapplications.io/example/app-manifest-walkthrough.md): A line-by-line walkthrough of the agentic-to-do APP.md manifest explaining every field and design decision.
- [Introduction](https://agentapplications.io/introduction.md): Agent Applications is a vendor-neutral, markdown-first package format for building applications that AI agents can inspect and operate through a documented CLI.
- [Package Structure](https://agentapplications.io/package-structure.md): The directory layout of an Agent Application package and the role of each part.
- [Quick Start](https://agentapplications.io/quickstart.md): Create a minimal Agent Applications package from scratch and verify it conforms to the v1 spec.
- [Adding Support](https://agentapplications.io/runtime/adding-support.md): A guide for implementing Agent Applications support in an agent runtime or host tool.
- [CLI Execution](https://agentapplications.io/runtime/cli-execution.md): How to invoke Agent Application CLI commands safely, handle JSON output, and enforce confirmation rules.
- [Progressive Disclosure](https://agentapplications.io/runtime/progressive-disclosure.md): How compatible runtimes load Agent Application packages in three tiers to keep context manageable.
- [Specification](https://agentapplications.io/specification.md): The complete v1 format contract for Agent Applications packages.
- [What are Agent Applications?](https://agentapplications.io/what-are-agent-applications.md): Agent Applications is a vendor-neutral, markdown-first package format for applications that AI agents can inspect and operate through a documented CLI.