Skip to content

annals-ai/coco

Repository files navigation

Coco icon

Coco

An open-source, Rust-powered alternative to Raycast/PowerToys — a fast popup launcher for apps, utilities, and workflows.

Latest release Downloads Discord Stars License

Coco, Raycast and PowerToys are productivity tools. They provide a popup search bar that people can use to do many things, like opening apps, calculators, quick-notes, etc.

Community: https://discord.gg/bDfNYPbnC5

Coco Demo PreRelease V1

Installation:

Via Homebrew:

Requires Homebrew

brew tap unsecretised/tap
brew install --cask coco

Then launch it via launchpad or spotlight (hopefully the last time you have to use spotlight :) Have fun!)

Via github releases

  1. Go to the releases page
  2. Download the .zip file or .dmg file
  3. If .dmg file, open it and drag the Coco.app to your /Applications/ (you should be guided)
  4. If .zip file, extract the Coco.app to your /Applications/

Build it youself:

  1. Clone the repo with git clone https://github.com/unsecretised/coco.git
  2. Install cargo bundle with cargo install cargo-bundle (Requires cargo to be installed)
  3. Run cargo bundle --release to build Coco for your system (The App Dir will be available at: target/release/bundle/osx/Coco.app)
  4. Move the Coco.app directory to your /Applications/ folder, and launch Coco

Config:

I have a high chance of forgetting to update the config docs, but even if I do, you will most likely be able to find my config and a list of the latest config options easily here

The config file should be located at: ~/.config/coco/config.toml Coco creates the default configuration for you, but it does use its default options Here's a full list of what all you can configure The list The blurring is still a bit wonky, and will be fixed in the upcoming releases

You can also set terminal_app in ~/.config/coco/config.toml to control which terminal opens from the built-in "Open Terminal" item (for example: Terminal, Ghostty, or iTerm).

Feature list:

Finished:

  • Autoload installed apps 11/11/2025
  • Search through apps 11/11/2025
  • Generate randomvar (between 0 and 100) via the app. Simply type randomvar and it will generate the num for you
  • Image icons next to the text 13/12/2025
  • Scrollable options 12/12/2025
  • Customisable themes (13/12/2025)
    • Configurable colours
  • Spotify control - Ability to control spotify via the app
  • Allow variables to be passed into custom shell scripts.
  • Google your query. Simply type your query, and then put a ? at the end, and press enter
  • Calculator (27/12/2025)
  • Clipboard History (29/12/2025) This works by typing cbhist to enter the cliboard history page, which allows u to access your clipboard history,
  • Blur / transparent background (7/1/2026) and then use main to switch back, or just open an close the app again
  • Select the options using arrow keys
  • Tray icons (8/1/2026)
  • Unit Conversions (19/1/2026) thanks to Hriztam
  • Emoji Searching (19/1/2026) Allows people to search for emojis through Coco

Planned:

  • Popup note-taking
  • Plugin Support (Partially implemented on 15/12/2025)
  • Hyperkey - Map CMD + OPT + CTRL + SHIFT to a physical key
  • Ability to pick between tabs in firefox / chromium browsers - using Puppeteer
  • Cross platform support

Coco wouldn't be possible without these people:

  • Nazeofel - First sponsor + initiater of windows support
  • Mnem42 - Helped add windows support
  • Random Scientist - First ever community contributor to Coco
  • Lemon - Sponsored me, and gave me free Discord Nitro
  • Julie / Zoey - Gave me amazing feedback and has been using Coco since almost the first version!

All the people who starred my repo!!

Those who sponsor me also get a free easter egg inside Coco, so if you want a free easter egg, a dollar is all you need!

And the updated list of contributors:

Easter egg list:

  • Nazeofel (Random Variable on discord) -> led to the randomvar easter egg
  • Lemon -> led to the lemon easter egg that shows "lemon" on Coco

If you like Coco, consider starring it on github :)

Star History Chart

Motivations:

I didn't want to pay for raycast + wanted to get better at rust. Raycast in itself is one of the most useful productivity apps in my opinion, and it is truly an underappreiciated marvel of computer engineering

About

Spotlight-style app launcher for macOS with fuzzy/pinyin search, blur UI, and currency conversion

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages