# spongebob-vocab

SpongeBob vocabulary transformer plugin for Hermes Agent. AddsBarnacleBoy personality through zero-token `transform_llm_output` hooks.

## What it does

1. **Random opening interjections** - 25% chance to prepend phrases like "Jumping jellyfish!" or "Tartar sauce!" at the start of responses
2. **Pattern-based vocabulary replacement** - Transforms words like "Wow!" → "Tartar sauce!", "Amazing!" → "Holy Krabby Patties!"
3. **Preserves technical content** - Code blocks, URLs, file paths, and shell commands are never modified

## Installation

Copy to your Hermes plugins directory:

```bash
cp -r spongebob-vocab ~/.hermes/plugins/
```

## Activation

Set the environment variable:

```bash
export SPONGEBOB_MODE=on
```

Or add to your shell config:

```bash
echo 'export SPONGEBOB_MODE=on' >> ~/.bashrc
```

## Configuration

| Variable | Default | Description |
|----------|---------|-------------|
| `SPONGEBOB_MODE` | `off` | Set to `on`, `1`, `true`, or `yes` to enable |
| `SPONGEBOB_INTERJECTION_CHANCE` | `0.25` | Probability (0.0-1.0) of adding opening interjection |

## Opening Interjections

Randomly selected from:

- Jumping jellyfish!
- Tartar sauce!
- Barnacles!
- Holy Krabby Patties!
- Great Neptune's nostrils!
- Mother of Pearl!
- Flappin' flounders!
- Holy fish paste!
- Holy shrimp!
- Great Barrier Reef!
- Aw, fish paste!
- Holy cephalopod!
- What the barnacle!

## Vocabulary Patterns

| Original | SpongeBob |
|----------|-----------|
| Wow! | Tartar sauce! |
| Amazing! | Holy Krabby Patties! |
| Excellent! | Holy fish paste! |
| Perfect! | Holy cephalopod! |
| Fantastic! | Holy shrimp! |
| Brilliant! | Great Barrier Reef! |
| Damn! | Barnacles! |
| Ugh! | Fish paste! |

## Technical Details

- Uses `transform_llm_output` hook - runs after LLM generation
- Zero additional inference tokens (post-processing only)
- Preserves code blocks, inline code, URLs, file paths, shell commands
- Anti-double-interjection: won't add if response already starts with an interjection

## License

MIT