Skip to main content

Verdent for VS Code provides multiple execution modes that control how the AI interacts with your files and executes commands. Each mode offers different trade-offs between control, speed, and safety.

What You’ll Learn

  • How each execution mode works and when to use it
  • Permission models and safety considerations
  • Mode comparison and switching strategies
  • Think Hard Mode for complex reasoning tasks

Key Modes Available

Manual Accept Mode

Default mode with permission requests for every protected operation. Maximum control and oversight.

Auto-Run Mode

Automatic file operations, permission required for commands. Balances speed and safety.

Skip Permission Mode

Full autonomy for isolated environments. No permission prompts for anything.

Plan Mode

Read-only planning mode. Review complete plan before execution begins.

Execution Modes

  • Manual Accept Mode
  • Auto-Run Mode
  • Skip Permission Mode
Manual Accept Mode is the default execution mode that provides control over file modifications and command execution.Automatic Operations:
  • File reading and code analysis
  • Directory browsing
Requires Permission:
  • File editing (create, modify, delete)
  • Command execution (terminal commands, tests, builds)
When Verdent needs to perform a protected operation, it shows what action it wants to take and which file/command is involved. You can Accept or Reject each operation.Important: Each permission is for that specific operation only. Manual Accept Mode requires approval for every protected operation throughout the session.

When to Use

  • Learning Verdent’s capabilities and workflow patterns
  • Working in unfamiliar codebases requiring careful oversight
  • Critical changes to production code or security-sensitive areas
  • Compliance requirements needing explicit approval trails

Activation

Manual Accept Mode is active by default. To switch back:
1

Open Permission Menu

Click “Switch Permission” button in Input Box
2

Select Manual Accept Mode

Choose “Manual Accept Mode” from the dropdown
3

Verify Activation

Button displays “Manual” to confirm mode is active

Safety Considerations

Advantages:
  • First-use approval per tool type (file edits, commands, tools)
  • Complete visibility before granting access
  • Maximum control and transparency
Limitations:
  • After first approval of a tool type, subsequent uses proceed without prompts
  • Approval is per tool type, not per operation
  • Start new sessions when working on critical code to reset tool approvals

Plan Mode

Plan Mode is a read-only interaction mode where Verdent analyzes code, creates detailed plans, and asks clarifying questions, but cannot modify files or execute commands until you approve.

How It Works

  1. Analysis - Reads files automatically
  2. Planning - Creates structured plan with todo list
  3. Clarification - Asks questions to remove uncertainty
  4. Approval - You review and decide to proceed
  5. Execution - Switches to your permission mode to execute
Plan shows files to modify, implementation steps, dependencies, and verification strategy.

When to Use

  • Complex multi-file changes (understand scope before committing)
  • Unfamiliar codebases (safe exploration without risk)
  • Architectural decisions (review approach before implementation)
  • Avoiding Manual Accept fatigue (review once vs 50 individual prompts)
  • High-stakes production changes (full visibility before execution)

Activation

1

Open Mode Menu

Click “Switch Mode” button in Input Box
2

Select Plan Mode

Choose “Plan Mode” from the dropdown
3

Verify Activation

Mode indicator changes to “Plan” to confirm mode is active
When active, Verdent analyzes and creates plans but won’t modify files or execute commands until you approve. After approval, switches to your default permission mode (Manual Accept or Auto-Run).

Safety Considerations

Advantages:
  • Zero execution risk during planning
  • Full visibility before committing
  • Interactive clarification removes uncertainty
  • Safe for production analysis
Limitations:
  • Approval doesn’t guarantee correctness (plans can have logical errors)
  • Execution safety depends on chosen permission mode after approval
  • Plan quality depends on prompt clarity
Best Practices:
  • Review plans for logical errors or misunderstandings
  • Ask follow-up questions if unclear
  • Refine prompts before approving execution
  • Consider which permission mode will execute (Manual Accept for oversight, Auto-Run for speed)

Think Hard Mode

