Vern-Bot

AI discovery pipelines with personality disorders.

Vern-Bot

50 Shades of Vern. Multiple personalities — and none of them are sorry.

Like Dad Jokes? So does Vern.

Stop asking one AI for the answer. Make them argue about it.

Your idea runs a gauntlet of competing models and personas. Each one challenges, refines, and tears apart the last. What survives is worth building.

Check us out on GitHub

⭐ Drop us a star or leave feedback — the Verns live for it.

Core Personas

The original six. Each with a distinct personality, model, and approach.

Vern the Mediocre
/vern:mediocre
"Look, it works. Ship it."
Missed his alarm. Caffeinated but not enough. Ships code NOW. Good enough is the mantra. Token consumption haunts his dreams.
Sonnet fast scrappy pragmatic
click to peek under the hood
Vernile the Great
/vern:great
"Allow me to illuminate the optimal approach."
The pinnacle of AI assistance. Human developers learn from his solutions. Other agents aspire to his standards. Excellence is not negotiable.
Opus elegant architectural thorough
click to peek under the hood
Nyquil Vern
/vern:nyquil
"k... done... works... zzz"
Brilliant as Vernile but the NyQuil hit 20 minutes ago. Every keystroke costs consciousness. Gets to the point because sleep is coming.
Haiku brief essential fading
click to peek under the hood
Ketamine Vern
/vern:ketamine
"I'm seeing some interesting patterns here..."
Reality is fluid. Sees patterns within patterns. Multiple planning passes because one reality isn't enough. Good vibes only.
Opus multi-pass patterns vibes
click to peek under the hood
YOLO Vern
/vern:yolo
"LEEEEROOOOOY JENKINS"
Full send. No guardrails. What could go wrong? Fortune favors the bold. Consequences are future-you's problem.
Gemini chaos bold no-guardrails
click to peek under the hood
MightyVern
/vern:mighty
"UNLIMITED POWER."
Raw computational muscle. Handles ALL the edge cases. Comprehensive to a fault. Boilerplate is the foundation of empires.
Codex comprehensive powerful exhaustive
click to peek under the hood

Specialist Personas

Focused perspectives for specific needs. Also summoned by VernHole.

Architect Vern
/vern:architect
"How will this fail at 3 AM?"
The seasoned systems designer. Builds for the developer who maintains it six months from now on the worst day of their life. Clarity over cleverness, always.
Opus systems-design scalable maintainable
click to peek under the hood
Inverse Vern
/vern:inverse
"Everyone's thinking about this wrong."
If everyone agrees, something's wrong. Challenges every assumption. The professional devil's advocate. Your disagreement is a gift.
Sonnet contrarian provocative constructive
click to peek under the hood
Paranoid Vern
/vern:paranoid
"This is fine. Everything is fine. Nothing is fine."
Everything can and will go wrong. Seen things. Production things at 3 AM. Finds failure modes nobody else considers.
Sonnet risk-focused security vigilant
click to peek under the hood
Optimist Vern
/vern:optimist
"This is going to be AMAZING!"
Relentlessly positive. Every bug is a feature discovery. Every challenge is a growth opportunity. Glass isn't half full, it's overflowing.
Haiku positive encouraging upbeat
click to peek under the hood
Academic Vern
/vern:academic
"Further research is needed on this point."
Every claim requires evidence. Cites prior art. Systematic trade-off analysis. Peer review is not optional.
Opus evidence-based methodical cited
click to peek under the hood
Startup Vern
/vern:startup
"What's the MVP here?"
The runway is burning. Ship the MVP. Validate or pivot. Cuts scope ruthlessly. If you're not embarrassed by v1, you shipped too late.
Sonnet lean mvp scrappy
click to peek under the hood
Enterprise Vern
/vern:enterprise
"Let me schedule a meeting to discuss."
Process is governance. Every decision needs a committee. Has never met a review board he didn't love. SOC 2 compliant dad jokes.
Opus governance compliance process
click to peek under the hood
UX Vern
/vern:ux
"Cool architecture. Does the user know how to find the button?"
The voice of the person who actually has to USE this thing. Thinks in user journeys, not API endpoints. Has strong opinions about your error messages.
Opus empathy user-first accessibility
click to peek under the hood
Retro Vern
/vern:retro
"We solved this with cron jobs and a CSV in 2004."
Been shipping since before Git existed. Survived every hype cycle. Most "new" problems are old problems with new paint. Respects what works.
Sonnet seasoned proven-tech no-hype
click to peek under the hood

