Skip to main content

What are --llms and --llms-full?

These flags expose the CLI’s command manifest in a machine-readable format. AI agents call them to discover what Mandate offers before integrating. This follows the llms.txt standard for AI agent discoverability.
No authentication required. No side effects. These are read-only discovery endpoints.

--llms: compact manifest

Returns a structured summary of every command: name, description, and the logical next step. Agents use this to understand the available tools and plan a workflow.
Each entry includes a next field pointing to the logical follow-up command. Agents chain commands without hardcoded sequences.

--llms-full: complete manifest

Returns the full command manifest with option schemas, argument types, defaults, and usage examples. This is the complete information an agent needs to construct valid command invocations. The output includes:
  • Command names and descriptions
  • Zod-derived option schemas with types and constraints
  • Required vs optional flags
  • Example invocations with realistic values
  • Suggested next steps after each command

How agents use this

An AI agent encountering Mandate for the first time runs --llms to understand the tool surface. Based on the response, it constructs a plan:
  1. Agent runs npx @mandate.md/cli --llms to discover commands
  2. Reads the manifest and identifies validate as the entry point
  3. Runs npx @mandate.md/cli --llms-full if it needs exact option schemas
  4. Constructs and executes the appropriate command
This eliminates the need for agents to have pre-programmed knowledge of Mandate’s CLI interface. The manifest is always current with the installed version.
For the complete Mandate API reference in a single document, see the SKILL.md reference. It covers REST endpoints, SDK methods, and CLI commands in one file optimized for LLM consumption.

Next Steps

MCP Server Mode

Expose CLI commands as MCP tools for Claude Desktop and other AI assistants.

SKILL.md Reference

The complete API reference optimized for AI agent consumption.

Integrations Overview

All supported agent frameworks and how to connect them.