# micoo: quick access to `mise-cookbooks`
<!-- TODO: Make it work, make it right, make it fast. -->
[](https://github.com/hasansezertasan/micoo/actions/workflows/ci.yml)
[](https://pypi.org/project/micoo)
[](https://pypi.org/project/micoo)
[](https://opensource.org/licenses/MIT)
[][micoo]
<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->
<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->
<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->
[](http://mypy-lang.org/)
[](https://github.com/astral-sh/ruff)
[](https://github.com/hasansezertasan/micoo/releases/)
[](https://pepy.tech/project/micoo)
[](https://pepy.tech/project/micoo)
[](https://pepy.tech/project/micoo)
`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:
```sh
# 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:
```sh
mise install pipx:micoo
```
Alternatively, you can install it using `uv tool install micoo` :jigsaw:
```sh
uv tool install micoo
```
## Command Reference :book:
Here is the output of the `micoo --help` command:
```sh
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:
```sh
micoo list
```
This will output:
```sh
Available cookbooks:
- terraform
- python
- cpp
- pnpm
- node
- ruby-on-rails
- opentofu
```
Dump a specific cookbook to a `mise.toml` file:
```sh
micoo dump python > mise.toml
```
Open the [mise-cookbooks] repository in the browser:
```sh
open $(micoo remote)
```
Open the cloned repository in the file manager:
```sh
open $(micoo root)
```
Show the current version of `micoo`:
```sh
micoo version
```
Show the information about the `micoo` application:
```sh
micoo info
```
## Support :heart:
If you have any questions or need help, feel free to open an issue on the [GitHub repository][micoo].
## Author :person_with_crown:
This project is maintained by [Hasan Sezer Taลan][author], It's me :wave:
## Contributing :heart:
Any contributions are welcome! Please follow the [Contributing Guidelines](https://github.com/hasansezertasan/micoo/tree/main/./CONTRIBUTING.md) to contribute to this project.
## Development :toolbox:
To set up the development environment:
```sh
# 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](https://opensource.org/license/MIT).
<!-- Refs -->
[mise-cookbooks]: https://github.com/hasansezertasan/mise-cookbooks
[mise]: https://github.com/jdx/mise
[author]: https://github.com/hasansezertasan
[micoo]: https://github.com/hasansezertasan/micoo
## Changelog :memo:
## [0.3.0] - 2025-07-27
### Fixed
- Versioning
## [0.2.0] - 2025-07-27
### Changed
- Update by @hasansezertasan in [#16](https://github.com/hasansezertasan/micoo/pull/16)
- Git-cliff integration by @hasansezertasan in [#6](https://github.com/hasansezertasan/micoo/pull/6)
- Implement dynamic arguments and pin python version to 3.9 by @hasansezertasan in [#4](https://github.com/hasansezertasan/micoo/pull/4)
- Generate release notes and discussions on gh-release, adjust permissions, bump setup-uv version by @hasansezertasan in [#3](https://github.com/hasansezertasan/micoo/pull/3)
### Fixed
- Merge README.md and CHANGELOG.md when publishing to PyPI by @hasansezertasan in [#2](https://github.com/hasansezertasan/micoo/pull/2)
- Correct replacement pattern in fancy-pypi-readme hook by @hasansezertasan in [#1](https://github.com/hasansezertasan/micoo/pull/1)
### Removed
- Remove redundant configs by @hasansezertasan in [#5](https://github.com/hasansezertasan/micoo/pull/5)
## [0.1.0] - 2025-07-27
### Changed
- Initial commit by @hasansezertasan
## New Contributors
- @hasansezertasan made their first contribution
<!-- refs -->
[0.1.0]: https://github.com/hasansezertasan/micoo/tree/0.1.0
[0.3.0]: https://github.com/hasansezertasan/micoo/compare/0.2.0..0.3.0
[0.2.0]: https://github.com/hasansezertasan/micoo/compare/0.1.0..0.2.0
Raw data
{
"_id": null,
"home_page": null,
"name": "micoo",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "hasansezertasan <hasansezertasan@gmail.com>",
"keywords": "boilerplate, cli, command-line, cookbook, mise, scaffold, template",
"author": null,
"author_email": "Hasan Sezer Ta\u015fan <hasansezertasan@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/cb/6c/1d50076bb514789eff5cba8a8c4cd7e252d7500d354cdc45316f5423876b/micoo-0.3.0.tar.gz",
"platform": null,
"description": "# micoo: quick access to `mise-cookbooks`\n\n<!-- TODO: Make it work, make it right, make it fast. -->\n\n[](https://github.com/hasansezertasan/micoo/actions/workflows/ci.yml)\n[](https://pypi.org/project/micoo)\n[](https://pypi.org/project/micoo)\n[](https://opensource.org/licenses/MIT)\n[][micoo]\n\n<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->\n\n<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->\n\n<!-- [](https://codecov.io/gh/hasansezertasan/micoo) -->\n\n[](http://mypy-lang.org/)\n[](https://github.com/astral-sh/ruff)\n[](https://github.com/hasansezertasan/micoo/releases/)\n\n[](https://pepy.tech/project/micoo)\n[](https://pepy.tech/project/micoo)\n[](https://pepy.tech/project/micoo)\n\n`micoo` (short for **mise cookbooks**) is a :zap: command-line tool that makes it easy to access [mise] configuration files from [mise-cookbooks] :books:.\n\n## Typical Usage :rocket:\n\n```sh\n# List available cookbooks\nmicoo list\n\n# Create a new mise.toml with a cookbook\nmicoo dump python > mise.toml\n```\n\n## Features :sparkles:\n\n- \ud83d\ude80 Quick access to [mise-cookbooks]\n- \ud83d\udcda Easy cookbook listing and content viewing\n- \ud83d\udcbe Simple dumping of cookbooks to mise.toml\n- \ud83d\udd04 Repository cloning and updating\n- \ud83c\udf10 Browser integration for quick repository access\n\n## Installation :package:\n\nThere are several ways to install `micoo`! :rocket: I recommend using (obviously) [mise] :hammer_and_wrench:. Here's how to do it:\n\n```sh\nmise install pipx:micoo\n```\n\nAlternatively, you can install it using `uv tool install micoo` :jigsaw:\n\n```sh\nuv tool install micoo\n```\n\n## Command Reference :book:\n\nHere is the output of the `micoo --help` command:\n\n```sh\n Usage: micoo [OPTIONS] COMMAND [ARGS]...\n\u256d\u2500 Options \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 --install-completion Install completion for the current shell. \u2502\n\u2502 --show-completion Show completion for the current shell, to copy it or \u2502\n\u2502 customize the installation. \u2502\n\u2502 --help Show this message and exit. \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n\u256d\u2500 Commands \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 update Clone or fetch the `mise-cookbooks` repository. \u2502\n\u2502 list List the available mise cookbooks. \u2502\n\u2502 search Search for a mise cookbook. \u2502\n\u2502 dump Dump a mise cookbook. \u2502\n\u2502 root Show the path to the micoo boilerplates directory. \u2502\n\u2502 remote Show the URL to the remote repository. \u2502\n\u2502 version Show the current version number of micoo. \u2502\n\u2502 info Display information about the micoo application. \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n```\n\n## Usage :hammer_and_wrench:\n\nYou can use the `micoo` command to interact with [mise-cookbooks]. Here are some common commands:\n\nList all available cookbooks:\n\n```sh\nmicoo list\n```\n\nThis will output:\n\n```sh\nAvailable cookbooks:\n- terraform\n- python\n- cpp\n- pnpm\n- node\n- ruby-on-rails\n- opentofu\n```\n\nDump a specific cookbook to a `mise.toml` file:\n\n```sh\nmicoo dump python > mise.toml\n```\n\nOpen the [mise-cookbooks] repository in the browser:\n\n```sh\nopen $(micoo remote)\n```\n\nOpen the cloned repository in the file manager:\n\n```sh\nopen $(micoo root)\n```\n\nShow the current version of `micoo`:\n\n```sh\nmicoo version\n```\n\nShow the information about the `micoo` application:\n\n```sh\nmicoo info\n```\n\n## Support :heart:\n\nIf you have any questions or need help, feel free to open an issue on the [GitHub repository][micoo].\n\n## Author :person_with_crown:\n\nThis project is maintained by [Hasan Sezer Ta\u015fan][author], It's me :wave:\n\n## Contributing :heart:\n\nAny contributions are welcome! Please follow the [Contributing Guidelines](https://github.com/hasansezertasan/micoo/tree/main/./CONTRIBUTING.md) to contribute to this project.\n\n## Development :toolbox:\n\nTo set up the development environment:\n\n```sh\n# Clone the repository\ngit clone https://github.com/hasansezertasan/micoo.git\ncd micoo\n\n# Install development dependencies\nuv sync\n\n# Update the code...\n\n# Run tests\nuv run --locked tox run\n\n# Add a new git tag.\ngit tag -a 0.2.0 -m \"bump: version 0.2.0 \u2192 0.2.0\"\n\n# Build the package\nuv build\n```\n\n## Related Projects :chains:\n\n- [mise] - The official mise project\n- [mise-cookbooks] - Collection of mise cookbooks\n\n## License :scroll:\n\nThis project is licensed under the [MIT License](https://opensource.org/license/MIT).\n\n<!-- Refs -->\n[mise-cookbooks]: https://github.com/hasansezertasan/mise-cookbooks\n[mise]: https://github.com/jdx/mise\n[author]: https://github.com/hasansezertasan\n[micoo]: https://github.com/hasansezertasan/micoo\n\n## Changelog :memo:\n\n## [0.3.0] - 2025-07-27\n\n### Fixed\n\n- Versioning\n\n## [0.2.0] - 2025-07-27\n\n### Changed\n\n- Update by @hasansezertasan in [#16](https://github.com/hasansezertasan/micoo/pull/16)\n- Git-cliff integration by @hasansezertasan in [#6](https://github.com/hasansezertasan/micoo/pull/6)\n- Implement dynamic arguments and pin python version to 3.9 by @hasansezertasan in [#4](https://github.com/hasansezertasan/micoo/pull/4)\n- Generate release notes and discussions on gh-release, adjust permissions, bump setup-uv version by @hasansezertasan in [#3](https://github.com/hasansezertasan/micoo/pull/3)\n\n### Fixed\n\n- Merge README.md and CHANGELOG.md when publishing to PyPI by @hasansezertasan in [#2](https://github.com/hasansezertasan/micoo/pull/2)\n- Correct replacement pattern in fancy-pypi-readme hook by @hasansezertasan in [#1](https://github.com/hasansezertasan/micoo/pull/1)\n\n### Removed\n\n- Remove redundant configs by @hasansezertasan in [#5](https://github.com/hasansezertasan/micoo/pull/5)\n\n## [0.1.0] - 2025-07-27\n\n### Changed\n\n- Initial commit by @hasansezertasan\n\n## New Contributors\n\n- @hasansezertasan made their first contribution\n\n<!-- refs -->\n[0.1.0]: https://github.com/hasansezertasan/micoo/tree/0.1.0\n[0.3.0]: https://github.com/hasansezertasan/micoo/compare/0.2.0..0.3.0\n[0.2.0]: https://github.com/hasansezertasan/micoo/compare/0.1.0..0.2.0",
"bugtrack_url": null,
"license": null,
"summary": "micoo is a command-line tool for easily accessing mise cookbooks",
"version": "0.3.0",
"project_urls": {
"changelog": "https://github.com/hasansezertasan/micoo/blob/main/CHANGELOG.md",
"documentation": "https://github.com/hasansezertasan/micoo#readme",
"homepage": "https://github.com/hasansezertasan/micoo",
"issues": "https://github.com/hasansezertasan/micoo/issues",
"releasenotes": "https://github.com/hasansezertasan/micoo/releases",
"source": "https://github.com/hasansezertasan/micoo.git"
},
"split_keywords": [
"boilerplate",
" cli",
" command-line",
" cookbook",
" mise",
" scaffold",
" template"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4e7c727ebcc43f4b593adc6bed860d6631a6a7e608a37a1a26309efafa1a7459",
"md5": "7ae7caae74b43f9d9486724b26b68b94",
"sha256": "7b9ff69146ea48ed5984f979d22449400bd3c99eaaf6c9b2e0461ce7660cf770"
},
"downloads": -1,
"filename": "micoo-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ae7caae74b43f9d9486724b26b68b94",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9356,
"upload_time": "2025-07-27T23:21:50",
"upload_time_iso_8601": "2025-07-27T23:21:50.460826Z",
"url": "https://files.pythonhosted.org/packages/4e/7c/727ebcc43f4b593adc6bed860d6631a6a7e608a37a1a26309efafa1a7459/micoo-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cb6c1d50076bb514789eff5cba8a8c4cd7e252d7500d354cdc45316f5423876b",
"md5": "bd7059cbfa7abdc09704fa18506370ec",
"sha256": "ac9a1966032806b82435285cbd29e8b72e47a22bcdd86baaf048d5d40af61844"
},
"downloads": -1,
"filename": "micoo-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "bd7059cbfa7abdc09704fa18506370ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 118291,
"upload_time": "2025-07-27T23:21:52",
"upload_time_iso_8601": "2025-07-27T23:21:52.016290Z",
"url": "https://files.pythonhosted.org/packages/cb/6c/1d50076bb514789eff5cba8a8c4cd7e252d7500d354cdc45316f5423876b/micoo-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 23:21:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hasansezertasan",
"github_project": "micoo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "micoo"
}
JSON
