> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Guides

Step-by-step guides for Warp, the agentic development environment — from first setup to coding agent workflows, MCP integrations, and full app builds.

Practical, task-oriented walkthroughs that help you get productive with Warp’s coding agents. Each guide walks through a real AI coding workflow with actual prompts, code, and reproducible results.

Note

**New to Warp?** Start with [Welcome to Warp](/guides/getting-started/welcome-to-warp/), then explore [10 Warp Coding Features You Should Know](/guides/getting-started/10-coding-features-you-should-know/).

Featured (6) All (60) Set up your environment (9) Work with agents (17) Automate your workflow (10) Connect external services (9) Build & deploy apps (8) Review & debug (7)

[Work with agents

### Build a self-improving agent

Build an outer improvement loop where a scheduled agent reviews past runs, learns from team corrections, and proposes skill file updates — so your factory gets better over time.

agentssoftware-factorycloud-agentsschedules

](/guides/agent-workflows/build-a-self-improving-agent/)[Work with agents

### Build a triage agent

Create a triage agent that reviews new GitHub issues, applies labels, and flags open questions. Your backlog stays actionable without manual effort.

agentscloud-agentssoftware-factory

](/guides/agent-workflows/build-a-triage-agent/)[Work with agents

### Attach agent context to PRs

Share a Warp agent session or cloud agent run link in a GitHub pull request so reviewers can inspect the context behind agent-generated changes.

agentscode-reviewsession-sharing

](/guides/agent-workflows/how-to-attach-agent-session-context-to-github-prs/)[Work with agents

### Edit agent code in Warp

Review, edit, and refine AI-generated code diffs directly in Warp — accept, reject, or modify changes before applying them.

agents

](/guides/agent-workflows/how-to-edit-agent-code-in-warp/)[Work with agents

### Explain your codebase using Warp

Use Warp's coding agents with semantic and symbol search to explore, understand, and modify unfamiliar codebases — demonstrated on a large Rust project.

agents

](/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase/)[Review & debug

### Review AI-generated code

Review AI-generated code in Warp with visual diffs and inline comments — works with Claude Code, Codex, or any CLI agent.

agentscode-review

](/guides/agent-workflows/how-to-review-ai-generated-code/)[Review & debug

### Review PRs like a senior dev

Prompt Warp's coding agent to generate structured PR reviews with risk assessment, critical issues, and merge confidence scoring.

agentscode-review

](/guides/agent-workflows/how-to-review-prs-like-a-senior-dev/)[Work with agents

### Run 3 agents in parallel

Run three agent tasks simultaneously in Warp — modify UI, analyze code reviews, and summarize production logs in parallel.

agents

](/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui/)[Work with agents

### Run multiple AI coding agents

Run Claude Code, Codex, Warp Agent, and other coding agents across worktrees, tabs, and cloud orchestration with clear task ownership.

agents

](/guides/agent-workflows/how-to-run-multiple-ai-coding-agents/)[Work with agents

### Run unattended agents

Start unattended cloud agents from schedules, Slack, Linear, GitHub Actions, the Oz CLI, or the Oz API, then inspect every run.

agentscloud-agentsschedules

](/guides/agent-workflows/how-to-run-unattended-agents/)[Work with agents

### Use voice and images to prompt coding agents

Use voice and image context to prompt coding agents faster in Warp — works with Claude Code, Codex, and any CLI agent.

agents

](/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents/)[Work with agents

### Run a software factory in the cloud

Move your software factory loop off developer machines and into Oz — with cloud environments, event-driven triggers, least-privilege permissions, and full run auditability.

agentscloud-agentssoftware-factoryorchestration

](/guides/agent-workflows/run-a-software-factory-in-the-cloud/)[Work with agents

### Run multiple agents at once

Run multiple agent tasks simultaneously in Warp — revert PRs, edit shortcuts, and add tests across repos without losing context.

agents

](/guides/agent-workflows/running-multiple-agents-at-once-with-warp/)[Work with agents

### Set up your software factory

Add the implementation and reviewer agents to complete your software factory, then wire all four agent roles together using GitHub labels as the state machine.

agentssoftware-factorycloud-agents

](/guides/agent-workflows/set-up-a-software-factory/)[Work with agents

### Understand your codebase

Use Warp's Codebase Context to search across client and server repos, generate architecture summaries, and onboard to unfamiliar features fast.

agents

](/guides/agent-workflows/understanding-your-codebase/)[Work with agents

### Use images as context

Attach screenshots and design mockups as context for Warp's agent to generate UI code, debug visual issues, and match Figma designs.

agents

](/guides/agent-workflows/using-images-as-context-with-warp/)[Work with agents

### 5 agent workflows for product managers

Five agent workflows that automate status updates, documentation, Slack search, and meeting prep for product managers.

agents

](/guides/agent-workflows/warp-for-product-managers/)[Work with agents

### Warp vs Claude Code

Compare Warp and Claude Code across setup, diff review, model selection, configuration, and performance.

agentsthird-party-tools

](/guides/agent-workflows/warp-vs-claude-code/)[Work with agents

### Write specs with agents

Use agents to turn a ready-to-implement issue into a product spec and a tech spec — the blueprints that guide implementation and anchor code review.

agentssoftware-factory

](/guides/agent-workflows/write-product-and-tech-specs-with-agents/)[Build & deploy apps

### Build a Chrome extension

Build a D3.js Sankey diagram Chrome extension using Warp — scaffold, debug, coordinate multiple agents, and publish to the Chrome Web Store.

build-appfrontend

](/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css/)[Build & deploy apps

### Build a real-time chat app

Build and deploy a real-time chat app with Python, FastAPI, and JavaScript — from idea to production, all inside Warp.

build-appmcp

](/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway/)[Build & deploy apps

### Build Warp's input component

Watch how a Warp designer uses Warp's own agent to locate, modify, and test a UI component change in a large Rust codebase.

build-appfrontend

](/guides/build-an-app-in-warp/building-warps-input-with-warp/)[Automate your workflow

### Create Rules for agents

Create reusable Rules in Warp to encode team conventions — like Dockerfile patterns or dependency management — so agents follow your standards.

rules

](/guides/configuration/creating-rules-for-agents/)[Automate your workflow

### Configure YOLO and strategic Agent Profiles

Configure custom agent profiles in Warp to control planning depth, autonomy, and execution speed — demonstrated with YOLO and Strategic examples.

profiles

](/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles/)[Automate your workflow

### Create project Rules for an existing project

Create and maintain an AGENTS.md project rules file so coding agents always understand your project's setup, commands, architecture, and conventions.

rules

](/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind/)[Automate your workflow

### Set coding best practices

Use Warp Rules to enforce coding style, TypeScript conventions, and documentation quality across AI-generated code.

rules

](/guides/configuration/how-to-set-coding-best-practices/)[Automate your workflow

### Set coding preferences with Rules

Store your package manager, environment tool, and CLI preferences as Warp Rules so agents automatically use pnpm, miniconda, or your preferred tools.

rules

](/guides/configuration/how-to-set-coding-preferences-with-rules/)[Automate your workflow

### Set tech stack preferences with Rules

Define your preferred frameworks and tech stack in Warp Rules so agents consistently use Astro, SvelteKit, Vite, or your tools of choice.

rules

](/guides/configuration/how-to-set-tech-stack-preferences-with-rules/)[Automate your workflow

### Set up self-serve data analytics with skills

Set up a self-serve data analytics workflow in Warp using two community Skills that map questions to dbt models and structure reproducible analyses.

skills

](/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills/)[Automate your workflow

### Sync your monorepos

Define global Rules in Warp to keep monorepo schemas, server types, and client types automatically synchronized across repositories.

rules

](/guides/configuration/how-to-sync-your-monorepos/)[Automate your workflow

### Use Agent Profiles efficiently

Compare Strategic and YOLO agent profiles side-by-side to choose the right balance of planning, safety, and speed for your project.

profiles

](/guides/configuration/how-to-use-agent-profiles-efficiently/)[Automate your workflow

### Trigger reusable actions with saved prompts

Save and share prompts in Warp Drive to automate commits, code reviews, and PR creation across your team.

rules

](/guides/configuration/trigger-reusable-actions-with-saved-prompts/)[Build & deploy apps

### Analyze Cloud Run logs

Use Warp to pull, organize, and analyze Cloud Run production logs by severity with natural language prompts and automated Python scripts.

cloud

](/guides/devops/how-to-analyze-cloud-run-logs-gcloud/)[Build & deploy apps

### Create a production-ready Docker setup

Use Agents in Warp to generate optimized Dockerfiles, docker-compose configs, and .dockerignore files for multi-stage production deployments.

docker

](/guides/devops/how-to-create-a-production-ready-docker-setup/)[Review & debug

### Create a priority matrix for database optimization

Prompt Warp to audit SQL queries, analyze execution plans, and generate a priority matrix ranking database optimizations by impact and effort.

database

](/guides/devops/how-to-create-priority-matrix-for-database-optimization/)[Review & debug

### Generate unit and security tests to debug faster

Prompt Warp to generate comprehensive unit and security tests for REST APIs, including SQL injection, XSS, and auth validation checks.

testing

](/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster/)[Review & debug

### Prevent secrets from leaking

Use Warp Rules and built-in Secret Redaction to prevent API keys and credentials from leaking in agent output, demos, and shared sessions.

cloud

](/guides/devops/how-to-prevent-secrets-from-leaking/)[Review & debug

### Write SQL commands inside a Postgres REPL

Use Agents in Warp inside a Postgres REPL to translate natural language into SQL queries — works with Node.js, Python, and MySQL too.

database

](/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl/)[Build & deploy apps

### Improve your Kubernetes workflow

Streamline kubectl and Helm workflows with Warp's AI assistance, active suggestions, custom workflows, and synchronized panes.

kubernetes

](/guides/devops/improve-your-kubernetes-workflow-kubectl-helm/)[Connect external services

### Context7 MCP: update Astro project with best practices

Use the Context7 MCP server to give Warp agents real-time access to framework documentation for automated project upgrades.

mcp

](/guides/external-tools/context7-mcp-update-astro-project-with-best-practices/)[Connect external services

### Figma remote MCP: create a website from a Figma file

Connect Warp to Figma's remote MCP server via OAuth and generate front-end code directly from your design files.

mcpfrontend

](/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch/)[Connect external services

### GitHub MCP: summarize open PRs and create GitHub issues

Connect the GitHub MCP server to Warp to summarize open PRs, create issues from TODO comments, and automate repo management.

mcpcode-review

](/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues/)[Set up your environment

### Set up Claude Code

Set up Claude Code in Warp, configure it for your project, and learn productivity tips — from voice prompting to visual code review.

third-party-tools

](/guides/external-tools/how-to-set-up-claude-code/)[Set up your environment

### Set up Codex CLI

Set up OpenAI's Codex CLI in Warp, configure it for your project, and learn productivity tips for faster AI-assisted coding workflows in Warp.

third-party-tools

](/guides/external-tools/how-to-set-up-codex-cli/)[Set up your environment

### Set up Gemini CLI

Set up Google's Gemini CLI in Warp, configure it for your project, and learn productivity tips for faster AI-assisted coding workflows.

third-party-tools

](/guides/external-tools/how-to-set-up-gemini-cli/)[Set up your environment

### Set up Ollama

Install Ollama, run LLMs locally, compare model performance, and integrate local models into your apps using Warp.

third-party-tools

](/guides/external-tools/how-to-set-up-ollama/)[Set up your environment

### Set up OpenCode

Set up OpenCode in Warp, configure it for your project, and learn productivity tips for faster AI-assisted coding workflows.

third-party-tools

](/guides/external-tools/how-to-set-up-opencode/)[Connect external services

### Linear MCP: retrieve issue data

Add the Linear MCP server to Warp and query your issues, tasks, and assignments directly from the terminal.

mcp

](/guides/external-tools/linear-mcp-retrieve-issue-data/)[Connect external services

### Linear MCP: update tickets with a lean build approach

Use Warp's Linear MCP integration to update ticket descriptions, propagate changes to subtasks, and maintain a lean build strategy.

mcp

](/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach/)[Connect external services

### Puppeteer MCP: scrape Amazon web reviews

Configure the Puppeteer MCP server in Warp to automate browser tasks like navigating sites, scraping product data, and analyzing reviews.

mcp

](/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews/)[Connect external services

### Sentry MCP: fix Sentry error in Empower website

Connect the Sentry MCP server to Warp, fetch live error data, diagnose stack traces, and auto-generate fixes for production issues.

mcp

](/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website/)[Connect external services

### SQLite and Stripe MCP: basic queries you can make after setup

Connect SQLite and Stripe MCP servers to Warp and run conversational queries against your local database and payment data.

mcpdatabase

](/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up/)[Connect external services

### Connect agents to MCP servers

Use MCP servers to connect Warp agents to developer tools like GitHub, Linear, Sentry, and Figma across local and cloud agent workflows.

mcp

](/guides/external-tools/using-mcp-servers-with-warp/)[Build & deploy apps

### Code UI that matches your mockup

Prompt Warp to generate pixel-perfect React + Tailwind code from design mockups, with structured specs and iterative refinement.

frontend

](/guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind/)[Build & deploy apps

### Replace a UI element in Warp

Use Agent Mode in Warp to plan and execute icon replacements across a large Rust codebase — with live diffs, auto-compilation, and self-correction.

frontend

](/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase/)[Set up your environment

### 10 coding features you should know

Discover 10 essential coding features in Warp — file search, tabbed editor, find and replace, syntax highlighting, code review panel, and more.

getting-startedagents

](/guides/getting-started/10-coding-features-you-should-know/)[Set up your environment

### Customize Warp's appearance

Customize Warp's themes, input placement, AI settings, codebase indexing, team collaboration, and visual appearance to fit your workflow.

getting-started

](/guides/getting-started/how-to-customize-warps-appearance/)[Set up your environment

### Make Warp's UI more minimal

Reduce visual noise in Warp by disabling UI elements, switching to a minimal theme, using the classic prompt, and hiding the tab bar.

getting-started

](/guides/getting-started/how-to-make-warps-ui-more-minimal/)[Review & debug

### Master Warp's Code Review panel

Use Warp's Code Review Panel to view file diffs, edit code inline, componentize changes, and commit directly — all without leaving the terminal.

getting-startedcode-review

](/guides/getting-started/how-to-master-warps-code-review-panel/)[Set up your environment

### Welcome to Warp

Get oriented with Warp's agentic terminal. Learn the basics of prompt-based coding, blending terminal and agent workflows, and navigating the interface.

getting-started

](/guides/getting-started/welcome-to-warp/)
