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 agent runtime. Your agent's configuration — connections, skills, knowledge, tools, automations — lives as files in your repository. The runtime reads these files, compiles them into an optimized context, and runs a reasoning loop against any supported LLM provider.

How It Works

Your Repo (.amodal/)
  ├── config.json          ← agent identity, provider config
  ├── connections/          ← API credentials + docs (or plugins)
  ├── skills/              ← Markdown reasoning frameworks
  ├── knowledge/           ← Domain knowledge documents
  ├── tools/               ← Custom HTTP/chain/function tools
  ├── automations/         ← Scheduled or trigger-based runs
  └── evals/               ← Test cases for agent quality
 
       ↓ amodal dev
 
Runtime Server (localhost:3847)
  ├── Context Compiler     ← builds optimized prompts
  ├── Token Allocator      ← manages context window budget
  ├── Security Layer       ← field scrubbing, output guards, action gates
  ├── Provider Adapter     ← Anthropic / OpenAI / Gemini / Bedrock / Azure
  └── Session Manager      ← TTL-based sessions with hot reload

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, AWS Bedrock, Azure OpenAI — with failover
Git-native configEverything is a file. Version, diff, review, and deploy your agent like code
20+ connection pluginsSlack, GitHub, Stripe, Datadog, Jira, PagerDuty, Salesforce, and more
Security infrastructureField scrubbing, output guards, action gates, scope checking, leak detection
Evaluation frameworkLLM-judged evals, experiments, cost tracking, multi-model comparison
Hot reloadFile watcher on .amodal/ — edit config, agent updates instantly
React SDK@amodal/react components and @amodal/chat-widget for embedding
Snapshot deploymentBuild → snapshot → deploy to platform or self-host

Next Steps