User Guide — Shell Sentinel

Overview

Shell Sentinel is a terminal-native companion that keeps a persistent SSH/SFTP session against a remote server and lets you manage infrastructure through natural language. The assistant understands your intent, suggests safe commands and documents every action.

Requirements

Installation

  1. Create a virtual environment:
python3.12 -m venv .venv
source .venv/bin/activate
  1. Install dependencies:
make install

Language configuration

The app reads SMART_AI_SYS_ADMIN_LOCALE. If the variable is not defined it falls back to the system locale (default: English).

export SMART_AI_SYS_ADMIN_LOCALE=en   # English
export SMART_AI_SYS_ADMIN_LOCALE=es   # Spanish
export SMART_AI_SYS_ADMIN_LOCALE=de   # German

Launching the app

make run

A retro welcome screen appears and closes automatically after 5 seconds or when you press any key.

Interface layout

Core commands

Commands and aliases are available in English, Spanish and German.

Working with the assistant

Type natural-language instructions. When the message is not a slash command, the Strands agent processes it. Examples:

The agent reuses the active SSH session for remote commands. File transfers open SFTP on demand through the same connection and every action is recorded in the logs. Relative remote paths are resolved under the SFTP session's starting directory (normally the user's home) and missing directories are created there.

The agent and /connect run in a background worker, so the TUI stays responsive while they work; a new submission sent before the current one finishes is rejected with a notice in the conversation panel.

Configuration reference

Troubleshooting

Additional resources