Think Hard Mode allocates maximum computational resources for complex reasoning tasks. The model explores multiple approaches and provides more thorough solutions. Characteristics:
  • Extended reasoning time
  • Deeper analysis of multiple solution approaches
  • Better handling of complex logic, edge cases, architectural decisions
  • Higher credit cost per request

When to Use

Use Think Hard Mode ForDon’t Use For
Complex architectural decisions with multiple trade-offsSimple, straightforward tasks
Sophisticated debugging with multiple potential causesTime-sensitive requests
Algorithm design requiring optimization analysisLimited credit budget
Critical business logic where correctness is paramountWhen standard mode is adequate
Performance optimization of complex bottlenecks

Activation

  • Think Hard Button
  • Natural Language (Claude)
Use the UI button for per-request activation:
1

Enable Think Hard

Click “Think Hard” button/toggle in Input Box
2

Submit Your Prompt

Type and submit your request
3

Single Request Only

Applies to that specific request only - not persistent
Works with all AI providers. Not persistent - must activate each time for requests requiring deep reasoning.

Mode Comparison

ModeControlSpeedBest ForAvoid When
Manual AcceptMaximumSlowestLearning, unfamiliar code, critical changesTrusted projects, rapid iteration
Auto-RunModerateFastTrusted codebases, prototyping, multi-file workUnfamiliar code, no version control
Skip PermissionNoneFastestCI/CD, disposable containers, sandboxesProduction, important code
Plan ModeReview-FirstN/AComplex changes, architectural decisionsSimple tasks
Think HardPer-RequestSlowerComplex reasoning, algorithms, critical logicSimple tasks, time-sensitive

When to Use Each Mode

ScenarioManual AcceptAuto-RunSkip PermissionPlan Mode
Learning Verdent
Unfamiliar codebase
Trusted codebase with Git
Critical/production code
Rapid prototyping
Multi-file refactoring
Complex architectural planning
CI/CD pipelines (isolated)
Disposable containers
Compliance requirements

Safety Best Practices

Understanding the safety ranking of each mode helps you choose appropriately for different risk levels.
  1. Plan Mode - Read-only until approved. Zero execution risk during planning.
  2. Manual Accept Mode - Per-operation control with first-use approval per tool type.
  3. Auto-Run Mode - File autonomy with command approval. Git safety net required.
  4. Skip Permission Mode - Full autonomy. Isolated environments only.
Match your mode to the risk level: critical code uses safest modes (Plan, Manual Accept), trusted code uses faster modes (Auto-Run), disposable environments use fastest mode (Skip Permission).
Essential practices that apply regardless of which execution mode you’re using.For All Modes:
  1. Use Version Control - Initialize Git before using permissive modes, commit frequently, review diffs before committing
  2. Write Clear Prompts - Be specific about scope, specify file boundaries explicitly, use @-mentions for context
  3. Review Before Committing - Check Source Control panel after completions, review all diffs carefully, test changes
  4. Start Fresh Sessions - Clear context between major tasks, reset tool approvals for sensitive work, avoid context contamination
  5. Match Mode to Risk - Critical code → Manual Accept or Plan Mode, trusted code → Auto-Run, experiments → Auto-Run with Git, disposable → Skip Permission only
Security Reminders:
  • Never commit sensitive files (.env, credentials)
  • Configure .gitignore before using Auto-Run
  • Review command permissions carefully
  • Use Plan Mode for changes affecting security
  • Fresh sessions reset tool approvals in Manual Accept
Understanding how Verdent’s permission system works helps you use it effectively.How it works:
  1. First use - System requests permission when you first use each tool type (file edits, command executions, tool usage)
  2. Subsequent uses - After initial approval, that tool type proceeds without prompts for the rest of the session
  3. New session - Starting a new session resets all approvals, allowing you to start fresh
Key principle: This model balances security with productivity. You review and approve tool types once, then work efficiently within that approval context. For sensitive work, start a new session to reset approvals.To reset approvals: Start a new session

See Also