Agents Settings

The Agents settings tab in PostQode allows you to discover, inspect, enable, disable, and configure specialized agents across different scopes.

Access these settings in VS Code via PostQode Settings → Agents tab.

---

Agent Hierarchy & Scopes

PostQode supports custom agents defined across four hierarchical scopes:

Organization Agents (from Web Console / pq-server)
       │
       ▼
Personal Global Agents (~/.postqode/agents/*.md)
       │
       ▼
Project-Specific Agents (.postqode/agents/*.md)
       │
       ▼
Built-in Pre-Packaged Agents (code-reviewer, web-qa, deploy-agent, etc.)

---

Agent Management Capabilities

In the Agents settings section, you can:

1. Default Core Modes: Plan Mode and Agent Mode are built-in foundational modes and cannot be disabled. They serve as the primary planning and execution engines.
2. Toggle Specialized Agents: Enable or disable specialized packaged agents (code-reviewer, doc-writer, security-auditor, web-qa, etc.) to declutter your mode selector dropdown in the chat view.
3. Inspect Prompt & Tool Permissions: View an agent's system prompt instructions, allowed tools (read_file, write_to_file, execute_command, postqode_browser_agent, etc.), and model overrides.
4. Set Default Model per Agent: Assign specific cost-effective or high-reasoning models to specific agents (e.g. lightweight models for doc-writer, frontier reasoning models for security-auditor).
5. Create Custom Agents: Click Create New Agent to scaffold a new agent markdown file in .postqode/agents/ or ~/.postqode/agents/.

---

Packaged Built-in Agents Reference

Agent	Scope	Default Role
code-reviewer	Built-in	Performs rigorous security, performance, and style reviews on staged diffs.
deploy-agent	Built-in	Validates build artifacts, checks CI status, and creates pull requests.
design-agent	Built-in	Evaluates UI component consistency and generates styling tokens.
doc-writer	Built-in	Generates and updates developer documentation, READMEs, and API specs.
explore	Built-in	Rapid read-only codebase exploration without making any edits.
perf-monitor	Built-in	Profiling and performance optimization suggestions.
product-strategist	Built-in	User story breakdown, acceptance criteria, and PRD drafting.
security-auditor	Built-in	OWASP top 10 auditing, dependency scanning, and secret detection.
web-automator	Built-in	Playwright browser automation and web script generation.
web-qa	Built-in	Interactive visual testing and bug reproduction in browser.

---

Related Documentation

• Built-in Agents Guide — How to configure custom agent markdown files.
• Using Modes — Switching between Plan, Agent, and specialized roles.