📚 Dokumentasi OpsTerm

Selamat datang di dokumentasi OpsTerm! Di sini lu bakal paham gimana OpsTerm bekerja, teknologi yang dipake, dan kenapa dirancang seperti ini.

📖 Daftar Dokumen

Dokumen	Deskripsi	Juga tersedia dalam
📐 Arsitektur & System Design	Cara kerja OpsTerm — alur dari user ngetik command sampai eksekusi	🇬🇧 English
🔧 Tech Stack	Teknologi yang dipake — bahasa, library, protocol, format	🇬🇧 English
🤔 Design Decisions	Kenapa dirancang seperti ini — alasan di balik setiap keputusan teknis	🇬🇧 English
🎯 Fitur Lengkap	Semua fitur — daftar lengkap + contoh penggunaan + use case matrix	🇬🇧 English
📊 Architecture Diagram	Diagram Excalidraw — buka di excalidraw.com	—
🖼️ Architecture Diagram (PNG)	Diagram versi gambar — langsung liat	—

🚀 Quick Overview

┌─────────────────────────────────────────────────────┐
│                  USER LAPTOP                         │
│  ┌───────────────────────────────────────────────┐  │
│  │  $ ai ssh vps-utama                           │  │
│  │  $ ai "how to check disk"                     │  │
│  │  $ docker ps | ai "error?"                    │  │
│  └───────────────┬───────────────────────────────┘  │
│                  │                                   │
│  ┌───────────────▼───────────────────────────────┐  │
│  │           OpsTerm (bin/ai)                     │  │
│  │  ┌─────────┐ ┌────────┐ ┌────────┐ ┌──────┐  │  │
│  │  │ AI      │ │ SSH    │ │ SCP    │ │Vault │  │  │
│  │  │ Client  │ │ Runner │ │ Transfer│ │      │  │  │
│  │  └────┬────┘ └───┬────┘ └───┬────┘ └──┬───┘  │  │
│  └───────┼──────────┼──────────┼─────────┼───────┘  │
│          │          │          │         │           │
└──────────┼──────────┼──────────┼─────────┼───────────┘
           │          │          │         │
     ┌─────▼──┐ ┌────▼───┐ ┌───▼────┐ ┌──▼────────┐
     │AI API  │ │SSH     │ │Server  │ │Local File  │
     │Provider│ │ Server │ │Filesys │ │System      │
     └────────┘ └────────┘ └────────┘ └────────────┘

Prinsip utama: OpsTerm jalan di laptop lokal. AI-nya nempel di terminal, bukan di server remote. Jadi pas SSH ke server mana pun, AI tetep bisa dipake.

📁 Struktur Project

~/opsterm/
├── bin/
│   └── ai                    ← Main script (single file, ~1500 baris)
├── completions/
│   ├── opsterm.bash          ← Bash tab completion
│   └── opsterm.zsh           ← Zsh tab completion
├── zsh/
│   └── opsterm.plugin.zsh    ← Zsh shell integration plugin
├── docs/                     ← Dokumentasi ini
│   ├── en/                   ← Dokumentasi English
│   │   ├── README.md         ← Index
│   │   ├── architecture.md   ← Architecture & system design
│   │   ├── tech-stack.md     ← Tech stack details
│   │   ├── design-decisions.md← Design rationale
│   │   └── features.md       ← All features
│   ├── id/                   ← Dokumentasi Indonesia
│   │   ├── README.md         ← Index
│   │   ├── architecture.md   ← Arsitektur & system design
│   │   ├── tech-stack.md     ← Tech stack
│   │   ├── design-decisions.md← Design decisions
│   │   └── features.md       ← Fitur lengkap
│   ├── ops-term-architecture.excalidraw ← Diagram Excalidraw
│   └── ops-term-architecture.png        ← Diagram versi gambar
├── setup.sh                  ← Install script
├── README.md                 ← English README
├── README.id.md              ← Indonesian README
└── .gitignore

Config user (gitignored, di ~/.ai-workflows/):

~/.ai-workflows/
├── config.yaml       ← AI provider settings
├── servers.yaml      ← Daftar server + proxy
├── workflows.yaml    ← Daftar workflow
├── vault.json        ← Credential terenkripsi
├── history.db        ← Riwayat SQLite
└── last_*.txt        ← Output command terakhir

🧠 Filosofi Design

Zero dependencies — cukup Python 3 stdlib, ga perlu pip install apa-apa (kecuali vault)
Single file — bin/ai bisa dicopy ke server mana pun dan langsung jalan
Local-first — AI di terminal lokal, bukan di server. Bisa SSH tanpa kehilangan AI
Config as code — server & workflow config pake YAML, bisa di-version control
Progressive disclosure — fitur sederhana gampang dipake, fitur kompleks available kalo butuh

🎯 Recommended Reading Order

📐 Arsitektur & System Design — paham alur kerja
🔧 Tech Stack — teknologi yang dipake
🤔 Design Decisions — kenapa milih ini
📊 Architecture Diagram — visual overview (buka di excalidraw.com)

Selanjutnya: 📐 Arsitektur & System Design →