Skip to content

Parthsadaria/oneko-vscode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐱 Oneko Cat — VS Code Extension

A pixel cat that lives inside VS Code — roams around, chases your cursor, and naps when bored.


🖼️ See It in Action

Following Cursor Sleeping Roaming
Following Sleeping Roaming

📍 Where to Find the Cat

After installation, look in your Explorer sidebar — scroll past Timeline and you'll see ONEKO CAT. Click to expand. The cat lives right there.

💡 Can't see it? Check the FAQ below.


✨ What It Does

  • Roams to random spots every 5–15 seconds
  • Follows your cursor — tease it 2–3 times and it'll start chasing you
  • Gets bored — goes back to wandering after ~10 seconds of chasing
  • Falls asleep when idle
  • Scratches walls near the panel edges
  • Draggable — pick it up and drop it anywhere

🎮 Controls

Action Result
Move cursor near cat (2–3×) Cat starts following
Drag Move cat anywhere
Double-click Toggle sleep / wake
⋯ menu Speed, sleep, reset, pet

📦 Install

VS Code Marketplace (easiest)

  1. Ctrl+Shift+X → search "Oneko Cat" → Install

From VSIX

  1. Download .vsix from Releases
  2. Ctrl+Shift+PExtensions: Install from VSIX

From Source

git clone https://github.com/Parthsadaria/oneko-vscode.git
cd oneko-vscode
npm install
vsce package
code --install-extension oneko-vscode-1.0.0.vsix

❓ FAQ

The cat panel isn't showing up — where is it? Scroll to the bottom of your Explorer sidebar. The ONEKO CAT section appears below Timeline and Outline. If it's still missing, try reloading VS Code (Ctrl+Shift+PDeveloper: Reload Window).

The panel is there but I see nothing / it's blank. Expand the panel and resize it — drag the panel border to make it taller. The cat needs space to appear!

The cat disappeared. Open the ⋯ menu in the panel title and click Reset Position. That brings it back to center.

Can I make it faster or slower? Yes — ⋯ menu → Change Speed (Slow / Normal / Fast / Super Fast).

How do I make it follow me? Move your cursor close to the cat and back away, a couple of times. After 2–3 teases it'll start chasing.

Can I turn it off without uninstalling? Collapse the ONEKO CAT panel — the cat pauses when the panel is hidden.


🛠️ Development

git clone https://github.com/Parthsadaria/oneko-vscode.git
cd oneko-vscode
npm install
code .
# Press F5 to launch the extension in debug mode

📝 Credits

  • Original concept: oneko.js by adryd325
  • Classic oneko sprite sheet

Enjoying the cat? Leave a review or ⭐ star the repo — it helps a lot!

About

A cute cat that chills around in your VS Code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors