# Oneko for Raycast

URL: https://www.raycast.com/miklw/oneko

> Show or hide Oneko, the desktop cat that chases your mouse cursor on your Mac, and change its skin and speed.

- Install: raycast://extensions/miklw/oneko
- Author: [Michael](https://www.raycast.com/miklw)
- Installs: 39
- Platforms: macOS
- Categories: Fun
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/459326f4f557692a79246dba2d013746f56d724b/extensions/oneko/

## Commands

- **Toggle Cat**: Show or hide the cat, starting Oneko if needed.
- **Change Skin**: Pick the sprite the cat wears.
- **Set Speed**: Set how fast the cat chases the cursor.
- **Quit Oneko**: Quit the Oneko app.

## README

### Oneko for Raycast

Control [Oneko](https://github.com/oneko-swift/oneko-swift), the desktop cat
that chases your cursor, without leaving Raycast.

#### Commands

- **Toggle Cat** — show or hide the cat, starting Oneko if needed
- **Change Skin** — pick from all 27 sprites, with previews
- **Set Speed** — slow, normal, or fast
- **Quit Oneko** — quit the app

The extension requires the Oneko app 1.2 or later (macOS 13+):

```sh
brew install --cask oneko-swift/tap/oneko
```

All commands talk to the app through its `oneko://` URL scheme, so the
extension needs no permissions of its own.

#### Development

The extension lives in the
[oneko-swift repo](https://github.com/oneko-swift/oneko-swift/tree/main/raycast),
where the skin thumbnails in `assets/skins/` are generated from the sprite
sheets with `swift tools/makethumbs.swift Resources raycast/assets/skins`.
