CLI

Pipe v0.50.5

Interaktywny terminal do zarządzania serwerem VPS przez agenta AI.

Działa na Twoim laptopie – łączy się zdalnie z backendem uruchomionym na serwerze przez automatyczny tunel SSH.

Jak to działa#

Twoj laptop
    +-- cli.py
          +-- automatycznie otwiera tunel SSH ->
          |       ssh -L 7379:127.0.0.1:7379 user@serwer
          +-- laczy sie przez tunel z agentem na serwerze
                        |
              serwer -- backend/server.py
                        |
              /tmp/vps-agent.sock + 127.0.0.1:7379 (tylko localhost)

CLI automatycznie zestawia tunel SSH – nie musisz nic robić ręcznie.

Po połączeniu CLI od razu pokazuje stan serwera jednym wierszem (bez modelu) i liczbę nowych wiadomości od Pipe. Gdy czekasz przy prompcie, wiadomości, które Pipe napisał sam (alerty, ustalenia, podpowiedzi), pojawiają się nad nim jako ramki – te same, o których Pipe powiadamia na Telegramie (/powiadomienia). Akcje wiadomości wybierasz w /nowosci, wpisując numer wiadomości i literę akcji, np. 1a.

Wymagania#

• Python 3.11+
• ssh dostępny w terminalu (which ssh)
• Konto SSH na serwerze
• Działający backend na serwerze (docker-compose up -d w katalogu backend/)

Instalacja#

pip install -r requirements.txt

Użycie#

# Podstawowe -- podaj adres serwera
python cli.py --host root@serwer.example.com

# Niestandardowy port SSH
python cli.py --host root@1.2.3.4 --ssh-port 2222

# Klucz SSH (jesli nie masz domyslnego w ~/.ssh/)
python cli.py --host root@1.2.3.4 --key ~/.ssh/id_serwer

# Zmienna srodowiskowa zamiast flagi (wygodne do codziennego uzycia)
export VPS_HOST=root@serwer.example.com
python cli.py

W trakcie pracy agenta pod Twoją wiadomością pojawia się szara linia na każdy krok – ✓ $ komenda (albo opis, np. czyta /etc/hosts) i do 4 linii wyniku pod nią; przy kodzie wyjścia innym niż 0 dopisek kod N, przy zmianie wykonanej bez pytania – bez pytania. W widoku prostym tych linii nie ma.

Jeśli masz już własny tunel SSH#

# Recznie zestawiasz tunel w tle
ssh -N -L 7379:127.0.0.1:7379 root@serwer.example.com &

# CLI z wylaczonym auto-tunnel
python cli.py --no-tunnel --local-port 7379

Pipe w Kubernetesie#

Zamiast tunelu SSH CLI zestawia kubectl port-forward svc/pipe (potrzebny kubectl i dostęp do klastra):

pipe --kube pipe                          # namespace, w ktorym dziala Pipe
pipe --kube pipe --kube-context prod      # inny kontekst kubeconfig

Interfejs w przeglądarce (pipe web)#

pipe web                  # zestawia tunel jak zwykle i otwiera http://127.0.0.1:7400/?k=...
pipe web --no-browser     # tylko wypisz adres
pipe web --web-port 8080  # inny port (albo zmienna PIPE_WEB_PORT)
pipe web --lang pl
pipe web --setup          # kreator od nowa: gdzie ma dzialac Pipe

Bez --host i bez zapisanego połączenia pipe web zaczyna od kreatora: co chcesz robić (widok prosty albo techniczny) i gdzie ma działać Pipe – na tym komputerze (Docker) albo na Twoim serwerze (adres i hasło albo klucz SSH; strona sama klonuje repozytorium i uruchamia instalator). Hasło zostaje na tym komputerze. Połączenie trafia do ~/.pipe/app.json i od tej pory pipe web oraz pipe bez --host łącza się same. Opis: docs/features.md (Widoki).

Ten sam proces co CLI: tunel SSH (albo --kube, --no-tunnel), a zamiast REPL-a – lokalna strona. Token backendu zostaje w procesie pipe web; przeglądarka dostaje tylko jednorazowy klucz w adresie. Strona działa wyłącznie na 127.0.0.1 i odrzuca żądania z obcym nagłówkiem Host albo Origin.

Na stronie: rozmowa i trzy zakładki panelu bocznego. Pulpit odpowiada bez modelu, czy wszystko działa (pierścienie procesora, pamięci i dysku, skrzynka Od Pipe z przyciskami akcji, karty projektów z warsztatu, zużycie modelu dziś), Schemat pokazuje serwer na żywo (trzy poziomy: serwery, wnętrze serwera, projekt compose; przycisk Śledzę agenta), Zmiany – różnice i cofanie. Skille uruchamiasz z listy /. Spinacz przy polu rozmowy (albo przeciągnięcie pliku, albo wklejenie zrzutu ekranu) dołącza pliki do wiadomości, a mikrofon nagrywa głosówkę. Po wpisaniu / w polu rozmowy rozwija się lista komend i skilli – działają te same komendy co poniżej. Przy pierwszym wejściu strona pyta o providera LLM (klucz API i model), a przełącznik nad polem rozmowy pozwala skakać między providerami, do których jest klucz (/provider). W odróżnieniu od REPL-a strona odbiera alerty i przypomnienia od razu. Szczegóły: clients/webui/README.md.

