micoo 0.2.0

micoo is a command-line tool for easily accessing mise cookbooks

micoo: quick access to mise-cookbooks

micoo (short for mise cookbooks) is a :zap: command-line tool that makes it easy to access mise configuration files from mise-cookbooks :books:.

Typical Usage :rocket:

# List available cookbooks
micoo list

# Create a new mise.toml with a cookbook
micoo dump python > mise.toml

Features :sparkles:

• 🚀 Quick access to mise-cookbooks
• 📚 Easy cookbook listing and content viewing
• 💾 Simple dumping of cookbooks to mise.toml
• 🔄 Repository cloning and updating
• 🌐 Browser integration for quick repository access

Installation :package:

There are several ways to install micoo! :rocket: I recommend using (obviously) mise :hammer_and_wrench:. Here's how to do it:

mise install pipx:micoo

Alternatively, you can install it using uv tool install micoo :jigsaw:

uv tool install micoo

Command Reference :book:

Here is the output of the micoo --help command:

 Usage: micoo [OPTIONS] COMMAND [ARGS]...
╭─ Options ─────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.               │
│ --show-completion             Show completion for the current shell, to copy it or    │
│                               customize the installation.                             │
│ --help                        Show this message and exit.                             │
╰───────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────╮
│ update    Clone or fetch the `mise-cookbooks` repository.                             │
│ list      List the available mise cookbooks.                                          │
│ search    Search for a mise cookbook.                                                 │
│ dump      Dump a mise cookbook.                                                       │
│ root      Show the path to the micoo boilerplates directory.                          │
│ remote    Show the URL to the remote repository.                                      │
│ version   Show the current version number of micoo.                                   │
│ info      Display information about the micoo application.                            │
╰───────────────────────────────────────────────────────────────────────────────────────╯

Usage :hammer_and_wrench:

You can use the micoo command to interact with mise-cookbooks. Here are some common commands:

List all available cookbooks:

micoo list

This will output:

Available cookbooks:
- terraform
- python
- cpp
- pnpm
- node
- ruby-on-rails
- opentofu

Dump a specific cookbook to a mise.toml file:

micoo dump python > mise.toml

Open the mise-cookbooks repository in the browser:

open $(micoo remote)

Open the cloned repository in the file manager:

open $(micoo root)

Show the current version of micoo:

micoo version

Show the information about the micoo application:

micoo info

Support :heart:

If you have any questions or need help, feel free to open an issue on the GitHub repository.

Author :person_with_crown:

This project is maintained by Hasan Sezer Taşan, It's me :wave:

Contributing :heart:

Any contributions are welcome! Please follow the Contributing Guidelines to contribute to this project.

Development :toolbox:

To set up the development environment:

# Clone the repository
git clone https://github.com/hasansezertasan/micoo.git
cd micoo

# Install development dependencies
uv sync

# Update the code...

# Run tests
uv run --locked tox run

# Add a new git tag.
git tag -a 0.2.0 -m "bump: version 0.2.0 → 0.2.0"

# Build the package
uv build

Related Projects :chains:

• mise - The official mise project
• mise-cookbooks - Collection of mise cookbooks

License :scroll:

This project is licensed under the MIT License.

Changelog :memo:

Unreleased

Changed

• Implement dynamic arguments and pin python version to 3.9 by @hasansezertasan in #4
• Generate release notes and discussions on gh-release, adjust permissions, bump setup-uv version by @hasansezertasan in #3

Fixed

• Merge README.md and CHANGELOG.md when publishing to PyPI by @hasansezertasan in #2
• Correct replacement pattern in fancy-pypi-readme hook by @hasansezertasan in #1

Removed

• Remove redundant configs by @hasansezertasan in #5

[0.1.0] - 2025-07-27

Changed

• Initial commit by @hasansezertasan

New Contributors

• @hasansezertasan made their first contribution