playbooks
=========

Documentation for the ``playbooks`` command and its subcommands.


.. raw:: html

    <!-- spacer -->

.. dropdown:: ``playbooks`` — Install and manage playbooks (Codex/Claude).
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] COMMAND [ARGS]...
        
          Install and manage playbooks (Codex/Claude).
        
        Options:
          --help  Show this message and exit.
        
        Commands:
          apply     Apply an installed rule playbook to the current git repository.
          delete    Delete one installed playbook by id, or all with --all.
          describe  Show an installed playbook's manifest and document content.
          install   Install one or more playbooks from SOURCE.
          list      List installed playbooks.
          remove    Alias for delete.
          update    Update one installed playbook, or all if KIT\_ID is omitted.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] COMMAND [ARGS]...


.. dropdown:: ``playbooks apply`` — Apply an installed rule playbook to the current git repository.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] [KIT\_ID]
        
          Apply an installed rule playbook to the current git repository.
        
        Options:
          -y, --yes  Skip confirmation prompt.
          --help     Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] [KIT_ID]


.. dropdown:: ``playbooks delete`` — Delete one installed playbook by id, or all with --all.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] [KIT\_ID]
        
          Delete one installed playbook by id, or all with --all.
        
        Options:
          --all      Remove all installed playbooks.
          -y, --yes  Skip confirmation prompt.
          --help     Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] [KIT_ID]


.. dropdown:: ``playbooks describe`` — Show an installed playbook's manifest and document content.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] KIT\_ID
        
          Show an installed playbook's manifest and document content.
        
        Options:
          --help  Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] KIT_ID


.. dropdown:: ``playbooks install`` — Install one or more playbooks from SOURCE.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] SOURCE
        
          Install one or more playbooks from SOURCE.
        
          SOURCE can be:   - Local folder/archive path   - http(s) archive URL   -
          gh:owner/repo[/path][@ref]   - bb:owner/repo[/path][@ref]   -
          art:https://...
        
        Options:
          --force  Overwrite an already-installed playbook with the same id.
          --help   Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] SOURCE


.. dropdown:: ``playbooks list`` — List installed playbooks.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS]
        
          List installed playbooks.
        
        Options:
          --help  Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS]


.. dropdown:: ``playbooks remove`` — Alias for delete.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] [KIT\_ID]
        
          Alias for delete.
        
        Options:
          --all      Remove all installed playbooks.
          -y, --yes  Skip confirmation prompt.
          --help     Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] [KIT_ID]


.. dropdown:: ``playbooks update`` — Update one installed playbook, or all if KIT\_ID is omitted.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] [KIT\_ID]
        
          Update one installed playbook, or all if KIT\_ID is omitted.
        
        Options:
          --skills  Update only skill playbooks.
          --rules   Update only rule playbooks.
          --help    Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] [KIT_ID]


Options
-------

No options available.