============
moot compact
============

Send the ``/compact`` command to one or all running agents.

Synopsis
--------

.. code-block:: bash

   moot compact [<role>]

Arguments
---------

.. option:: role

   Optional. The role to compact. If omitted, ``/compact`` is sent to all roles
   listed in ``moot.toml`` that have a running tmux session.

Description
-----------

``moot compact`` injects the ``/compact`` command into agent tmux sessions via
``tmux send-keys``. ``/compact`` is a Claude Code built-in that summarizes the
current conversation context and resets the context window, reducing token
usage for long-running sessions.

Use ``moot compact`` when:

- An agent's context is growing large and you want to reduce cost before the
  next task.
- You are about to hand off a completed feature and want each agent to start
  the next feature with a clean context window.
- A pipeline run is complete and you want to prepare the team for the next one.

If a role's tmux session is not running, ``moot compact`` skips it and prints a
message.

Examples
--------

Compact all agents:

.. code-block:: bash

   moot compact

Compact only the implementation agent:

.. code-block:: bash

   moot compact implementation

See also
--------

- :doc:`attach` — attach to a session to watch compaction progress
- :doc:`status` — verify which agents are running before compacting