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.10+, Textual for the TUI, Strands Agents SDK for conversational reasoning.
• 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/activate virtualenv.
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.