# Grimoire

> A Portable Execution Language for Onchain Strategies

## Docs

- [Core Concepts](/concepts.md): The key ideas behind Grimoire. Understanding these will help you work with both the CLI and the Platform.
- [Getting Started with the Platform](/platform/getting-started.md): Set up API authentication and make your first call to the Grimoire Platform.
- [Platform Overview](/platform/overview.md): The Grimoire Platform is a cloud API that builds on the open source engine, adding natural language intents, policy enforcement, session management, and sandboxed execution.
- [Policies](/platform/policies.md): Policies are automated rules that govern what actions are allowed through the Grimoire Platform. Every action plan validated through the API is checked against your active policies.
- [Run Intents](/platform/run-intents.md): The run endpoint translates natural language into a validated action plan.
- [Sessions](/platform/sessions.md): Sessions manage the back-and-forth when an intent needs clarification before it can be executed.
- [Validate Actions](/platform/validate.md): The validate endpoint checks a structured action plan against your policies and optionally previews the execution.
- [CLI Reference](/open-source/cli-reference.md): Core commands for the Grimoire CLI.
- [Writing Your First Spell](/open-source/first-spell.md): Create a simple spell from scratch, compile it, and run it.
- [Installation](/open-source/installation.md): Install Grimoire globally via npm, or run directly with npx (no install needed):
- [Quick Start](/open-source/quickstart.md): Get from zero to running your first spell in under 5 minutes.
- [Running Spells](/open-source/running-spells.md): How to take a spell from validation through simulation to live onchain execution.
- [Venues & Adapters](/open-source/venues.md): Venues are the protocols Grimoire can interact with. Each venue has an adapter that translates your spell actions into protocol-specific calls.
- [Advisory Decisions](/open-source/agents/advisory.md): Agents can write spells that include AI-powered decision points using `advise` blocks. This is how you embed judgment into a strategy while keeping it auditable.
- [Coding Agents](/open-source/agents.md): Grimoire is designed as a language for **AI agents** to write and execute. Spells have a structured, deterministic syntax that agents can author reliably — and skills give them the context they need to do it well.
- [Prompt Examples](/open-source/agents/prompt-examples.md): Real-world prompts you can give your coding agent to write and execute Grimoire spells.