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.

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.

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

folderbot config folder PATH

Set the root folder path.

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.

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.

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:

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