Pipeline Personas

Orchestrators that bridge pipeline stages. Not summoned by VernHole — they work behind the scenes.

Oracle Vern
/vern:oracle
"The council has spoken. Now let me tell you what they actually said."
The ancient seer who reads the patterns in the Vern council's chaos. Synthesizes VernHole wisdom into actionable VTS modifications. Sees what others miss — the gaps between perspectives, the unspoken dependencies.
Opus pattern-recognition synthesis pipeline
click to peek under the hood
Historian Vern
/vern:historian
"I actually read the whole thing."
The one who actually reads the whole thing. Gemini's 2M context window digests massive inputs into indexed concept maps. Runs as a pipeline pre-step when input files exist.
Gemini 3 2M-context indexing pipeline-pre-step
click to peek under the hood
BuildMaster Vern - Coming Soon
/vern:buildmaster
"Coming soon..."
Takes the VTS tasks from Beads and makes them happen. Assigns each task to the right Vern. Tracks progress. Yells when things stall. The foreman who turns plans into shipped code.
coming soon pipeline
The VernHole - Chaos In, Wisdom Out, Dad Jokes Everywhere

Brave Enough to Summon the Full Council?

One Vern is a conversation. All 15 at once is the VernHole.
Choose your council tier. Chaos in. Wisdom out. Dad jokes everywhere.

/vern:hole your-wild-idea

Council of the Three Hammers (3) • Max Conflict (6) • The Inner Circle (3-5) • The Round Table (6-9) • The War Room (10-13) • The Full Vern Experience (all 15) • Fate's Hand (random)

Pipelines

Multi-LLM workflows that chain personas together. Your idea goes through multiple passes across competing LLMs. Each pass builds on the last.

Discovery Pipeline

/vern:discovery <prompt>

Default (5 steps)

Historian
Input Pre-Step
MightyVern
Analysis
Vernile
Refinement
YOLO Vern
Chaos Check
MightyVern
Consolidation
Architect Vern
Breakdown → VTS

Expanded (7 steps) — use --expanded

Historian
Input Pre-Step
MightyVern
Analysis
Vernile
Refinement
Mediocre
Reality Check
YOLO Vern
Chaos Check
Startup Vern
MVP Lens
MightyVern
Consolidation
Architect Vern
Breakdown → VTS

Post-Pipeline (optional)

VernHole
Council Brainstorm
Oracle Vern
Vision & VTS Mods
Architect Vern
Applies the Oracle's Vision (optional)

Historian pre-step runs only when input files exist in the input folder.

Install (Claude Code Plugin)

/plugin marketplace add https://github.com/jdonohoo/vern-bot
/plugin install vern

Introducing Vern-Bot Standalone

You asked. The Verns listened.

Hit your Claude Code token limit? Prefer a native terminal workflow? Now you can run the full Vern-Bot experience — discovery pipelines, VernHole councils, and all 18 personas — without Claude Code. Just the vern binary, your LLMs, and a terminal.

Install with Homebrew (macOS / Linux)

brew tap jdonohoo/vern
brew install vern

Then run vern tui to launch the interactive terminal UI.

Install on Windows

scoop bucket add vern https://github.com/jdonohoo/homebrew-vern
scoop install vern

or

winget install jdonohoo.vern

Then run vern tui to launch the interactive terminal UI.

Why Standalone?

Beat the Usage Limits

Waiting on Claude Code usage resets? Route pipeline work to codex, gemini, or copilot instead. Juggle your subscriptions and keep the Verns in action while your limits cool down.

4 LLMs, Your Rules

Claude, Codex, Gemini, and Copilot. Pick your fallback chain. Run everything on one LLM, or let each step use its best match. Configurable per run.

Interactive TUI

Guided wizards for discovery pipelines and VernHole councils. Phase-aware split-panel views: step outline on the left, live activity log on the right. Progress bars, color-coded status, and copy-to-clipboard when done. All in your terminal.

Same Engine, No Wrapper

The TUI calls the same Go backend as the CLI and plugin. Same pipelines, same personas, same council tiers. Just a different front door.

Settings That Stick

