Workflow 001: Local Agent Development

Fresh

Field	Value
Workflow ID	WF-001
Version	1.0
Status	Active

Overview

This workflow covers the complete cycle of using local agents in Warp Terminal for interactive coding assistance.

Workflow Steps

1. Set Up Your Environment

# Navigate to your project
cd /path/to/your/project

# Ensure rules are in place
cat AGENTS.md  # or create one with /init

2. Choose Agent Modality

Warp offers two modes:

• Terminal Mode - Clean terminal for running commands
• Conversation Mode - Dedicated view for multi-turn agent workflows

Switch between them using the Agent Modality toggle.

3. Start an Agent Conversation

Natural language prompts:

Fix the failing tests in the auth module

With context:

• Attach files, images, URLs, or code blocks using @ mentions
• Reference Warp Drive objects with <notebook:id> syntax

Using skills:

/deploy        # Invoke deploy skill
/code-review   # Invoke code review skill

4. Review Agent Actions

The agent will:

• Generate a task list breaking your request into steps
• Show interactive code review diffs for file changes
• Ask for approval before executing commands (if profile requires it)

5. Steer the Agent

During execution:

• Approve/reject individual actions
• Add context with follow-up messages
• Redirect the agent if it goes off track
• Cancel if needed

6. Use Active AI

When errors occur in your terminal output, Active AI proactively suggests fixes:

1. Error appears in terminal output
2. Warp detects the error pattern
3. Fix recommendation appears automatically
4. Click to apply the fix

7. Iterate

Continue the conversation to refine results. The agent maintains context from previous turns within the session.

Model Selection

Choose the best model for your task:

# Override model for a specific run
oz agent run --model claude-sonnet-4-5 --prompt "refactor this function"

Or configure default model in Settings > AI > Model.

Best Practices

• Start with clear, specific prompts
• Use rules and skills to standardize behavior
• Review diffs before applying changes
• Keep conversations focused on single tasks
• Use voice input for quick queries

See Also

• SOP 002: Skills Setup
• SOP 003: Rules Configuration
• Workflow 002: Cloud Agent Deployment