Launching Agents

Stop copy-pasting task descriptions into ChatGPT. Stop re-explaining context every time you want AI help. With Valdr, you click Launch and an agent picks up the task with everything it needs: description, acceptance criteria, linked requirements, checklist state, and project context. You don’t prompt. You delegate.

All agent sessions run locally within your workspace and are recorded for inspection.

7 sessions across multiple providers—launch more, compare results, and know exactly what happened

What this page covers

• Where to launch agents
• Provider presets (one-click configurations)
• Full configuration options
• Session monitoring and comparison
• Best practices for task, review, and audit workflows

Two launch points: speed or control

Quick launch (Overview sidebar)

From the task sidebar, you’re always one click away:

1. Select a preset
2. Click Launch
3. Work on something else

The agent inherits everything. No prompting, no copy-paste, no context re-establishment. This is what “delegation” actually means.

Full control (Agent Sessions tab)

Need to tweak settings for this specific run? The Agent Sessions tab gives you the full provider controls:

• See all past sessions before launching another
• Configure every parameter inline
• Compare provider/model performance before choosing

Use this when you want to experiment with different models or adjust reasoning effort.

Provider presets: your playbook

Provider presets are pre-configured agent setups that encode your best practices. Instead of configuring from scratch every time, you codify what works once and reuse it consistently.

What presets capture

Example presets

• Coder – Claude — Native Claude for implementation tasks
• Codex — OpenAI’s Codex for code-heavy work
• OpenCode — Models, agents, and variants from your existing OpenCode setup
• Ollama Local — On-premise execution for sensitive codebases

Each shows its provider icon so you can identify them at a glance.

Configuration deep dive

When you need precise control, every parameter is at your fingertips:

Agent handle

The registered agent identity (@documentation-author, @code-reviewer):

• Determines which system prompts load
• Links to agent capabilities and permissions
• Defines the “personality” and expertise of the session

Role

What function the agent performs on this task:

The role shapes how the agent approaches the task. A reviewer reads code critically; a task agent writes it confidently.

Provider and Model

Choose your AI backend and specific model:

• Codex — Native Codex sessions with your configured models
• Claude — Native Claude sessions with your configured models
• OpenCode — Models configured in OpenCode, including Gemini, OpenAI, and Anthropic providers
• Ollama — Local models (Llama, Mistral) for air-gapped environments

OpenCode’s optional model selector uses provider/model; authentication, agents, plugins, and project configuration come from OpenCode. See OpenCode configuration.

Valdr 0.3.4 removes the direct Gemini, OpenAI API, and Anthropic API providers. Existing presets for those providers must be replaced with OpenCode presets; they are not automatically converted. Update affected agent and workflow selections too.

Different tasks benefit from different models. Run a complex architecture spike on a more capable model; run a simple bug fix on a local model. You’re not locked in—you choose the right tool for each job.

Temperature

Control the creativity-consistency tradeoff:

Default: 0.2 for code tasks. Predictable output beats surprising output when shipping features.

Reasoning effort

Choose Use preset/default to inherit your provider’s effort setting. An explicit selection overrides it for this run:

• Claude: low, medium, high, xhigh (Extra high), max.
• Codex: the same levels, plus ultra.

The selected model and provider runtime must support the requested effort. Invalid values produce a launch error instead of being silently ignored. Changing the provider or preset clears the explicit selection so the new preset’s setting can apply.

For OpenCode, the provider shows the preset’s Variant instead of reasoning effort. Configure an optional variant in Settings using a selector supported by your OpenCode setup.

Instructions

Add context specific to this run:

• Clarify ambiguous requirements
• Specify coding conventions
• Request particular approaches
• Point out edge cases to consider

Instructions compound with the task description. The agent sees both—use instructions for “this session only” guidance.

Worktree

Toggle isolated git branches:

With worktree enabled, agents can:

• Make commits without touching your main branch
• Generate diffs for easy review
• Create pull requests when done

This is how you isolate reviewable changes. Worktrees keep agent changes off your active branch while you inspect them. They are a workflow boundary, not an OS sandbox.

What happens when you click Launch

You don’t babysit. Launch, work on something else, come back to results.

Session history: full visibility into what agents did

Every session is recorded. No black boxes, no “what did the AI do?” mysteries.

Session card at a glance

Each session shows:

• Session ID — Click for full transcript
• Role badge — task, reviewer, or auditor
• Status — Running (green pulse) or Closed (checkmark)
• Provider — Which AI backend
• Duration — Total execution time
• Time — When it ran

Expand for details

Click the chevron to see:

• Full session ID
• Token breakdown (input, output, cached)
• Tool call count
• Commands executed

Full session view

Click View session to open the complete Agent Sessions detail page—full transcript, every tool call, complete local audit trail.

Session comparison: optimize your agent strategy

The analytics panel answers: “Which provider/model works best for this kind of task?”

Metrics you can compare

Group by Provider, Model, or Role

Segment the chart to understand patterns:

• Provider — Is Codex faster than Claude for this task type?
• Model — Does Opus outperform Sonnet enough to justify the cost?
• Role — How do reviewer sessions compare to task sessions?

This is how you build intuition. Run experiments, see results, adjust your presets.

Workflows that ship

Task implementation (the common path)

1. Open task, verify description and acceptance criteria look right
2. Select your task preset (e.g., “Coder – Claude”)
3. Click Launch
4. Work on something else or watch in real-time
5. When closed, review the output
6. Launch a reviewer session to verify

Time to first agent result: under 30 seconds.

Code review (quality gate)

1. After task session completes, click Launch again
2. Select a reviewer preset
3. The reviewer sees the task context AND the changes made
4. Review feedback appears in the Reviews tab with structured findings

Catch issues before they ship. Reviewer agents don’t rubber-stamp—they find real problems.

Quality audit (compliance check)

1. Before marking a task Done, launch an auditor session
2. Auditor verifies against acceptance criteria
3. Structured pass/fail assessment with specific findings

Prove your work meets the spec. Auditable, documented, defensible.

When things go wrong

Session won’t start

• Check provider configuration in Settings
• Verify the provider’s authentication; for OpenCode, check its executable version and native authentication
• Ensure agent handle exists in registry

Session runs too long

• Use a smaller model for simple tasks
• Add clearer instructions to focus the agent
• Reduce max tokens if output is unnecessarily verbose

Output quality is poor

• Bump reasoning effort to high
• Add more specific instructions
• Try a more capable model
• Review and improve the task description itself

The fix is usually context. Better input = better output.

The result: delegation that actually works

Traditional AI assistance means you do the work of prompting, context-gathering, and result-wrangling. With Valdr agent launching:

• Context is automatic — No copy-paste, no re-explaining
• Configuration is reusable — Presets encode your best practices
• Execution is observable — Every session logged, every action traceable
• Iteration is safe — Worktrees isolate experiments from production

This is the difference between “using AI” and operating AI at scale.

Next steps

• Agent Sessions — Deep dive into session management
• Settings > Provider Packs — Create custom provider presets
• Agents — Manage your agent registry

Launch your first agent now. Open a task, select a preset, click Launch. In 30 seconds you’ll see why developers don’t go back to copy-pasting into ChatGPT.