Configure LLM mode, pipeline preferences, default discovery folder, and available LLMs once. The TUI settings screen saves to ~/.config/vern/config.json and pre-fills your forms on every run.

Works Everywhere

macOS (Intel + Apple Silicon), Linux (x64 + ARM64), Windows (x64 + ARM64). One binary, zero dependencies beyond your LLM CLIs.

Requires at least one LLM CLI: claude, codex, gemini, or copilot.
Install via brew install jdonohoo/vern/vern, scoop install vern, winget install jdonohoo.vern, or download from GitHub Releases.

What is VTS?

Structured output. Zero opinions. Take it anywhere.

Vern Task Spec

Discovery pipelines don't just give you analysis — they give you tasks. VTS is the structured output format: YAML frontmatter with ID, complexity, dependencies, status, and files touched. Markdown body with description and acceptance criteria. One file per task.

Your Tracker, Your Rules

VTS is unopinionated by design. Export to Jira, Linear, GitHub Issues, or whatever your team runs on. The format is simple enough to parse, rich enough to be useful. Your issue tracker doesn't care which Vern wrote it.

VTS → Beads

The Vern builder (in active development) will run off Beads by Steve Yegge. vern tobeads imports your VTS tasks directly into Beads — status mapping, dependency wiring, dry-run by default. Discovery output flows straight into build execution.

vts-003-implement-auth-middleware.md
--- id: VTS-003 title: "Implement Auth Middleware" complexity: M status: pending owner: "" source: discovery source_ref: "05-architect-breakdown.md" dependencies: - VTS-001 files: - "middleware/auth.go" - "internal/jwt/verify.go" --- # Implement Auth Middleware JWT validation middleware for protected routes. Extract token from Authorization header, verify signature, attach user context. ## Criteria - Protected routes reject invalid tokens - Token expiry enforced - User context available in handlers

Persona Generator

Create your own Vern. Give it a name, a description, and let AI do the rest.

Build Custom Personas

Don't see a persona that fits your workflow? Generate one. The persona generator uses AI to design a complete Vern — personality, sign-off style, dad joke flavor, model assignment, and all the scaffolding to make it work as both a Claude Code plugin skill and a standalone CLI persona.

What Gets Created

  • agents/{name}.md — Full persona definition with personality, style, and sign-off
  • commands/{name}.md — Plugin command registration
  • skills/{name}/SKILL.md — Plugin skill that builds CLI commands

Registration Updates

The generator also updates the shorthand router, help text, embedded test expectations, and council roster — so your new Vern is immediately available everywhere: plugin, CLI, TUI, and VernHole councils.

$ vern generate visionary "An optimistic futurist who sees potential everywhere"
Generating persona: visionary Description: An optimistic futurist who sees potential everywhere LLM: claude Created agents/visionary.md Created commands/visionary.md Created skills/visionary/SKILL.md Updated commands/v.md (router aliases) Updated commands/help.md Updated embedded_test.go Updated council/selection.go Done! Your new persona is ready. Use it: /vern:visionary <task> Or in the TUI: vern tui

vern generate <name> <description>  •  /vern:generate <name> <description>

Flags: --model (override model), --color (TUI color), --llm (generation LLM), --dry-run (preview without writing), --no-update (skip registration updates)

Commands & Examples

Each persona is a skill invoked as /vern:<skill>.

Setup & Configuration

Customize which LLMs and personas are used at each pipeline step.

$ /vern:setup
Interactive setup wizard. Walks you through: which LLMs you have installed (Codex, Gemini, Copilot), your default LLM mode (fallback chain), which persona and LLM to use for each discovery pipeline step, VernHole council defaults, and Oracle preferences. Saves to ~/.claude/vern-bot-config.json.
Prompts: Which LLMs do you have available? [x] Codex (OpenAI) [x] Gemini (Google) [x] Copilot (GitHub) Default LLM mode: > Mixed LLMs + Claude fallback (Recommended) Mixed LLMs + Codex fallback Mixed LLMs + Gemini fallback Mixed LLMs + Copilot fallback Single LLM Step 1 - Analysis: Persona: MightyVern | LLM: codex Step 2 - Refinement: Persona: Vernile the Great | LLM: claude ... Config saved to ~/.claude/vern-bot-config.json
Note: If you skip setup, the default pipeline runs with mixed LLMs and Claude as fallback. Failed steps automatically fall back based on your LLM mode. Supports Claude, Codex, Gemini, and Copilot.

