Skip to content

Repository files navigation

Mochi

Mochi official black cat logo

A tiny cat for every browser tab :3
A small, local-first browser companion for a slightly less sterile internet.

Repository · Issues · Koustav Roy

Mochi brand showcase Mochi in action with the popup and cat on a page

What is Mochi?

Mochi is a lightweight Chromium extension that places a tiny animated cat on the pages you browse. Pick a style, drag it into a corner, and let it quietly keep you company while you work, study, watch, or wander around the web.

Product Hunt launch: Mochi reached #12 on the launch day leaderboard with 107 points. Thanks to everyone who checked it out and supported the tiny cat :3

Mochi showcase with a desktop monitor and reference cats

Borderless Mochi banner with different cat styles

Mochi feature overview

Quick start

You do not need Git or any programming knowledge to install Mochi. The easiest method is to download the project as a ZIP file and add it to your browser.

1. Download Mochi from GitHub

Open the Mochi GitHub repository. Click the green Code button, then click Download ZIP.

GitHub Code menu with Download ZIP highlighted for the Mochi repository

You do not need to clone the repository or install Git. The ZIP download is the easiest option for most people.

2. Extract the downloaded ZIP file

Open your computer’s Downloads folder and find mochi-main.zip. Right-click it and choose Extract All. This creates a new folder named mochi-main.

Downloads folder showing mochi-main.zip and the Extract All option

Keep the extracted mochi-main folder somewhere easy to find, such as your Desktop or Documents folder. Do not select the ZIP file itself when installing Mochi.

3. Open your browser’s extensions page

Open your browser menu by clicking the three dots in the top-right corner. Choose Extensions, then Manage Extensions.

Chromium browser menu showing Extensions and Manage Extensions

If your browser menu looks different, you can paste one of these addresses into the address bar:

  • Chrome or Chromium: chrome://extensions
  • Microsoft Edge: edge://extensions
  • Brave: brave://extensions
  • Vivaldi: vivaldi://extensions
  • Opera: opera://extensions

4. Turn on Developer mode

On the extensions page, find the Developer mode switch near the top-right corner and turn it on.

Chromium extensions page with Developer mode highlighted

At this point, the extensions page will still be empty. Mochi will appear only after you complete the next step.

5. Load the Mochi folder

Click Load unpacked. In the folder window, open the extracted mochi-main folder and select the folder that contains manifest.json.

Chromium Load unpacked button and Mochi folder containing manifest.json

After you select the folder, Mochi should appear in your list of installed extensions. This is the moment when Mochi is installed in your browser.

6. Choose your cat and start using Mochi

Open a normal website, click the Extensions button in your browser’s toolbar, and select Mochi. Choose your favorite cat and turn on Show cat.

Mochi popup with Show cat enabled and a cat visible on a webpage

You can drag Mochi to a different corner of the page. Your selected cat and position will be remembered across your tabs.

Want to use your own cat? In the Mochi popup, click Import under Custom sprites and choose a GIF or PNG up to 2 MB. Custom sprites are stored locally in your browser and are never uploaded. You can switch between custom and built-in cats or remove a custom sprite at any time.

Community sprite pack

Community members can submit GIF or PNG sprites through a pull request in the community-sprites folder. Each submission is reviewed manually. Only approved sprites are moved into the pack and shown in Mochi, together with the creator’s name and license information.

Troubleshooting

If Mochi does not work, first reload the webpage.

If it still does not work, open your browser’s extensions page, remove Mochi, and load the extracted folder again with Load unpacked.

If the problem continues or your browser is not compatible, email koustavdatascience@gmail.com.

For developers

If you already use Git, you can clone the repository instead. This is not required for regular users.

git clone https://github.com/koustavdatascience/mochi.git

Cat styles

Mochi includes Bad Boy, Black Cat, Rolling Cat, Cream Cat, Frog Cat, Tiny Cat, Scarf Cat, Cat Roll, Blue Spinner, Yawning Cat, Pixel Cat, Blush Cat, Dancer, Meme Cat, Love Cat, Mewo, Sleepy Cat, White Kitty, Bleh Cat, and Paper Hat.

Gallery of the 20 Mochi cat styles

Contact

For feedback or issues, email koustavdatascience@gmail.com.

License

Copyright © 2026 Koustav Datascience.

Mochi is licensed under the GNU General Public License v3.0. See the LICENSE file for the complete terms.

About

A tiny animated cat companion for your browser tabs. Mochi reached #12 on the launch day

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages