<p align="center"><img src="assets/logo-simvia.svg" alt="Simvia Logo" width="50%" /></p> <p align="center"> <a href="https://github.com/simvia/cave/releases"><img src="https://img.shields.io/badge/version-0.1.0-blue" alt="Version" /></a> <a href="https://github.com/simvia-tech/cave/actions/workflows/pr.yml"><img src="https://github.com/simvia-tech/cave/actions/workflows/pr.yml/badge.svg" alt="CI-CD" /></a> <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License" /></a> </p>

CAVE CLI

CAVE is a CLI tool that leverages Docker to conveniently manage multiple code_aster versions on your local environment, thanks to Simvia's code_aster docker images .

⚡ Features

• cave run – run Docker images
• cave list – list available images
• cave available – list images on DockerHub
• cave config – configure Cave
• cave use / cave pin – manage versions
• Man page available

🛠 Installation

This software require to first having installed docker.

Quick Install (recommended)

sh -c "$(curl -fsSL https://raw.githubusercontent.com/simvia-tech/cave/main/tools/install.sh)"

This will auto-detect your Linux distribution and install the appropriate package (.deb, .rpm, or binary tarball).

Installation with linux packages

Debian based (ubuntu, linux mint ...)

Fetch the latest release .deb file, then run :

sudo dpkg -i cave_version.deb

RedHat / Fedora (.rpm)

Fetch the latest release .rpm file, then run :

sudo dnf install cave_version.rpm
# or for older systems
sudo yum install cave_version.rpm

Binary install

Download the pre‑built tarball, extract the cave binary .tar.gz

tar -xzf ./cave_version.tar.gz -C /tmp
sudo mv /tmp/cave /usr/local/bin/

Verify installation:

cave --version
cave --help
man cave

At each run, cave will check for updates and notify you if a new version is available. To disable this feature, use:

cave config disable-update-check

Usage

For detailed user documentation, please visit our User Documentation.

Telemetry

cave includes optional telemetry features to help improve the tool by collecting anonymous usage data. You can control telemetry settings via the configuration commands.

By default, version usage tracking is enabled, sending anonymous data (see Telemetry) about which code_aster versions you run. You can disable this tracking if you prefer.

To deactivate telemetry, use:

cave config disable-usage-tracking

Telemetry respects your privacy and does not collect sensitive information.

Contributors

• Lucas S.
• Basile M.
• Hadrien R.

See Also

• code_aster
• Simvia Docker Hub
• code_aster catalog

License

This project is licensed under the MIT License. See the LICENSE file for details.

Reach Us

We love feedback. Don't hesitate to open a Github issue or feel free to reach us on our website https://simvia.tech/fr#contact