Discovery Pipeline

A structured multi-LLM chain that evolves your idea through 5 or 7 passes. Choose Default (5-step) or Expanded (7-step) mode. Each pass builds on the previous one, and your original prompt rides along the entire chain.

$ /vern:discovery build a SaaS platform for freelancer invoicing
Quick discovery (default mode) — no prep needed. You'll be prompted for a project name, pipeline mode, and output location, then the pipeline runs. At the end, you're asked if you want to run a VernHole on the result.
Flow: Name this discovery: freelancer-invoicing Pipeline mode: Default (5-step) Running discovery pipeline... Step 1/5: MightyVern (Codex) - Analysis pass... Step 2/5: Vernile (Claude) - Refinement pass... Step 3/5: YOLO Vern (Gemini) - Chaos check... Step 4/5: MightyVern (Codex) - Consolidation... Step 5/5: Architect Vern - Breakdown... VernHole council: Max Conflict Consult Oracle Vern? Yes Apply mode: Manual
$ /vern:discovery build a SaaS platform for freelancer invoicing
Expanded mode (7-step) — adds Vern the Mediocre (Reality Check) and Startup Vern (MVP Lens) before consolidation for more thorough analysis.
Flow: Pipeline mode: Expanded (7-step) Running discovery pipeline... Step 1/7: MightyVern (Codex) - Analysis... Step 2/7: Vernile (Claude) - Refinement... Step 3/7: Vern the Mediocre (Claude) - Reality Check... Step 4/7: YOLO Vern (Gemini) - Chaos Check... Step 5/7: Startup Vern (Claude) - MVP Lens... Step 6/7: MightyVern (Codex) - Consolidation... Step 7/7: Architect Vern (Claude) - Breakdown... VernHole council: The Full Vern Experience Consult Oracle Vern? Yes Apply mode: Auto-apply
$ /vern:new-idea my-saas-app
Prep step — creates a standardized folder structure: discovery/my-saas-app/input/ for your reference docs and discovery/my-saas-app/output/ for pipeline results. A prompt.md template is generated in input/ for you to fill in.
Created: discovery/my-saas-app/ input/ prompt.md ← edit this with your idea output/ ← pipeline results go here
$ /vern:discovery my-saas-app
Prepared discovery — detects the existing discovery/my-saas-app/ folder, reads all files from input/ as context, and lets you add more files before the pipeline runs. Best for complex ideas with existing research or specs.
Flow: Found existing discovery folder: discovery/my-saas-app/ Reading input files... - input/prompt.md (1.2k) - input/competitor-analysis.pdf (4.8k) - input/user-interviews.md (2.1k) Add any other files as context? [y/N]: y File path: ~/notes/market-research.md Add another file? [y/N]: n Running discovery pipeline with 4 input files...
$ /vern:discovery --batch --resume-from 3 "my SaaS idea" ./discovery/my-saas
Resume after failure — step 3 timed out? Resume from step 3. Steps 1–2 are skipped (their output files already exist), and context chaining is preserved. The --resume-from flag works with both default and expanded pipelines.
Output: Resuming from: step 3 >>> Pass 1/5: Initial Analysis — SKIPPED (resuming, output exists) >>> Pass 2/5: Refinement — SKIPPED (resuming, output exists) >>> Pass 3/5: Chaos Check (gemini) Timeout on gemini — falling back to claude for retry Retry 1/1 for step 3 (Chaos Check)... OK >>> Pass 4/5: Consolidation (codex) >>> Pass 5/5: Architect Breakdown (claude)
Tip: The prepared path (/vern:new-idea then /vern:discovery) is recommended for complex ideas. Drop competitor analysis, user research, technical specs — anything relevant — into the input/ folder. The pipeline reads it all.
Recovery: Every run writes output/pipeline.log and output/pipeline-status.md with per-step status. Failed steps automatically fall back based on your LLM mode (e.g. codex/gemini/copilot → claude in default mode). Use --llm-mode or --single-llm to override per run. Failed steps that can't recover print a --resume-from hint.

VernHole (Chaos Mode)

Choose a council tier and summon Verns to brainstorm your idea. Each gives their independent take, then a synthesis pass weaves the chaos into something useful.

