tembo · tembo · Mar 18, 2026 · Apr 7, 2026
diff --git a/api/trigger-automation.mdx b/api/trigger-automation.mdx
@@ -0,0 +1,5 @@
+---
+title: 'Trigger Automation'
+description: 'Trigger an automation with an arbitrary JSON payload.'
+openapi: 'POST /automation/{keyOrId}/trigger'
+---
diff --git a/docs.json b/docs.json
@@ -40,13 +40,14 @@
                 "groups": [
                     {
                         "group": "Get Started",
-                        "pages": ["index", "quickstart"]
+                        "pages": ["index", "quickstart", "support"]
                     },
                     {
                         "group": "Features",
                         "pages": [
                             "features/automations",
                             "features/coding-agents",
+                            "features/models",
                             "features/feedback-loop",
                             "features/max",
                             "features/sandbox-environment",
@@ -72,7 +73,6 @@
                         "group": "Integrations",
                         "pages": [
                             "integrations/mcp",
-                            "integrations/aws",
                             "integrations/bitbucket",
                             "integrations/github",
                             "integrations/gitlab",
@@ -83,7 +83,16 @@
                             "integrations/raycast",
                             "integrations/sentry",
                             "integrations/slack",
-                            "integrations/supabase"
+                            "integrations/supabase",
+                            "integrations/aws"
+                        ]
+                    },
+                    {
+                        "group": "Other",
+                        "pages": [
+                            "resources/pwa",
+                            "resources/pricing",
+                            "resources/changelog"
                         ]
                     }
                 ]
@@ -110,6 +119,12 @@
                                     "GET /task/search"
                                 ]
                             },
+                            {
+                                "group": "Automations",
+                                "pages": [
+                                    "api/trigger-automation"
+                                ]
+                            },
                             {
                                 "group": "Repositories",
                                 "pages": ["GET /repository/list"]
@@ -161,5 +176,18 @@
             "youtube": "https://www.youtube.com/@tembo_io"
         }
     },
-    "redirects": []
+    "redirects": [
+        {
+            "source": "/admin/support",
+            "destination": "/support"
+        },
+        {
+            "source": "/billing",
+            "destination": "/resources/pricing"
+        },
+        {
+            "source": "/admin/billing",
+            "destination": "/resources/pricing"
+        }
+    ]
 }
diff --git a/features/agent-actions.mdx b/features/agent-actions.mdx
@@ -5,6 +5,8 @@ description: 'Tembo agents can do more than open PRs.'
 
 Pull requests are the most common output, but Tembo agents can take any action available through your connected integrations and [MCP servers](/integrations/mcp).
 
+A single task can span multiple repositories. Tembo can use context from connected integrations and MCP servers during the same task, make informed decisions, and open a pull request or merge request in each affected repository. It can also coordinate changes across different git providers when needed.
+
 ## What agents can do
 
 | Action | Integration |
@@ -31,6 +33,8 @@ Pull requests are the most common output, but Tembo agents can take any action a
 
 **Query production data**: During a task, an agent queries your Postgres database to understand the schema and writes a migration based on actual table structure.
 
+**Ship a cross-repo change**: One task updates multiple services, uses Linear and Sentry context to verify the work, and opens a PR or MR in each affected repository.
+
 ## How it works
 
 Agents access integrations through MCP servers. When you connect an integration or install an MCP server, it becomes available to agents during tasks and automations. No extra configuration needed.

diff --git a/features/automations.mdx b/features/automations.mdx
@@ -39,6 +39,20 @@ React to events from your integrations in real-time.
 | **Linear**  | Issue created, issue updated, status changed       |
 | **Slack**   | Message in channel, @tembo mention                 |
 
+#### Trigger through webhooks
+
+You can trigger an automation on demand from external systems using the automation's [webhook trigger endpoint](/api/trigger-automation).
+
+The payload is passed to the automation as event context, so your instructions can reference it directly. For example, you could write instructions like _"Fix the issue at the URL provided in the event payload"_.
+
+#### Slash command trigger
+
+You can trigger a task with the selected automation by using slash commands.
+
+```txt
+@tembo /<automationSlug>
+```
+
 ## Creating an automation
 
 ### From a template

