# chrapuch/mercury architecture

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

- Interactive diagram: https://gitdiagram.com/chrapuch/mercury
- Repository: https://github.com/chrapuch/mercury

## Overview

Mercury-SSH is an Android remote for launching preconfigured commands on SSH servers. Users load JSON server configurations, choose a server and command, then the app runs it remotely; optional confirmation or sudo-password prompts are mediated through UI events. The README also describes key management, configuration/settings, logs, and help. Edges reflect explicit excerpts, SOURCE INDEX references, or README statements; unsampled feature wiring is omitted where its caller is not established.

Main entry points: [`app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java`](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java) (Main screen), [`app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java`](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java) (Regular command), [`app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java`](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java) (Settings screen), [`app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java`](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java) (Command list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Android UI"]
  node_main["Main screen<br/>[MainActivity.java]"]
  node_serverview["Server commands"]
  node_commandlist["Command list"]
  node_settingsui["Settings screen"]
  node_logui["Log screen<br/>[LogFragment.java]"]
  node_helpui["Help screen<br/>[HelpActivity.java]"]
end

subgraph group_config["Configuration"]
  node_configmgr["Config loading<br/>[ConfigManager.java]"]
  node_mapper["JSON validation<br/>[ServerMapper.java]"]
  node_server["Server settings<br/>[Server.java]"]
  node_command["Command settings<br/>[Command.java]"]
end

subgraph group_ssh["SSH execution"]
  node_sshmanager["SSH credentials<br/>[SshManager.java]"]
  node_regular["Regular command"]
  node_sshbase["SSH session<br/>[SshCommand.java]"]
  node_events["SSH UI events"]
  node_eventmodels["Prompt events"]
  node_handoff["Prompt handoff"]
  node_pubkey["Public key command"]
end

subgraph group_support["Key and activity support"]
  node_app["Application services"]
  node_logs["Log adapter"]
end

node_user(("User"))
node_remote(("Remote server"))

node_user -->|"operates"| node_main
node_main -->|"loads configs"| node_configmgr
node_configmgr -->|"parses JSON"| node_mapper
node_mapper -->|"maps fields"| node_server
node_mapper -->|"maps commands"| node_command
node_main -->|"pages servers"| node_serverview
node_serverview -->|"renders commands"| node_commandlist
node_commandlist -->|"reads command"| node_command
node_commandlist -->|"starts command"| node_regular
node_regular -->|"uses session"| node_sshbase
node_regular -->|"loads keys"| node_sshmanager
node_sshbase -->|"runs command"| node_remote
node_regular -->|"posts prompts"| node_eventmodels
node_events -->|"returns answers"| node_handoff
node_eventmodels -->|"carries response"| node_handoff
node_main -->|"registers subscriber"| node_events
node_settingsui -->|"exports key"| node_sshmanager
node_settingsui -->|"starts key send"| node_pubkey
node_pubkey -->|"uses key store"| node_sshmanager
node_settingsui -->|"registers subscriber"| node_events
node_user -->|"configures app"| node_settingsui
node_user -->|"views logs"| node_logui
node_user -->|"opens help"| node_helpui
node_logui -->|"uses adapter"| node_logs

click node_main "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java"
click node_serverview "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/fragment/ServerFragment.java"
click node_commandlist "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java"
click node_settingsui "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java"
click node_logui "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/fragment/LogFragment.java"
click node_helpui "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/HelpActivity.java"
click node_configmgr "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/manager/ConfigManager.java"
click node_mapper "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/jackson/ServerMapper.java"
click node_server "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/config/Server.java"
click node_command "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/config/Command.java"
click node_sshmanager "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/manager/SshManager.java"
click node_regular "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java"
click node_sshbase "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommand.java"
click node_events "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshEventSubscriber.java"
click node_eventmodels "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/event/SshCommandConfirm.java"
click node_handoff "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandDrop.java"
click node_pubkey "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandPubKey.java"
click node_app "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/MercuryApplication.java"
click node_logs "https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/adapter/LogListAdapter.java"

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_main,node_serverview,node_commandlist,node_settingsui,node_logui,node_helpui,node_user toneBlue
class node_configmgr,node_mapper,node_server,node_command toneAmber
class node_sshmanager,node_regular,node_sshbase,node_events,node_eventmodels,node_handoff,node_pubkey,node_remote toneMint
class node_app,node_logs toneRose
```

## Components

### Android UI

- [Main screen](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java): `app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java`
- [Server commands](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/fragment/ServerFragment.java): `app/src/main/java/it/skarafaz/mercury/fragment/ServerFragment.java`
- [Command list](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java): `app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java`
- [Settings screen](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java): `app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java`
- [Log screen](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/fragment/LogFragment.java): `app/src/main/java/it/skarafaz/mercury/fragment/LogFragment.java`
- [Help screen](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/activity/HelpActivity.java): `app/src/main/java/it/skarafaz/mercury/activity/HelpActivity.java`

### Configuration

- [Config loading](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/manager/ConfigManager.java): `app/src/main/java/it/skarafaz/mercury/manager/ConfigManager.java`
- [JSON validation](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/jackson/ServerMapper.java): `app/src/main/java/it/skarafaz/mercury/jackson/ServerMapper.java`
- [Server settings](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/config/Server.java): `app/src/main/java/it/skarafaz/mercury/model/config/Server.java`
- [Command settings](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/config/Command.java): `app/src/main/java/it/skarafaz/mercury/model/config/Command.java`

### SSH execution

- [SSH credentials](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/manager/SshManager.java): `app/src/main/java/it/skarafaz/mercury/manager/SshManager.java`
- [Regular command](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java): `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java`
- [SSH session](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommand.java): `app/src/main/java/it/skarafaz/mercury/ssh/SshCommand.java`
- [SSH UI events](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshEventSubscriber.java): `app/src/main/java/it/skarafaz/mercury/ssh/SshEventSubscriber.java`
- [Prompt events](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/model/event/SshCommandConfirm.java): `app/src/main/java/it/skarafaz/mercury/model/event/SshCommandConfirm.java`
- [Prompt handoff](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandDrop.java): `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandDrop.java`
- [Public key command](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/ssh/SshCommandPubKey.java): `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandPubKey.java`

### Key and activity support

- [Application services](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/MercuryApplication.java): `app/src/main/java/it/skarafaz/mercury/MercuryApplication.java`
- [Log adapter](https://github.com/chrapuch/mercury/blob/master/app/src/main/java/it/skarafaz/mercury/adapter/LogListAdapter.java): `app/src/main/java/it/skarafaz/mercury/adapter/LogListAdapter.java`

### Other components

- **User**
- **Remote server**

## Connections

- User → Main screen: operates (evidence: `README.md`)
- Main screen → Config loading: loads configs (evidence: `app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java`)
- Config loading → JSON validation: parses JSON (evidence: `app/src/main/java/it/skarafaz/mercury/manager/ConfigManager.java`)
- JSON validation → Server settings: maps fields (evidence: `app/src/main/java/it/skarafaz/mercury/jackson/ServerMapper.java`)
- JSON validation → Command settings: maps commands (evidence: `app/src/main/java/it/skarafaz/mercury/jackson/ServerMapper.java`)
- Main screen → Server commands: pages servers (evidence: `app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java`)
- Server commands → Command list: renders commands (evidence: `app/src/main/java/it/skarafaz/mercury/fragment/ServerFragment.java`)
- Command list → Command settings: reads command (evidence: `app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java`)
- Command list → Regular command: starts command (evidence: `app/src/main/java/it/skarafaz/mercury/adapter/CommandListAdapter.java`)
- Regular command → SSH session: uses session (evidence: `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java`)
- Regular command → SSH credentials: loads keys (evidence: `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java`)
- SSH session → Remote server: runs command (evidence: `README.md`)
- Regular command → Prompt events: posts prompts (evidence: `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandRegular.java`)
- SSH UI events → Prompt handoff: returns answers (evidence: `app/src/main/java/it/skarafaz/mercury/ssh/SshEventSubscriber.java`)
- Prompt events → Prompt handoff: carries response (evidence: `app/src/main/java/it/skarafaz/mercury/model/event/SshCommandConfirm.java`)
- Main screen → SSH UI events: registers subscriber (evidence: `app/src/main/java/it/skarafaz/mercury/activity/MainActivity.java`)
- Settings screen → SSH credentials: exports key (evidence: `app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java`)
- Settings screen → Public key command: starts key send (evidence: `app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java`)
- Public key command → SSH credentials: uses key store (evidence: `app/src/main/java/it/skarafaz/mercury/ssh/SshCommandPubKey.java`)
- Settings screen → SSH UI events: registers subscriber (evidence: `app/src/main/java/it/skarafaz/mercury/activity/SettingsActivity.java`)
- User → Settings screen: configures app (evidence: `README.md`)
- User → Log screen: views logs (evidence: `README.md`)
- User → Help screen: opens help (evidence: `README.md`)
- Log screen → Log adapter: uses adapter (evidence: `app/src/main/java/it/skarafaz/mercury/fragment/LogFragment.java`)