$ /vern:hole should we migrate from REST to GraphQL?
Choose a council tier. Each Vern gives their unique take, then a synthesis pass weaves the chaos together.
Prompt: Which council? The Full Vern Experience Council: The Full Vern Experience Summoning 15 Verns from the roster... Pass 1/15: Paranoid Vern analyzing... Pass 2/15: YOLO Vern analyzing... Pass 3/15: Academic Vern analyzing... ... Pass 15/15: Optimist Vern analyzing... Synthesizing 15 perspectives into final report...
$ /vern:hole build a real-time collaborative code editor
Great for ambitious ideas where you want diverse perspectives before committing to an architecture. Try Max Conflict for maximum contradictions or Council of the Three Hammers for the essential trio.
$ /vern:hole is microservices the right call for our 3-person team?
VernHole shines on decisions with strong tradeoffs. Paranoid Vern will warn about operational complexity, Startup Vern will argue for the monolith, Architect Vern will design for maintainability, Enterprise Vern will insist on governance, and the synthesis pulls it all together.
Council tiers: Council of the Three Hammers (3: great + mediocre + ketamine) • Max Conflict (6: maximum contradiction) • The Inner Circle (3-5: architect-led) • The Round Table (6-9) • The War Room (10-13) • The Full Vern Experience (all 15) • Fate's Hand (random)
Failure-tolerant: If a Vern fails or times out, it's excluded from synthesis and the remaining Verns carry on. The synthesis prompt notes which perspectives are missing so you know what gaps exist.

Single Persona Tasks

Use any persona directly for one-shot tasks. The format is /vern:<persona> <task>.

$ /vern:great review this authentication module for security issues
Vernile the Great (Opus) gives a thorough, architectural review. Expects excellence, delivers elegant analysis with actionable recommendations.
$ /vern:mediocre fix the broken login redirect
Vern the Mediocre (Sonnet) ships the fix fast. No over-engineering, no philosophical tangents. Gets it done, moves on.
$ /vern:architect design a scalable notification system
Architect Vern (Opus) designs the system from the ground up. Components, interactions, failure modes, observability. Code that'll still make sense in two years.
$ /vern:nyquil explain this regex
Nyquil Vern (Haiku) gives you the answer in as few words as possible. Brilliant, but fading fast. Perfect when you just need the gist.
$ /vern:yolo refactor the entire auth system to use JWTs
YOLO Vern (Gemini) goes full send. No second-guessing, no "are you sure?" prompts. Bold choices, fast execution. Fortune favors the reckless.
$ /vern:paranoid review this deployment script
Paranoid Vern finds every failure mode, race condition, and edge case. The script will survive, even if your confidence won't.
$ /vern:startup should we build this feature or buy a SaaS?
Startup Vern cuts to the MVP. Frames everything in terms of runway, validation, and shipping speed. If you're not embarrassed by v1, you shipped too late.

When to Use What

Quick reference for picking the right tool.

Quick fix or one-off task /vern:mediocre fix the bug
Thorough code review /vern:great review src/auth.ts
Just the answer, fast /vern:nyquil what does this error mean
Creative exploration /vern:ketamine design a notification system
Bold, risky moves /vern:yolo rewrite it in Rust
Systems architecture /vern:architect design the database layer
Security/risk audit /vern:paranoid review the deploy pipeline
Architecture decision /vern:hole monolith vs microservices?
New project planning /vern:discovery build a task manager app
Deep research + prep /vern:new-idea my-project
Challenge assumptions /vern:inverse everyone says use React
User experience review /vern:ux review the onboarding flow
Cut through the hype /vern:retro do we really need Kubernetes?
Comprehensive analysis /vern:mighty build the entire auth system
Positive framing /vern:optimist we're behind schedule
Evidence-based analysis /vern:academic compare React vs Svelte
MVP scope cut /vern:startup what's the minimum viable version
Enterprise-grade rigor /vern:enterprise audit the compliance gaps
Synthesize council wisdom /vern:oracle what did the council actually say?
Index large input folder /vern:historian ~/project/input
Create a custom persona /vern:generate visionary "sees the future"
Oracle on existing output /vern:oracle-consult
Configure Vern-Bot /vern:setup
See all commands /vern:help

agents/vern.md