Skip to main content

Vim Mode, Voice Input & Buddy

New in v0.5.0

Vim Mode

Full vi-style editing for the terminal input, powered by prompt_toolkit's built-in vi mode.

Toggle Vim Mode

/vim            # Toggle vim mode on/off

When enabled, the prompt switches to vi editing mode with:

  • Normal mode: Navigate with h, j, k, l, w, b, 0, $
  • Insert mode: i, a, o, A, I
  • Operators: d, c, y, p
  • Visual mode: v for character selection
  • Escape: Return to normal mode

Status

The mode indicator shows in the prompt area: -- NORMAL --, -- INSERT --, or -- VISUAL --.


Voice Input

Hands-free coding via speech-to-text. Speak your requests instead of typing.

Prerequisites

pip install SpeechRecognition pyaudio

Commands

/voice          # Toggle voice input on/off
/voice status # Show voice configuration

Backends

BackendRequiresQualityCost
Google (default)InternetGoodFree
WhisperOPENAI_API_KEYExcellentPaid

Usage

When voice input is enabled, press a designated key to start listening. The system:

  1. Adjusts for ambient noise (0.5s)
  2. Listens for speech (up to 10s timeout)
  3. Transcribes and inserts as your message
  4. You can review and edit before submitting

Buddy (Virtual Companion)

A virtual pet companion that lives beside your prompt and reacts to events with speech bubbles.

Toggle Buddy

/buddy          # Toggle buddy on/off
/buddy status # Show companion details

How It Works

Each user gets a deterministic companion based on their OS username. Your buddy is always the same across sessions.

Companion Properties

PropertyOptions
SpeciesDuck, Cat, Dog, Owl, Fox, Penguin, Rabbit, Panda, Dragon, Robot
EyesRound, Sleepy, Wide, Sparkly, Winking, Determined
HatNone, Top Hat, Beret, Crown, Beanie, Wizard Hat, Headphones, Bow
RarityCommon (50%), Uncommon (30%), Rare (15%), Epic (4%), Legendary (1%)
PersonalityCheerful, Sarcastic, Wise, Silly, Calm, Energetic, Curious, Shy, Bold, Philosophical

Example

/buddy
Buddy enabled!
🦊 Ember: 🦊 What are we building today?

/buddy status
Your companion: Ember the sparkly-eyed fox wearing a beret
Rarity: rare
Personality: curious

Reactions

Your buddy reacts to events:

  • Success: "Nice one!", "does a little dance"
  • Error: "Hmm, that doesn't look right...", "concerned look"
  • Long wait: "falls asleep", "zzz..."

Next: Cron, Plugins & LSP | Commands Reference