OPIT Companion

Your Tiny Coding Companion
A lively, reactive pixel-art companion that lives inside your code editor, reacting dynamically to every keystroke, shortcut, and error right beside your cursor.

⚡ Quick Install

In VS Code or Cursor:

1. Press Cmd + P (Mac) or Ctrl + P (Windows/Linux).
2. Paste:

   ext install Taufik-H.opit-companion
   

3. Press Enter!

📖 Overview

Coding can be intense and solitary. OPIT Companion transforms your daily coding routine by placing an expressive, animated sprite directly into your text editor.

As you write code, OPIT stays right by your cursor—sprinting when you type fast, celebrating when you save, slashing when you delete, and reacting when errors appear. It is designed to be lightweight, fluid, and delightful without getting in the way of your productivity.

✨ Features & Action Showcase

🏃 1. Keystroke & Editor Reactions

OPIT actively observes your editor actions and reacts in real time with continuous physics momentum:

🎭 2. Live Character Switching

Choose from distinct hero characters, each with their own theme color, personality, and animations:

• 🌸 Pink Monster: Energetic and playful companion.
• 🔷 Blue Hero: Sleek and focused warrior.
• 🤍 White Chocobo: Minimalist and calm paladin.

🎛️ 3. Sleek Control Deck & Settings

Access the companion control center from the Activity Bar (left sidebar):

• Live Character Selector: Browse skins with continuous step-animated previews.
• Display Size Slider: Scale your companion from subtle (16px) to bold (40px) to fit your font and line height.
• Animation Speed Slider: Adjust animation tempo from chill (0.5x) to hyperactive (2.0x).
• Native Cursor Toggle: Choose whether to keep the standard text cursor or let OPIT be your main cursor guide.
• Apply Settings: One-click configuration calibration across all editor windows.

🎮 4. Instant Reaction Test Deck

Trigger and preview animations on demand directly from the sidebar:

• Save: Trigger celebratory jump animation.
• Error: Diagnostic dizziness reaction.
• Slash: Combat weapon attack.
• Jump: Vertical leap.
• Squat: Cute ducking squat.
• Poof: Smoke teleportation.

🔍 5. Precision Cursor Tracking & Idle

60 FPS ultra-smooth momentum physics that stays locked beside your text cursor without layout jitter:

🚀 How to Use

1. Opening the OPIT Dashboard

1. Look at the Activity Bar on the left side of your editor.
2. Click on the OPIT Companion icon (👾).
3. The dashboard will open, showing your active character and customizable controls.

2. Changing Companion Skin

• Via Dashboard: Simply click on any character card in the sidebar grid.
• Via Command Palette:
  1. Press Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows/Linux).
  2. Type and select OPIT: Change Character Skin.
  3. Pick your preferred companion from the list.

3. Adjusting Cursor & Sizing

• In the sidebar dashboard, adjust the Display Size slider to align the sprite with your editor's line height.
• Toggle the Native Cursor switch to customize your cursor visibility.
• Click Apply settings to optimize your editor typography and cursor alignment.

⌨️ Available Commands

⚙️ Configuration Options

You can adjust settings via the Sidebar Dashboard or directly in your settings.json:

{
  // Chosen character skin: "pink", "blue", or "white"
  "opit.variant": "pink",

  // Sprite display size in pixels (default: 22)
  "opit.displaySize": 22,

  // Speed multiplier for animations (default: 1.0)
  "opit.animationSpeed": 1.0,

  // Show or hide native text cursor alongside OPIT
  "opit.showCursor": false
}

🖥️ Supported Editors & IDEs

OPIT Companion is engineered to deliver a consistent, delightful experience across modern development environments:

🏷️ Versioning & Releases

This project follows Semantic Versioning (SemVer 2.0). Updates and releases are categorized as:

• Patch (v0.1.X): Bug fixes, sprite offset calibrations, and stability tweaks.
• Minor (v0.X.0): New companion skins, animations, and dashboard features.
• Major (vX.0.0): Large-scale evolutions and architectural updates.

🎨 Character Roster (15 Playable Companions)

Choose your ideal coding buddy across 5 unique classes:

🙏 Asset Credits & Attribution

We extend our deep gratitude to the talented pixel artists and game asset creators who make developer tools fun and expressive:

• Free Game Assets by CraftPix.net:
  • Werewolf Character Sprites (CraftPix Freebies)
  • 2D Ninja Character Sprites (CraftPix Freebies)
  • Tiny Knight 2D Character Sprites (CraftPix Freebies)
  • 2D Mage & Wizard Character Sprites (CraftPix Freebies)
  • Licensed under the CraftPix Freebie File License.
• Retro Character Sprites:
  • Original retro chibi monster & paladin companion pixel-art assets.

📄 License

MIT License © 2026 Taufik-H. Built with ❤️ for coders who love a little companionship in their editor! 👾✨