# Amp

Amp is a coding agent and development environment built for the frontier.

This is an index of Amp's product pages and documentation for agents and other
programmatic readers. Each documentation link serves the raw Markdown rendition of a page.
The human-readable HTML version of a page is at https://ampcode.com/docs with the
`/markdown` path segment removed (for example https://ampcode.com/docs/prompting).

## Product

- [Pricing](https://ampcode.com/pricing): Tiers, included agent and orb usage, and answers to common billing questions. The tiers are also in Markdown at https://ampcode.com/docs/markdown/pricing.
- [What Are Orbs?](https://ampcode.com/what-are-orbs): Cloud sandboxes where each Amp thread gets its own machine with your repository.
- [Modes & Models](https://ampcode.com/modes): Which models each Amp agent mode uses.
- [Chronicle](https://ampcode.com/chronicle): Amp news, notes from the team, and podcast episodes.

## Get Started

- [Introduction](https://ampcode.com/docs/markdown): Amp is a coding agent and development environment built for the frontier. Learn what Amp does, install it, and run your first agent.
- [The Dial](https://ampcode.com/docs/markdown/the-dial): Choose a mode, tune its models, and add your own agents to the dial.
- [Modes & Models](https://ampcode.com/docs/markdown/models-and-subagents): Understand the models and subagents Amp uses.
- [Prompting](https://ampcode.com/docs/markdown/prompting): Write prompts and work with messages, files, and other threads.
- [Designing UI](https://ampcode.com/docs/markdown/designing-ui): Explore UI designs from screenshots, refine a direction, and build it in your app.
- [Tools](https://ampcode.com/docs/markdown/tools): Understand the tools Amp uses to inspect and change your code.
- [Projects](https://ampcode.com/docs/markdown/projects): Connect a repository to Amp settings, secrets, and threads.
- [Feedback Widget](https://ampcode.com/docs/markdown/feedback-widget): Point at parts of your website, comment, and have Amp start a thread in your project.
- [GitHub & Git](https://ampcode.com/docs/markdown/github): Connect GitHub and learn how orbs clone, commit, push, and sign.
- [GitLab](https://ampcode.com/docs/markdown/gitlab): Connect gitlab.com or a self-managed instance, set up Push Updates, and allow network access.
- [Integrations](https://ampcode.com/docs/markdown/integrations): Connect Amp to GitHub, Linear, Slack, and other services.
- [Google](https://ampcode.com/docs/markdown/google): Connect Gmail, Calendar, Docs, Sheets, and Drive, or use your own OAuth client.
- [Threads](https://ampcode.com/docs/markdown/threads): Start, continue, share, and organize conversations with the agent.
- [Spaces](https://ampcode.com/docs/markdown/spaces): Plan and direct work with your team in one project while Amp starts threads for it.
- [Pricing](https://ampcode.com/docs/markdown/pricing): Understand plans, credits, and usage.

## Orbs

- [Overview](https://ampcode.com/docs/markdown/orbs): Learn how Amp runs work in remote environments.
- [Getting Started](https://ampcode.com/docs/markdown/orbs/getting-started): Set up a project and start your first orb.
- [Customizing Orbs](https://ampcode.com/docs/markdown/orbs/customizing): Prepare every new orb for your project.
- [Shipping Changes](https://ampcode.com/docs/markdown/orbs/shipping): Choose how the agent lands changes and customize the Ship prompt.
- [Sizes & Costs](https://ampcode.com/docs/markdown/orbs/sizes-and-costs): Choose the right compute size and understand billing.
- [Handling Secrets](https://ampcode.com/docs/markdown/orbs/handling-secrets): Give orbs secure access to private services.
- [Files & Attachments](https://ampcode.com/docs/markdown/orbs/files-and-attachments): Give Amp images, videos, logs, documents, and datasets.
- [Portals & Desktop](https://ampcode.com/docs/markdown/orbs/portals): Share services running inside an orb, and use browsers and other graphical apps there.
- [macOS Satellites](https://ampcode.com/docs/markdown/orbs/mac): Build, test, and run iOS and Mac apps on a Mac your orb starts.
- [Profiles](https://ampcode.com/docs/markdown/orbs/profiles): Keep your sign-ins and saved passwords in Chrome across orbs.
- [Agent to Agent](https://ampcode.com/docs/markdown/orbs/agent-to-agent): Delegate work between agents and exchange results.
- [Automations & Webhooks](https://ampcode.com/docs/markdown/orbs/automations): Run Amp on a schedule or at a specific time, or start work when an external event happens.
- [Self-Hosted: Overview](https://ampcode.com/docs/markdown/orbs/self-hosted): Run orbs on your own infrastructure with a dispatch program.
- [Self-Hosted: Kubernetes](https://ampcode.com/docs/markdown/orbs/self-hosted/kubernetes): Install and operate the self-hosted orbs Helm chart on GKE, EKS, or AKS.

## Apps

- [Overview](https://ampcode.com/docs/markdown/apps): Install Amp on your Mac, iPhone, iPad, Android phone, or Windows PC to control orbs from anywhere.
- [macOS](https://ampcode.com/docs/markdown/apps/mac): Install and update the Mac app, open Puck in its own window, and more.
- [Use Your Mac as a Runner](https://ampcode.com/docs/markdown/apps/mac/runner): Let the Amp app for macOS run threads you start from anywhere.
- [iPhone & iPad](https://ampcode.com/docs/markdown/apps/ios): Install the iOS app through TestFlight, get notifications, and call Puck.
- [Android](https://ampcode.com/docs/markdown/apps/android): Install the Android app and call Puck from your phone.
- [Windows](https://ampcode.com/docs/markdown/apps/windows): Install the experimental Windows app and see what it can do so far.

## Puck

- [Meet Puck](https://ampcode.com/docs/markdown/puck): Launch and coordinate agents with Puck.
- [Slack Integration](https://ampcode.com/docs/markdown/puck/slack-integration): Use your personal Puck from Slack.

## Collaborate

- [Workspaces](https://ampcode.com/docs/markdown/collaborate/workspaces): Connect your team with shared threads and pooled billing.
- [Groups](https://ampcode.com/docs/markdown/collaborate/groups): Share threads and assign entitlements to part of a workspace.
- [Multiplayer](https://ampcode.com/docs/markdown/collaborate/multiplayer): Work with other people in the same Amp thread and orb.
- [Huddle](https://ampcode.com/docs/markdown/collaborate/huddle): Talk with your team in a voice and video call inside every thread.

## Customize

- [Plugins](https://ampcode.com/docs/markdown/customize/plugins): Add tools and other behavior with plugins.
- [Decision Models](https://ampcode.com/docs/markdown/customize/decision-models): Ask Jev or GPT-6 Luna typed questions with amp.ai.decide, and select which decision model answers.
- [Global Plugins & Skills](https://ampcode.com/docs/markdown/customize/global-plugins-and-skills): Use, share, and publish extensions everywhere Amp runs.
- [Skills](https://ampcode.com/docs/markdown/customize/skills): Teach Amp repeatable ways to complete tasks.
- [MCP](https://ampcode.com/docs/markdown/customize/mcp): Connect Amp to MCP servers.
- [AGENTS.md](https://ampcode.com/docs/markdown/customize/agents-md): Give Amp durable guidance for your codebase.
- [Model Routing](https://ampcode.com/docs/markdown/customize/model-routing): Serve models through your own keys, subscriptions, and gateways, in the order you choose.

## CLI

- [Getting Started](https://ampcode.com/docs/markdown/cli): Install Amp and use the CLI.
- [Keybindings](https://ampcode.com/docs/markdown/cli/keybindings): Learn and customize CLI keyboard shortcuts.
- [Execute Mode](https://ampcode.com/docs/markdown/cli/execute-mode): Run Amp from scripts and commands.
- [Spawning Orbs](https://ampcode.com/docs/markdown/cli/spawning-orbs): Start and continue orb threads from the terminal with amp -ox.
- [Clone Repositories](https://ampcode.com/docs/markdown/cli/clone): Clone Amp-hosted projects and plugins or skills repositories with amp clone.
- [Streaming JSON](https://ampcode.com/docs/markdown/cli/streaming-json): Use the CLI from programs and scripts.
- [Configuration](https://ampcode.com/docs/markdown/cli/settings): Configure Amp for yourself or a workspace.
- [Runners](https://ampcode.com/docs/markdown/cli/runners): Run remotely created threads on your own machine.
- [Cross-Client Access](https://ampcode.com/docs/markdown/cli/remote-control): Continue a running CLI thread across clients.

## Reference

- [SDK: Overview](https://ampcode.com/docs/markdown/sdk): Use Amp from your own programs.
- [SDK: TypeScript](https://ampcode.com/docs/markdown/sdk/typescript): Use the TypeScript SDK.
- [SDK: Python](https://ampcode.com/docs/markdown/sdk/python): Use the Python SDK.
- [Plugin API](https://ampcode.com/docs/markdown/plugin-api): The generated `@ampcode/plugin` type reference and an end-to-end example plugin.
- [Egress IPs](https://ampcode.com/docs/markdown/egress-ips): Allowlist the IP addresses Amp's servers connect from.

## Support

- [Getting Help](https://ampcode.com/docs/markdown/support/getting-help): Contact support and check platform and service status.
- [Bug Reports & Diagnostics](https://ampcode.com/docs/markdown/support/reporting-bugs): Report bugs and share diagnostics with Amp.

## Enterprise

- [MCP Registry Allowlist](https://ampcode.com/docs/markdown/enterprise/mcp-registry-allowlist): Limit workspace members to approved MCP servers.
- [Thread Visibility](https://ampcode.com/docs/markdown/enterprise/workspace-thread-visibility-controls): Control how workspace members share threads.
- [Workspace Entitlements](https://ampcode.com/docs/markdown/enterprise/workspace-entitlements): Set per-user usage quotas for a workspace.
- [Allowed Models](https://ampcode.com/docs/markdown/enterprise/allowed-models): Choose which models workspace members can use.
- [Minimal Data Retention](https://ampcode.com/docs/markdown/enterprise/minimal-data-retention): Limit data retention by third-party model providers.
