CLI Reference
=============

Folderbot provides a command-line interface for configuration and management.

Bot Management
--------------

``folderbot run``
   Run the bot. Use ``--bot NAME`` for multi-bot configurations.

   .. code-block:: bash

      folderbot run
      folderbot run --bot work

``folderbot status``
   Show current configuration status, file counts, and database info.

``folderbot update``
   Check PyPI for newer versions and upgrade if available.

Configuration
-------------

``folderbot init``
   Interactive setup wizard. Creates ``.folderbot/config.toml`` in the current directory.
   Prompts for Telegram token, API key, and user ID. The root folder is implicit from the location.

``folderbot config show``
   Display the current configuration.

``folderbot config set KEY VALUE``
   Set a configuration value.

   .. code-block:: bash

      folderbot config set telegram_token "YOUR_TOKEN"
      folderbot config set model "claude-sonnet-4-20250514"

``folderbot config folder PATH``
   Set the root folder path.

   .. code-block:: bash

      folderbot config folder ~/my-notes

Folder Management
-----------------

``folderbot move DESTINATION``
   Move the entire folder to a new location and update the systemd service if installed.

   .. code-block:: bash

      cd /old/path/my-notes
      folderbot move /new/path/my-notes

   This moves the folder, updates the systemd ``WorkingDirectory``, and reloads the daemon.
   If no systemd service is installed, it simply moves the folder.

Systemd Service
---------------

Install and manage Folderbot as a systemd user service.

``folderbot service install``
   Install the systemd service and auto-update timer.
   Use ``--bot NAME`` for multi-bot setups.

``folderbot service enable``
   Enable the service to start on login.

``folderbot service start``
   Start the service.

``folderbot service stop``
   Stop the service.

``folderbot service status``
   Show the service status.

``folderbot service logs``
   View service logs. Use ``-f`` to follow.

   .. code-block:: bash

      folderbot service logs
      folderbot service logs -f

``folderbot service uninstall``
   Remove the service and timer.

Telegram Commands
-----------------

These commands are available in the Telegram chat:

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

   * - Command
     - Description
   * - ``/start``
     - Initialize bot and show help
   * - ``/clear``
     - Clear conversation history
   * - ``/new``
     - Start a new topic (clears history)
   * - ``/status``
     - Show session info (message count, file count)
   * - ``/files``
     - List files available in context
   * - ``/tasks``
     - List your scheduled tasks