Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Introduction

Amodal is a git-repo-centric cloud platform for agents. Your agent definition — connections, skills, knowledge, tools, stores, intents, evals, and optional runtime app code — lives as files in your repository. Amodal reads these files, deploys them to a hosted runtime, and gives your team the operational surface around the agent: sessions, costs, logs, source history, deployments, and evals.

How It Works

Your Repo
  ├── amodal.json          ← agent identity and runtime features
  ├── amodal/
  │   ├── connections/     ← API contracts, docs, and policies
  │   ├── skills/          ← Markdown reasoning frameworks
  │   ├── knowledge/       ← Domain knowledge documents
  │   ├── stores/          ← Typed persistent data schemas
  │   ├── tools/           ← Custom tool handlers
  │   └── intents/         ← Deterministic typed actions
  ├── hooks/               ← Guardrail hooks
  ├── evals/               ← Test cases for agent quality
  └── src/                 ← Optional custom runtime app
 
       ↓ deploy from Amodal
 
Hosted Runtime
  ├── Context Compiler     ← builds optimized prompts
  ├── Token Allocator      ← manages context window budget
  ├── Security Layer       ← field scrubbing, output guards, action gates
  ├── Provider Adapter     ← model provider selected in Amodal/platform settings
  └── Session Manager      ← durable scoped sessions

The Core Loop

Every agent runs the same fundamental cycle:

Explore → query connected systems, load knowledge, gather context
Plan    → reason about findings, decide next steps
Execute → call APIs, dispatch sub-agents, present results, learn

Simple questions skip planning. Complex questions get the full loop with multi-agent dispatch and skill activation. The runtime matches depth to the question automatically.

Key Capabilities

CapabilityWhat It Does
Multi-providerAnthropic Claude, OpenAI, Google Gemini, and other supported providers
Git-native configEverything is a file. Version, diff, review, and deploy your agent like code
Connection pluginsInstall or define connection packages for the systems your agent should call
Security infrastructureField scrubbing, output guards, action gates, scope checking, leak detection
Evaluation frameworkLLM-judged evals, experiments, cost tracking, multi-model comparison
Amodal deploymentsCommit source changes, deploy them, promote production, and inspect history
React SDK@amodalai/react components and chat widget for embedding
Operations UISession replay, activity logs, runtime logs, deploy state, and usage analytics

Next Steps