# 8b1t/8terminal-termius-migrator architecture

> Architecture diagram of the GitHub repository 8b1t/8terminal-termius-migrator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/8b1t/8terminal-termius-migrator
- Repository: https://github.com/8b1t/8terminal-termius-migrator

## Overview

This is a one-purpose macOS migration utility: the user runs it to read saved Termius hosts, groups, and supported port-forwarding rules, then writes a capture file. The separate 8Terminal app imports that file and lets the user review items before saving them to its vault. The tree contains only README.md, so implementation paths and internal code relationships cannot be established; the diagram shows documented behavior only.

Main entry points: [`README.md`](https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md) (Termius Migrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_migrator["Termius Migrator<br/>[README.md]"]
node_termius[("Termius data")]
node_capture["Capture JSON"]
node_importer["8Terminal importer<br/>[README.md]"]
node_review["Import review<br/>[README.md]"]
node_vault[("8Terminal vault")]

node_user -->|"runs"| node_migrator
node_migrator -->|"reads hosts"| node_termius
node_migrator -->|"writes file"| node_capture
node_user -->|"chooses file"| node_importer
node_capture -->|"provides data"| node_importer
node_importer -->|"presents items"| node_review
node_review -->|"saves approved"| node_vault

click node_migrator "https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md"
click node_importer "https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md"
click node_review "https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md"

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_user,node_review toneBlue
class node_migrator,node_importer toneTeal
class node_termius,node_vault toneAmber
class node_capture toneIndigo
```

## Components

### Other components

- **User**
- [Termius Migrator](https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md): `README.md`
- **Termius data**
- **Capture JSON**
- [8Terminal importer](https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md): `README.md`
- [Import review](https://github.com/8b1t/8terminal-termius-migrator/blob/main/README.md): `README.md`
- **8Terminal vault**

## Connections

- User → Termius Migrator: runs
- Termius Migrator → Termius data: reads hosts
- Termius Migrator → Capture JSON: writes file
- User → 8Terminal importer: chooses file
- Capture JSON → 8Terminal importer: provides data
- 8Terminal importer → Import review: presents items
- Import review → 8Terminal vault: saves approved