# s1community/s1-command-center architecture

> Architecture diagram of the GitHub repository s1community/s1-command-center, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/s1community/s1-command-center
- Repository: https://github.com/s1community/s1-command-center

## Overview

S1 Command Center is a desktop administration tool for SentinelOne engineers. The main workflow is to connect source and destination consoles, back up configuration, prepare and restore it, then review or export results. Agent migration is a separate guided workflow: read destination scopes, match source scopes, and move agents. Operations pages provide direct console management and auditing. The excerpts show the main modules and several helper relationships; some feature details are documented only in the README, so those subsystems are represented at module level.

Main entry points: [`app.py`](https://github.com/s1community/s1-command-center/blob/main/app.py) (Main window), [`pages.py`](https://github.com/s1community/s1-command-center/blob/main/pages.py) (Backup and restore), [`pages_extra.py`](https://github.com/s1community/s1-command-center/blob/main/pages_extra.py) (Operations pages), [`s1_api.py`](https://github.com/s1community/s1-command-center/blob/main/s1_api.py) (SentinelOne API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_entry["App entry<br/>[main.py]"]
  node_app_ui["Main window<br/>[app.py]"]
end

subgraph group_config_migration["Configuration migration"]
  node_backup_restore["Backup and restore<br/>[pages.py]"]
  node_migration_helpers["Migration helpers<br/>[migtools.py]"]
end

subgraph group_agent_migration["Agent migration"]
  node_agent_workflow["Agent migration<br/>[agent_migrator.py]"]
end

subgraph group_operations["Console operations"]
  node_operation_pages["Operations pages<br/>[pages_extra.py]"]
  node_tag_audit["Tag audit<br/>[tag_audit.py]"]
end

subgraph group_shared["Shared services"]
  node_settings[("Connection settings<br/>[config.py]")]
  node_api_client["SentinelOne API client<br/>[s1_api.py]"]
  node_reporting["Report exports<br/>[export_utils.py]"]
end

node_administrator(("Administrator"))
node_sentinelone{{"SentinelOne consoles"}}

node_administrator -->|"launches"| node_entry
node_entry -->|"starts"| node_app_ui
node_app_ui -->|"loads connections"| node_settings
node_app_ui -->|"opens pages"| node_backup_restore
node_app_ui -->|"opens workflow"| node_agent_workflow
node_app_ui -->|"opens pages"| node_operation_pages
node_backup_restore -->|"uses API"| node_api_client
node_backup_restore -->|"uses helpers"| node_migration_helpers
node_backup_restore -->|"exports reports"| node_reporting
node_agent_workflow -->|"uses API"| node_api_client
node_agent_workflow -->|"exports reports"| node_reporting
node_operation_pages -->|"uses API"| node_api_client
node_operation_pages -->|"uses audit"| node_tag_audit
node_operation_pages -->|"exports reports"| node_reporting
node_tag_audit -->|"queries tags"| node_api_client
node_api_client -->|"sends requests"| node_sentinelone
node_backup_restore -->|"backs up and restores"| node_sentinelone
node_agent_workflow -->|"reads and moves agents"| node_sentinelone
node_operation_pages -->|"manages console"| node_sentinelone

click node_entry "https://github.com/s1community/s1-command-center/blob/main/main.py"
click node_app_ui "https://github.com/s1community/s1-command-center/blob/main/app.py"
click node_settings "https://github.com/s1community/s1-command-center/blob/main/config.py"
click node_backup_restore "https://github.com/s1community/s1-command-center/blob/main/pages.py"
click node_migration_helpers "https://github.com/s1community/s1-command-center/blob/main/migtools.py"
click node_agent_workflow "https://github.com/s1community/s1-command-center/blob/main/agent_migrator.py"
click node_operation_pages "https://github.com/s1community/s1-command-center/blob/main/pages_extra.py"
click node_tag_audit "https://github.com/s1community/s1-command-center/blob/main/tag_audit.py"
click node_api_client "https://github.com/s1community/s1-command-center/blob/main/s1_api.py"
click node_reporting "https://github.com/s1community/s1-command-center/blob/main/export_utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_app_ui toneBlue
class node_backup_restore,node_migration_helpers toneAmber
class node_agent_workflow toneMint
class node_operation_pages,node_tag_audit toneRose
class node_settings,node_api_client,node_reporting,node_administrator,node_sentinelone toneIndigo
```

## Components

### Desktop app

- [App entry](https://github.com/s1community/s1-command-center/blob/main/main.py): `main.py`
- [Main window](https://github.com/s1community/s1-command-center/blob/main/app.py): `app.py`

### Configuration migration

- [Backup and restore](https://github.com/s1community/s1-command-center/blob/main/pages.py): `pages.py`
- [Migration helpers](https://github.com/s1community/s1-command-center/blob/main/migtools.py): `migtools.py`

### Agent migration

- [Agent migration](https://github.com/s1community/s1-command-center/blob/main/agent_migrator.py): `agent_migrator.py`

### Console operations

- [Operations pages](https://github.com/s1community/s1-command-center/blob/main/pages_extra.py): `pages_extra.py`
- [Tag audit](https://github.com/s1community/s1-command-center/blob/main/tag_audit.py): `tag_audit.py`

### Shared services

- [Connection settings](https://github.com/s1community/s1-command-center/blob/main/config.py): `config.py`
- [SentinelOne API client](https://github.com/s1community/s1-command-center/blob/main/s1_api.py): `s1_api.py`
- [Report exports](https://github.com/s1community/s1-command-center/blob/main/export_utils.py): `export_utils.py`

### Other components

- **Administrator**
- **SentinelOne consoles**

## Connections

- Administrator → App entry: launches (evidence: `README.md`)
- App entry → Main window: starts (evidence: `main.py`)
- Main window → Connection settings: loads connections (evidence: `app.py`)
- Main window → Backup and restore: opens pages (evidence: `app.py`)
- Main window → Agent migration: opens workflow (evidence: `app.py`)
- Main window → Operations pages: opens pages (evidence: `app.py`)
- Backup and restore → SentinelOne API client: uses API (evidence: `pages.py`)
- Backup and restore → Migration helpers: uses helpers (evidence: `pages.py`)
- Backup and restore → Report exports: exports reports (evidence: `pages.py`)
- Agent migration → SentinelOne API client: uses API (evidence: `agent_migrator.py`)
- Agent migration → Report exports: exports reports (evidence: `agent_migrator.py`)
- Operations pages → SentinelOne API client: uses API (evidence: `pages_extra.py`)
- Operations pages → Tag audit: uses audit (evidence: `pages_extra.py`)
- Operations pages → Report exports: exports reports (evidence: `pages_extra.py`)
- Tag audit → SentinelOne API client: queries tags (evidence: `tag_audit.py`)
- SentinelOne API client → SentinelOne consoles: sends requests (evidence: `README.md`)
- Backup and restore → SentinelOne consoles: backs up and restores (evidence: `README.md`)
- Agent migration → SentinelOne consoles: reads and moves agents (evidence: `README.md`)
- Operations pages → SentinelOne consoles: manages console (evidence: `README.md`)
