Skip to content

Command chaos styx

The chaos styx command is used to manage and interact with the Styx soul registry.

This command allows you to install (invoke), list (list), and remove (destroy) souls that extend the functionality of Ch-aOS.

Usage

chaos styx <action> [soul_name]

  • <action>: The operation you want to perform. It can be one of the following:

  • invoke: Install a Soul.

  • list: List all Souls on Styx.

  • destroy: Remove an installed Soul.

Sending a Soul to Styx

If you have created a Soul in Ch-aOS, and would like to share it with the community via Styx, please open a PR on the Styx GitHub repository

It is quite simply a dict of dicts in a yaml file with the following structure: 

styx: # global dict
  chaos-dots: # name of your Soul
    name: chaos-dots # name that you builded you Soul with
    repo: https://github.com/Ch-aOS-Ch/chaos-dots # the git repo where your Soul is hosted
    about: "A Ch-aotic dotfile manager, full with declarativity and statefulness" # a brief description about your Soul
    version: "v0.1.1" # the version of your Soul, cannot be "latest", be specific

Important

Styx was created to be simple, it is NOT a package manager. It was created from the start to be as simple as possible (either you have the Soul, or not), it is a plugin registry, managed and contributed by the community. There should NOT be a "chaos-utils" inside of styx, since Souls should be auto contained solutions. All of the tools for creating an auto contained solution for Ch-aOS are available and should be used. PyPI managed utilities are not only recommended, they are the correct way to distribute an utils package for styx Souls. Souls may use any PyPI package, but it is required to have undergone an "pip-audit" run before the styx installation.

About security:

ATTENTION, THIS IS IMPORTANT.

ALL Styx Souls NEED to be reviewed by a member of the "Reviewers Styx" team and be open source in order to be added to the styx registry.

ALL Souls should be submitted with a proper LICENSE file, and a proper SECURITY.md file.

ALL Souls should be added with a SIGNED COMMIT AND PR. No Souls will be accepted without such.

All Souls are installed via the repo url provided in the styx registry only download a .whl file with the "this_name-version-py3-none-any.whl" format.

All Souls are installed in the user's home directory, and should have documentation about if they require elevated permissions OR if they require secrets access.

The main branch of the repo is always protected, and all PRs are reviewed before being merged (the repo is public, so anyone can review PRs) (ONLY exception are Souls created by the Ch-aOS team themselves).