Most MCP (--mcp)#

pipe --mcp --host root@serwer zamienia CLI w serwer MCP (stdio) dla Claude Code, Cursora i innych agentów: narzędzia Pipe przez ten sam tunel SSH i token. Na stdout idzie tylko protokół MCP; tunel ma własny wolny port i nie pyta o hasło (BatchMode – potrzebny klucz SSH).

Gotowa konfiguracja dla konkretnej aplikacji – do wklejenia, z instrukcją, gdzie:

pipe connect claude --host root@serwer          # polecenie claude mcp add
pipe connect claude-desktop --host root@serwer  # claude_desktop_config.json
pipe connect cursor --host root@serwer          # ~/.cursor/mcp.json
pipe connect codex --host root@serwer           # ~/.codex/config.toml
pipe connect hermes --host root@serwer          # mcp_servers w config.yaml Hermes Agent
pipe connect openclaw --host root@serwer        # openclaw mcp add

Te same opcje co zwykle CLI (--ssh-port, --key, --kube). Token trafia zawsze do zmiennej AGENT_TOKEN, nigdy do argumentów procesu; bez --token w miejscu tokenu jest <TOKEN> i podpowiedź, jak utworzyć osobny token dla tej aplikacji (python3 -m backend.tokens add hermes --role admin). Ręcznie, np. w Claude Code:

{"mcpServers": {"pipe": {"command": "pipe", "args": ["--mcp", "--host", "root@serwer"],
                         "env": {"AGENT_TOKEN": "<token z python3 -m backend.tokens add claude-code>"}}}}

Diagramy#

Diagram (np. /mapa albo "narysuj architekturę") CLI zapisuje jako PNG w ~/.pipe/diagrams/ (PIPE_DIAGRAMS_DIR) i pokazuje jego podgląd ASCII, jeśli mieści się w terminalu. --open otwiera PNG w domyślnej przeglądarce obrazów, /mermaid wypisuje kod ostatniego diagramu (np. do README).

Postęp workerów (› web-1 $ uptime) jest wypisywany na bieżąco, zanim agent odpowie.

Zmienne środowiskowe#

Przykładowe komendy w CLI#

> ile mam wolnego miejsca na dysku?
> pokaz ostatnie bledy nginx
> zrestartuj docker compose
> sprawdz czy port 80 jest otwarty
> sprawdz uzycie RAM przez procesy
> pokaz status repozytoriow git
> wyswietl otwarte porty
> pokaz architekture serwera
> narysuj, jak zapytanie trafia do sklepu
> gdzie lezy repozytorium bloga?
> dodaj serwer 10.0.0.5 jako web-2 (ssh, root) i sprawdz na nim dysk
> sprawdz aktualizacje na wszystkich serwerach
> codziennie o 7 sprawdzaj backupy, pisz tylko jak cos jest nie tak

Wpisz exit lub naciśnij Ctrl+C aby wyjść.

Komendy#

Po wpisaniu / pod promptem pojawia się lista komend i skilli z opisami; zawęża się w trakcie pisania (pasuje nazwa polska, angielska i alias). Tab wstawia pierwszą pozycję, kolejne Tab / strzałki wybierają następne, strzałka w górę przywołuje wcześniejsze wpisy. Wymaga prompt_toolkit (jest w requirements.txt) w tym samym Pythonie / venv, z którego startuje pipe – CLI przy starcie podaje gotowe polecenie instalacji, gdy go brakuje; bez niego CLI działa jak dotąd, bez podpowiedzi.

Każda komenda ma angielski alias, który działa w obu językach: /report, /changes, /chart, /health, /audit, /news, /projects, /cleanup, /notifications, /map, /directory, /skills, /alerts, /incidents, /routines, /targets, /journal, /undo, /patch, /approvals, /cost, /history, /providers, /language, /help. Bez --lang CLI i pipe web mówią językiem serwera; pipe --lang pl przełącza komunikaty CLI na polski tylko w tym uruchomieniu; /jezyk pl (/language en) zmienia język całego Pipe – instrukcje agenta, raporty, komunikaty – bez restartu, także w pipe web i na Telegramie. Wybór zostaje po restarcie i CLI przejmuje go przy połączeniu (chyba że podano --lang).

Tekst zaczynający się od /, który nie jest komenda (np. /var/log jest pelny?), trafia do agenta jak zwykła wiadomość.

Uruchomienie bezpośrednio na serwerze#

Po zalogowaniu przez SSH na serwer możesz rozmawiać z agentem bez tunelu – backend wystawia port 7379 na 127.0.0.1 serwera:

pip install -r clients/cli/requirements.txt   # jednorazowo
python3 clients/cli/cli.py --no-tunnel        # + --token ..., jesli ustawiles AGENT_TOKEN

install.sh buduje skrót z tunelem SSH, więc na samym serwerze wygodniej dodać alias ręcznie, np. alias pipe='python3 ~/Pipe/clients/cli/cli.py --no-tunnel'. Pamięć agenta (SERVER.md, skille) jest wspólna dla wszystkich klientów – to, co agent zapisze w Telegramie, widać w terminalu i odwrotnie. Wyjątkiem jest VIBE: notatka o stylu jest osobna dla każdego użytkownika (cli:<login>, telegram:<id>).

Popraw tę stronę na GitHubie