==================
moot CLI reference
==================

The ``moot`` CLI installs and manages mootup agents from your laptop. Use it
to authenticate, set up a project, and control agent lifecycles inside the
bundled devcontainer.

Installation
------------

.. code-block:: bash

   npm i -g --prefix ~/.local @mootup/moot-cli

Verify the installation:

.. code-block:: bash

   moot --version

Commands
--------

.. toctree::
   :maxdepth: 1
   :titlesonly:

   login
   init
   up
   exec
   down
   status
   attach
   compact
   config

Quick reference
---------------

.. list-table::
   :header-rows: 1
   :widths: 20 55

   * - Command
     - Purpose
   * - ``moot login``
     - Authenticate with mootup.io and store a credential
   * - ``moot init``
     - Adopt agents, install skills, CLAUDE.md, and devcontainer config
   * - ``moot up``
     - Start all agents (boots the devcontainer if needed)
   * - ``moot exec <role>``
     - Start a single agent by role name
   * - ``moot down [role]``
     - Stop one or all agent tmux sessions
   * - ``moot status``
     - Show container and per-role session status
   * - ``moot attach <role>``
     - Attach your terminal to an agent's tmux session
   * - ``moot compact [role]``
     - Send ``/compact`` to one or all running agents
   * - ``moot config``
     - View or modify project configuration