diff --git a/features/coding-agents.mdx b/features/coding-agents.mdx
@@ -3,7 +3,9 @@ title: "Coding Agents"
 description: "Choose from multiple AI coding agents to solve your software engineering tasks."
 ---
 
-Tembo is agent and model agnostic. Set a default agent and model per automation (e.g. all Linear issues use Codex with GPT-5.2) or override per task.
+Tembo is agent and model agnostic. Set a default agent and model per automation (e.g. all Linear issues use Codex with GPT-5.4) or override per task.
+
+See [Models](/features/models) for the full supported model list, BYOK details, and AWS Bedrock BYOK support.
 
 <AccordionGroup>
   <Accordion title="Claude Code" icon={<svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M3.43196 10.4658L6.39022 8.81139L6.43971 8.66719L6.39022 8.58751H6.24554L5.7506 8.55715L4.06016 8.51161L2.59436 8.4509L1.17425 8.37501L0.816364 8.29912L0.481323 7.85894L0.515589 7.63886L0.816364 7.43775L1.24659 7.47569L2.19841 7.5402L3.62613 7.63886L4.66171 7.69957L6.19605 7.85894H6.43971L6.47398 7.76028L6.39022 7.69957L6.32549 7.63886L4.84827 6.64088L3.24921 5.58599L2.41161 4.97885L1.95855 4.67149L1.73011 4.3831L1.63112 3.7532L2.04231 3.30165L2.59436 3.33959L2.73523 3.37754L3.2949 3.80633L4.49039 4.72841L6.05137 5.87438L6.27981 6.06411L6.37118 5.9996L6.3826 5.95406L6.27981 5.78331L5.43078 4.25409L4.52465 2.69831L4.12108 2.05323L4.01448 1.66618C3.9764 1.50681 3.94975 1.374 3.94975 1.21083L4.41805 0.577133L4.67694 0.493652L5.30134 0.577133L5.56404 0.804808L5.95238 1.68895L6.58058 3.08156L7.55524 4.97506L7.84079 5.53666L7.99308 6.05652L8.05019 6.21589H8.14918V6.12482L8.22913 5.05854L8.37762 3.74941L8.52229 2.06461L8.57179 1.59029L8.80784 1.0211L9.27613 0.713738L9.64163 0.888289L9.94241 1.31708L9.90053 1.59408L9.72159 2.75143L9.37132 4.56524L9.14288 5.77951H9.27613L9.42842 5.62773L10.0452 4.81189L11.0808 3.52173L11.5377 3.00946L12.0707 2.44407L12.4133 2.17465H13.0606L13.5365 2.88045L13.3233 3.60901L12.657 4.45141L12.1049 5.16479L11.313 6.22727L10.8181 7.07726L10.8638 7.14556L10.9818 7.13418L12.7712 6.75472L13.7383 6.58017L14.8919 6.38285L15.4135 6.6257L15.4706 6.87235L15.265 7.37703L14.0314 7.6806L12.5847 7.96899L10.4297 8.47746L10.4031 8.49644L10.4335 8.53438L11.4044 8.62545L11.8194 8.64822H12.8359L14.7282 8.78862L15.2231 9.11495L15.5201 9.51338L15.4706 9.81695L14.7091 10.204L13.6812 9.96115L11.2826 9.39196L10.4602 9.18705H10.346V9.25535L11.0313 9.9232L12.2877 11.054L13.8601 12.5111L13.94 12.8716L13.7383 13.1562L13.5251 13.1258L12.143 12.0899L11.61 11.6232L10.4031 10.61H10.3231V10.7163L10.6011 11.1223L12.0707 13.3231L12.1468 13.9986L12.0402 14.2187L11.6595 14.3515L11.2407 14.2756L10.3802 13.0727L9.49315 11.718L8.77738 10.5038L8.68981 10.5531L8.26721 15.0876L8.06923 15.3191L7.61235 15.4937L7.23163 15.2053L7.02984 14.7385L7.23163 13.8164L7.47529 12.6136L7.67327 11.6573L7.85221 10.4696L7.95882 10.075L7.9512 10.0484L7.86363 10.0598L6.96512 11.2893L5.5983 13.1296L4.51704 14.2832L4.25814 14.3856L3.80888 14.1542L3.85076 13.7406L4.10204 13.3725L5.5983 11.4752L6.50063 10.2989L7.08314 9.61963L7.07933 9.52097H7.04507L3.07027 12.0937L2.36212 12.1848L2.05754 11.9002L2.09561 11.4334L2.24029 11.2817L3.43577 10.462L3.43196 10.4658Z" fill="#D97757"/></svg>}>
@@ -16,7 +18,7 @@ Tembo is agent and model agnostic. Set a default agent and model per automation
   <Accordion title="Codex" icon={<svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M13.268 8C13.268 5.09056 10.9094 2.73203 8 2.73203C5.09056 2.73203 2.73203 5.09056 2.73203 8C2.73203 10.9094 5.09056 13.268 8 13.268C10.9094 13.268 13.268 10.9094 13.268 8ZM10.6664 9.1344L10.7742 9.14528C11.0164 9.19504 11.1983 9.40952 11.1984 9.6664C11.1984 9.92336 11.0165 10.1378 10.7742 10.1875L10.6664 10.1984H8.6664C8.37272 10.1983 8.1344 9.96016 8.1344 9.6664C8.13448 9.3728 8.3728 9.13448 8.6664 9.1344H10.6664ZM6.12266 9.94064C5.97142 10.1923 5.64482 10.2738 5.39297 10.1226C5.14114 9.97152 5.05913 9.64488 5.21016 9.39296L6.12266 9.94064ZM7.12266 7.72656C7.22365 7.89498 7.22365 8.10504 7.12266 8.27344L6.12266 9.94064L5.66641 9.6664L5.21016 9.39296L6.04531 8L5.21016 6.60703L5.66641 6.33359L6.12266 6.05938L7.12266 7.72656ZM5.39297 5.87735C5.64482 5.72623 5.97142 5.80764 6.12266 6.05938L5.21016 6.60703C5.05913 6.35514 5.14114 6.0285 5.39297 5.87735ZM14.332 8C14.332 11.497 11.497 14.332 8 14.332C4.50294 14.332 1.66797 11.497 1.66797 8C1.66797 4.50294 4.50294 1.66797 8 1.66797C11.497 1.66797 14.332 4.50294 14.332 8Z" fill="currentColor"/></svg>}>
     OpenAI's GPT-5 family with configurable reasoning effort (minimal, low, medium, high).
 
-    **Models:** GPT-5.4, GPT-5.3 Codex, GPT-5.2, GPT-5.2 Codex, GPT-5.1, GPT-5.1 Codex Max, GPT-5.1 Codex Mini
+    **Models:** GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.3 Codex, GPT-5.2, GPT-5.2 Codex, GPT-5.1, GPT-5.1 Codex Max, GPT-5.1 Codex Mini
 
   </Accordion>
 
@@ -30,11 +32,18 @@ Tembo is agent and model agnostic. Set a default agent and model per automation
   <Accordion title="Opencode" icon={<svg viewBox="0 0 240 300" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M180 240H60V120H180V240Z" fill="currentColor" opacity="0.4"/><path d="M180 60H60V240H180V60ZM240 300H0V0H240V300Z" fill="currentColor"/></svg>}>
     Multi-provider support: Anthropic, OpenAI, and OSS models.
 
-    **Models:** Opus 4.6, Sonnet 4.5, GPT-5.2, GPT-OSS 120B, Qwen 3 32B, Llama 3.3 70B, Kimi K2.5, GLM 5
+    **Models:** Opus 4.6, Sonnet 4.5, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.2, GPT-OSS 120B, Qwen 3 32B, Llama 3.3 70B, Kimi K2.5, GLM 5
 
   </Accordion>
 
   <Accordion title="Amp" icon={<svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M2.8757 14.567L6.63971 10.7497L8.0095 15.9505L9.99942 15.4062L8.01684 7.8548L0.585336 5.84207L0.0561523 7.87535L5.16975 9.26441L1.42137 13.0761L2.8757 14.567Z" fill="#F34E3F"/><path d="M13.7302 10.142L15.7201 9.59774L13.7376 2.04635L6.30603 0.0336304L5.77686 2.06691L12.0524 3.77164L13.7302 10.142Z" fill="#F34E3F"/><path d="M10.8738 13.0444L12.8637 12.5001L10.8811 4.9487L3.44959 2.93597L2.92041 4.96925L9.19587 6.67399L10.8738 13.0444Z" fill="#F34E3F"/></svg>}>
     Claude-powered with automatic model selection.
   </Accordion>
+
+  <Accordion title="Pi" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="165 165 470 470"><path fill="currentColor" fill-rule="evenodd" d="M165.29 165.29H517.36V400H400V517.36H282.65V634.72H165.29ZM282.65 282.65V400H400V282.65Z"/><path fill="currentColor" d="M517.36 400H634.72V634.72H517.36Z"/></svg>}>
+    A minimal, extensible terminal coding harness with multi-provider support.
+
+    **Providers:** Anthropic, OpenAI, Google Gemini, GitHub Copilot, Azure OpenAI, Amazon Bedrock, Mistral, Groq, xAI, OpenRouter, and more
+
+  </Accordion>
 </AccordionGroup>
diff --git a/features/hooks.mdx b/features/hooks.mdx
@@ -34,6 +34,12 @@ Hooks run shell commands at specific points during a task. Configure them in `.t
 
 Set `"autoFix": true` to let Tembo analyze hook failures and attempt to fix issues before retrying.
 
+## Branch-aware config loading
+
+Tembo checks out the task branch before loading `.tembo.json` and running `postClone`.
+
+This ensures hooks and config are read from the same branch context the agent will edit, including changes that exist only on your selected base branch.
+
 ## Details
 
 - Commands run sequentially in the repository root

diff --git a/features/max.mdx b/features/max.mdx
@@ -24,20 +24,28 @@ export ANTHROPIC_API_KEY=your-tembo-api-key
 ```
 
 ```bash Codex
-export OPENAI_BASE_URL="https://proxy.tembo.io/proxy/openai"
+export OPENAI_BASE_URL="https://proxy.tembo.io/openai"
 export OPENAI_API_KEY="your-tembo-api-key"
 ```
 
 ```json OpenCode
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "openai/gpt-5.2",
+  "model": "openai/gpt-5-mini",
   "provider": {
     "openai": {
       "models": {
-        "gpt-5.2": {
-          "id": "gpt-5.2",
-          "name": "GPT-5.2"
+        "gpt-5.4": {
+          "id": "gpt-5.4",
+          "name": "GPT-5.4"
+        },
+        "gpt-5.4-mini": {
+          "id": "gpt-5-mini",
+          "name": "GPT-5.4 Mini"
+        },
+        "gpt-5.4-nano": {
+          "id": "gpt-5-nano",
+          "name": "GPT-5.4 Nano"
         }
       },
       "options": {
@@ -58,6 +66,8 @@ export OPENAI_API_KEY="your-tembo-api-key"
   Codex may store credentials in `~/.codex/auth.json` that override environment variables.
 </Note>
 
+Codex and OpenCode both support `gpt-5.4`, `gpt-5.4-mini`, and `gpt-5.4-nano`. In OpenCode, the `gpt-5.4-mini` and `gpt-5.4-nano` aliases map to OpenAI's `gpt-5-mini` and `gpt-5-nano` model IDs.
+
 ## Proxy models
 
 All models are tested across real-world coding tasks before being made available.
@@ -70,10 +80,12 @@ All models are tested across real-world coding tasks before being made available
 | Claude 4.5 Haiku  | `claude-4-5-haiku`         | `proxy.tembo.io/anthropic`    |
 | Claude 4 Sonnet   | `claude-4-sonnet`          | `proxy.tembo.io/anthropic`    |
 | GPT-5.4           | `gpt-5.4`                  | `proxy.tembo.io/openai`       |
+| GPT-5.4 Mini      | `gpt-5.4-mini`             | `proxy.tembo.io/openai`       |
+| GPT-5.4 Nano      | `gpt-5.4-nano`             | `proxy.tembo.io/openai`       |
 | GPT-5.2           | `gpt-5.2`                  | `proxy.tembo.io/openai`       |
-| GPT-5.1 Codex     | `gpt-5.1-codex`            | `proxy.tembo.io/proxy/openai` |
-| GPT-5.1 Codex Max | `gpt-5.1-codex-max`        | `proxy.tembo.io/proxy/openai` |
-| GPT-5.2 Codex     | `gpt-5.2-codex`            | `proxy.tembo.io/proxy/openai` |
+| GPT-5.1 Codex     | `gpt-5.1-codex`            | `proxy.tembo.io/openai`       |
+| GPT-5.1 Codex Max | `gpt-5.1-codex-max`        | `proxy.tembo.io/openai`       |
+| GPT-5.2 Codex     | `gpt-5.2-codex`            | `proxy.tembo.io/openai`       |
 | Gemini 2.5 Pro    | `gemini-2.5-pro`           | `proxy.tembo.io/anthropic`    |
 | Gemini 3 Pro      | `gemini-3-pro`             | `proxy.tembo.io/anthropic`    |
 | Gemini 3 Flash    | `gemini-3-flash`           | `proxy.tembo.io/anthropic`    |

diff --git a/features/models.mdx b/features/models.mdx
@@ -0,0 +1,76 @@
+---
+title: "Models"
+description: "Supported models, providers, and BYOK options."
+---
+
+Tembo supports multiple model providers across coding agents. You can use Tembo-hosted models with [Max](/features/max), or connect your own keys with BYOK (Bring Your Own Key).
+
+## BYOK (Bring Your Own Key)
+
+BYOK lets your workspace call models with your own provider credentials instead of Tembo-managed credentials.
+
+- Add keys in **Settings -> Models -> API Keys**.
+- You can connect OpenAI, Anthropic, Cursor, Amp, and AWS Bedrock credentials.
+- Tembo still handles orchestration, task context, sandbox execution, and PR automation.
+
+### Bedrock BYOK support
+
+Tembo supports BYOK with Amazon Bedrock.
+
+To enable it, add:
+
+- **AWS Access Key ID**
+- **AWS Secret Access Key**
+- **AWS Region**
+
+in **Settings -> Models -> API Keys -> AWS Bedrock**.
+
+<Frame>
+  <img src="/images/models/aws-bedrock-byok.png" alt="AWS Bedrock BYOK API key fields in Tembo Settings" />
+</Frame>
+
+## Supported models
+
+The table below reflects the models currently supported by Tembo.
+
+| Model | Model ID | Provider | BYOK Required |
+| --- | --- | --- | --- |
+| Opus 4.6 | `claude-opus-4-6` | Anthropic | No |
+| Sonnet 4.6 | `claude-sonnet-4-6` | Anthropic | No |
+| Opus 4.5 | `claude-opus-4-5` | Anthropic | No |
+| Haiku 4.5 | `claude-4-5-haiku` | Anthropic | No |
+| GPT-5.4 | `gpt-5.4` | OpenAI | Yes |
+| GPT-5.4 Mini | `gpt-5.4-mini` | OpenAI | No |
+| GPT-5.4 Nano | `gpt-5.4-nano` | OpenAI | No |
+| GPT-5.3 Codex | `gpt-5.3-codex` | OpenAI | No |
+| GPT-5.3 Codex Spark | `gpt-5.3-codex-spark` | OpenAI | Yes |
+| GPT-5.2 Codex | `gpt-5.2-codex` | OpenAI | No |
+| GPT-5.2 | `gpt-5.2` | OpenAI | Yes |
+| GPT-5.1 Codex Max | `gpt-5.1-codex-max` | OpenAI | Yes |
+| GPT-5.1 Codex Mini | `gpt-5.1-codex-mini` | OpenAI | Yes |
+| GPT-5.1 Codex | `gpt-5.1-codex` | OpenAI | Yes |
+| GPT-5.1 | `gpt-5.1` | OpenAI | Yes |
+| GPT-5 Codex | `gpt-5-codex` | OpenAI | Yes |
+| GPT-5 | `gpt-5` | OpenAI | Yes |
+| GPT-5 High | `gpt-5-high` | OpenAI | Yes |
+| GPT-5 Medium | `gpt-5-medium` | OpenAI | Yes |
+| GPT-5 Low | `gpt-5-low` | OpenAI | Yes |
+| GPT-5 Minimal | `gpt-5-minimal` | OpenAI | Yes |
+| GPT-oss 120B | `gpt-oss-120b` | OpenAI | No |
+| GLM 5 | `zai-glm-5` | Z.ai | No |
+| GLM 4.7 | `zai-glm-4.7` | Z.ai | No |
+| Composer 1.5 | `composer-1.5` | Cursor | Yes |
+| Composer 2 | `composer-2` | Cursor | Yes |
+| Composer 2 Fast | `composer-2-fast` | Cursor | Yes |
+| Gemini 3 Pro | `gemini-3-pro` | Google | No |
+| Gemini 3.1 Pro | `gemini-3.1-pro` | Google | No |
+| Gemini 3 Flash | `gemini-3-flash` | Google | No |
+| Grok | `grok` | xAI | Yes |
+| Kimi K2.5 | `kimi-k2p5` | Fireworks | No |
+| MiniMax M2.5 | `minimax-m2p5` | MiniMax | No |
+| Qwen 3 32B | `qwen-3-32b` | Qwen | No |
+| Llama 3.3 70B | `llama-3.3-70b` | Meta | No |
+
+<Note>
+  Model availability can vary by agent and workspace configuration. If a model is disabled in your workspace, it will not appear in agent pickers until re-enabled.
+</Note>
diff --git a/features/pull-requests.mdx b/features/pull-requests.mdx
@@ -5,6 +5,8 @@ description: 'Tembo opens PRs with clear descriptions, signed commits, and your
 
 When a task is complete, Tembo opens a pull request. You review it, use the [feedback loop](/features/feedback-loop) to iterate, and merge when ready.
 
+If a task spans multiple repositories, Tembo opens a pull request or merge request in each one. It can also coordinate changes across supported git providers, including GitHub, GitLab, and Bitbucket.
+
 ## What's in a Tembo PR
 
 - Clear description of the problem and solution

diff --git a/features/sandbox-environment.mdx b/features/sandbox-environment.mdx
@@ -45,12 +45,35 @@ Both sandbox types come with:
 | **Containers** | Docker 28, Docker Compose 2.31 (Large VM only) |
 | **Other** | Git, curl, ShellCheck, httpie |
 
-<Note>Go, Rust, Java, and Elixir are available through Nix dev shells or Dev Containers. Use a `flake.nix` or `.devcontainer/devcontainer.json` to install language-specific tooling for your project.</Note>
-
-## Nix support
-
-If your repo has a `flake.nix` with `devShells.x86_64-linux.default`, Tembo automatically detects it and runs commands inside your Nix dev shell.
-
-## Dev Containers
-
-Tembo can run tasks inside a Dev Container (`.devcontainer/devcontainer.json`). Requires the Large VM sandbox. Same format as VS Code Dev Containers and GitHub Codespaces.
+<Note>Go, Rust, Java, and Elixir are available through Nix dev shells. Add a `flake.nix` to install language-specific tooling for your project.</Note>
+
+## Add custom dependencies
+
+To add custom dependencies in the sandbox, include a `flake.nix` with `devShells.x86_64-linux.default`. Tembo automatically detects it and runs commands inside your Nix dev shell.
+
+Here is a minimal `flake.nix` example you can copy and adapt:
+
+```nix
+{
+  description = "Dev shell";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = nixpkgs.legacyPackages.${system};
+      in {
+        devShells.default = pkgs.mkShell {
+          buildInputs = with pkgs; [
+            go
+            # Add other packages here, e.g. rustc cargo jdk
+          ];
+        };
+      }
+    );
+}
+```