Skip to content

Guides

Guides

Step-by-step guides for Derp, 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 Derp's coding agents. Each guide walks through a real AI coding workflow with actual prompts, code, and reproducible results.

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

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

Work with agents

Attach agent context to PRs

Share a Derp 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

Work with agents

Edit agent code in Derp

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

Work with agents

Explain your codebase using Derp

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

Review AI-generated code

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

agentscode-review

Review PRs like a senior dev

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

agentscode-review

Work with agents

Run 3 agents in parallel

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

Work with agents

Run multiple AI coding agents

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

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

Work with agents

Use voice and images to prompt coding agents

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

Work with agents

Run a software factory in the cloud

Set up the Oz-native production path for your software factory: dedicated cloud environments, team-scoped secrets, native event triggers, and full audit trails for every agent run.

agentscloud-agentssoftware-factoryorchestration

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

Work with agents

Understand your codebase

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

Work with agents

Use images as context

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

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.

Work with agents

Derp vs Claude Code

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

agentsthird-party-tools

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

Build & deploy apps

Build a Chrome extension

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

build-appfrontend

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 Derp.

Build & deploy apps

Build Derp's input component

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

build-appfrontend

Automate your workflow

Create Rules for agents

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

Automate your workflow

Configure YOLO and strategic Agent Profiles

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

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.

Automate your workflow

Set coding best practices

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

Automate your workflow

Set coding preferences with Rules

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

Automate your workflow

Set tech stack preferences with Rules

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

Automate your workflow

Set up self-serve data analytics with skills

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

Automate your workflow

Sync your monorepos

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

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.

Work with agents

Use tokens efficiently

Get more out of every token your coding agents use in Derp with model choice and routing, focused context, conversation management, and Rules.

Automate your workflow

Trigger reusable actions with saved prompts

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

Build & deploy apps

Analyze Cloud Run logs

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

Build & deploy apps

Create a production-ready Docker setup

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

Create a priority matrix for database optimization

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

Generate unit and security tests to debug faster

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

Prevent secrets from leaking

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

Write SQL commands inside a Postgres REPL

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

Build & deploy apps

Improve your Kubernetes workflow

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

Connect external services

Context7 MCP: update Astro project with best practices

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

Connect external services

Figma remote MCP: create a website from a Figma file

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

Connect external services

GitHub MCP: summarize open PRs and create GitHub issues

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

Set up your environment

Set up Claude Code

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

third-party-tools

Set up your environment

Set up Codex CLI

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

third-party-tools

Set up your environment

Set up Gemini CLI

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

third-party-tools

Set up your environment

Set up Ollama

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

third-party-tools

Set up your environment

Set up OpenCode

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

third-party-tools

Connect external services

Linear MCP: retrieve issue data

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

Connect external services

Linear MCP: update tickets with a lean build approach

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

Connect external services

Puppeteer MCP: scrape Amazon web reviews

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

Connect external services

Sentry MCP: fix Sentry error in Empower website

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

Connect external services

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

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

Connect external services

Connect agents to MCP servers

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

Build & deploy apps

Code UI that matches your mockup

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

Build & deploy apps

Replace a UI element in Derp

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

Set up your environment

10 coding features you should know

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

getting-startedagents

Set up your environment

Customize Derp's appearance

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

getting-started

Set up your environment

Make Derp's UI more minimal

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

getting-started

Master Derp's Code Review panel

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

getting-startedcode-review

Set up your environment

Welcome to Derp

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

getting-started