Project overview — Shell Sentinel

Mission

Deliver a terminal-native AI copilot that keeps persistent SSH/SFTP sessions, speaks natural language and brings human-friendly operations to critical infrastructure.

Technical stack

• Python 3.12, Textual 8.2.7 for the TUI, Strands Agents SDK ≥1.45 for conversational reasoning.
• Reproducible installs via pyproject.toml and pip-tools lockfiles (make lock, make install).
• Custom tools: remote_ssh_command, remote_sftp_transfer, local_datetime.
• Firecrawl MCP tools available for research, scraping and structured extraction.

Key responsibilities

• Keep configuration centralized in conf/; no hardcoded values in code.
• Update translations, manuals and the static website whenever behaviour changes.
• Document custom providers and plugin rules; each plugin must ship with concise operator documentation.
• Respect security policies (no plain-text secrets, environment variables only).

Workflow

1. Create virtualenv with python3.12 -m venv .venv and activate it.
2. Install dependencies via make install.
3. Before PRs, run make format, make lint, make test.
4. Validate the TUI with make run and the website with make website-serve.

For complete policies refer to the contributor handbook and internal governance documents. Treat the static site as part of the documentation contract.