Skip to main content

PostQode Settings

PostQode provides comprehensive settings to customize your development experience. Access all settings through the PostQode panel in VS Code to configure models, features, and general preferences.

Quick Access​

  1. Open PostQode Panel: Click the PostQode icon in VS Code sidebar
  2. Access Settings: Click the Settings (gear) icon in the PostQode panel
  3. Configure Options: Navigate through different settings categories

Settings Categories​

Model Configuration​

Configure AI models and providers for Plan Mode and Agent Mode.

Key Features:

  • Dual Mode Configuration: Enable "Use different models for Plan and Agent mode" to display separate configuration tabs for Plan Mode (e.g. Claude 3.7 Sonnet for architecture) and Agent Mode (e.g. DeepSeek R1 or GPT-4o for execution).
  • Sort Underlying Provider Routing: Dynamically orders provider endpoints based on round-trip latency and active rate limit status.
  • Multiple AI provider support (Anthropic, OpenAI, DeepSeek, Google Gemini, OpenRouter, Ollama, LM Studio).
  • API key management and custom model ID specification.

Browser Settings​

Configure headless execution, DOM accessibility snapshots vs vision mode, persistent browser sessions, proxy gateways, and trace recordings for Web Agent tasks.

Agent Management​

Enable or customize built-in specialized agents (code-reviewer, deploy-agent, design-agent, doc-writer, explore, perf-monitor, product-strategist, security-auditor, web-automator, web-qa). Plan Mode and Agent Mode are core built-in modes.

Feature Settings​

Customize advanced features and performance options:

  • Focus Chain Reminder Interval: Interval (in turns) for reminding the agent of current multi-step sub-goals.
  • Scratch Files for Context: PostQode saves conversation snapshots and reasoning scratchpads to workspace files (.postqode/scratch/) rather than losing critical history through aggressive truncation.
  • Multi-Root Workspace & Path Resolution: Support for monorepos and multi-folder workspaces.
  • Checkpoints: Shadow git version snapshots allowing instant rollback of file changes.

Terminal Settings​

Configure Terminal Execution Mode, auto-approve commands, shell profile overrides, and timeout safeguards.

Environment Pre-requisites & Debug Tools​

  • Pre-requisites: Check and install dependencies for Android (adb, Node.js, Appium, Java JDK), iOS, and external tooling.
  • Debug Tools:
    • Reset Workspace State: Clears corrupt local task state without affecting project source code.
    • Reset Global State: Resets global settings and provider credentials.
    • Export Task State: Exports complete JSON task transcripts for bug reporting.
  • About PostQode: View current extension build version, core daemon status, and release notes.

Getting Started​

First-Time Setup​

  1. Choose Your Provider: Start with OpenRouter for free models or Anthropic for premium experience
  2. Configure API Keys: Add your API keys securely in Model Configuration
  3. Enable Features: Turn on helpful features like Auto Compact and MCP Marketplace
  4. Customize Experience: Adjust settings based on your workflow needs

For most users, we recommend:

  • Provider: OpenRouter (free models) or Anthropic (premium)
  • Error Reporting: Enabled to help improve PostQode
  • Auto Compact: Enabled for better context management
  • MCP Marketplace: Enabled for additional tools
  • Checkpoints: Disabled initially (enable if needed)

Security and Privacy​

PostQode prioritizes your security and privacy:

  • Local Storage: All settings and API keys stored locally
  • Encryption: Sensitive data encrypted at rest
  • No Code Transmission: Your code never leaves your machine
  • User Control: Full control over all data and settings

Next Steps: Choose a settings category above to configure your PostQode experience, or start with Model Configuration to set up your AI provider.

Is this documentation incorrect or incomplete? Report an issue on GitHub