HORNCALL

One app to approve them all.

English

Twój agent AI nie musi czekać, aż wrócisz do biurka. Horncall wysyła jego prośby o zgodę na telefon — zatwierdzasz jednym ruchem, a agent pracuje dalej. Jedna aplikacja dla Claude Code, OpenAI Codex CLI, Gemini CLI i GitHub Copilot CLI; szyfrowanie end-to-end, każda decyzja podpisana kluczem telefonu.

Co to robi

• Działa z Claude Code, Gemini CLI, GitHub Copilot CLI i OpenAI Codex CLI. Jedno parowanie obsługuje wszystkie AI na danym komputerze, a każdy czat to osobny „żołnierz” z kryptonimem, np. Shaman Ashbringer (Claude) czy Gearwright Swiftfoot (Codex).
• Pytanie widać jednocześnie na komputerze i na telefonie. Odpowiesz na komputerze — rozkaz sam znika z telefonu. Przegapisz — czeka na telefonie do 30 minut, a telefon przypomina o nim co 2 minuty.
• Działa z każdej sieci (Wi-Fi, LTE). Treść jest szyfrowana end-to-end; serwer pośredniczący widzi tylko szyfrogram.
• Nic nie zatwierdza się samo. Każdy błąd (brak sieci, brak odpowiedzi) kończy się zwykłym pytaniem na komputerze.

Czego potrzebujesz

Instalacja (10 minut)

1. Aplikacja na telefonie

1. Na telefonie pobierz horncall.apk i otwórz plik.
2. Android zapyta o zgodę na instalację z tego źródła — zezwól. Jeśli Play Protect ostrzeże o nieznanym deweloperze, wybierz Zainstaluj mimo to (aplikacji nie ma jeszcze w Sklepie Play).
3. Uruchom Horncall i kliknij Napraw na każdej karcie u góry: powiadomienia, wyświetlanie na pełnym ekranie, wyłączenie optymalizacji baterii. Bez tego rozkazy mogą się spóźniać.

2. Komputer — kreator

1. Pobierz horncall-plugin.zip i rozpakuj do stałego folderu, np. C:\Narzedzia\horncall. Nie do Pobranych i nie przenoś go potem — asystenci AI uruchamiają Horncall z tego miejsca.
2. Kliknij dwa razy setup.cmd (macOS/Linux: sh setup.sh). Kreator:
   • znajdzie zainstalowane AI i zapyta, które podpiąć (Claude Code dostanie plugin automatycznie),
   • zapyta, czy pokazywać na telefonie limit Claude (dodaje mały pasek statusu w Claude Code),
   • otworzy w przeglądarce kod QR — w aplikacji kliknij Rekrutuj (skanuj QR) i zeskanuj go,
   • wyśle rozkaz próbny — odpowiedz na telefonie. Od tej chwili komputer ufa właśnie temu telefonowi.

   === Horncall setup ===
   
   1/4  AI tools on this PC
      ✓ Claude Code          found
      ✓ OpenAI Codex CLI     found
      · Gemini CLI           not found
   2/4  Hook up
      Connect Claude Code? [Y/n]
   3/4  Phone
      Scan the QR code in the browser
   4/4  Test order — answer it on the phone
      ✓ The phone answered (allow) — trusted, key 2F:35:EC:D9:37:F3

3. Uruchom ponownie podpięte narzędzia (VS Code: Ctrl+Shift+P → Developer: Reload Window).

Chcesz najpierw zobaczyć, jak to wygląda? W aplikacji pod przyciskami rekrutacji jest Pokaż przykładowy rozkaz — działa bez komputera.

Nowe AI dopniesz później, uruchamiając kreator jeszcze raz — niczego nie zepsuje, doda tylko to, czego brakuje.

/plugin marketplace add C:/Narzedzia/horncall
/plugin install horncall@horncall
/horncall:approver pair
/horncall:approver test

Na co dzień

Horncall przekazuje pytania na telefon tylko w trybie on — przy biurku odpowiadasz jak zwykle.

Bez Claude Code (np. tylko Codex) te same komendy: python C:\Narzedzia\horncall\plugin\hooks\approver_launcher.py on. Tryb dotyczy wszystkich AI i czatów na tym komputerze.

Odpowiadanie na rozkazy

Paski na karcie: TIME — ile zostało czasu na odpowiedź; HP i MEM — „zdrowie” żołnierza (niżej); MANA — ile zostało do końca służby (on --hours).

Groźne komendy — np. rm -rf, git push --force, git reset --hard, DROP TABLE, terraform destroy, curl … | bash, zmiany w .env, hookach, CI albo w ustawieniach samych AI, narzędzia MCP z nazwą typu delete, execute, send — mają czerwoną kartę z powodami. Nie da się ich zatwierdzić gestem ani z powiadomienia: trzeba przytrzymać przycisk przez półtorej sekundy.

Koszary, HP i statystyki

• Dotknij żołnierza — zobaczysz jego ostatni rozkaz w całości i jak się skończył (zatwierdzony biczem, odmówiony, odpowiedziano na komputerze…).
• Pod każdym komputerem są jego żołnierze — czaty z ostatnich 24 godzin. Znaczek pokazuje AI (frakcję): Claude, Gemini, Copilot, Codex — każde ma własne rangi.
• ● Pracuje 3 min 12 s — zadanie w toku; Skończył 5 min temu · pracował 14 min — gotowe. Po zadaniu dłuższym niż 2 minuty żołnierz melduje „Mission complete”. Po 8 godzinach ciszy żołnierz śpi 💤, po 24 znika.
• HP — ile zostało limitu planu tego AI (zanim przestanie odpowiadać) i kiedy się odnowi (↻). MEM — ile zostało pamięci czatu; gdy spadnie do zera, AI streszcza starszą część rozmowy, a nowy czat zaczyna od 100%. Poniżej 10% HP karta rozkazu ostrzega „Mało limitu”.

Kafelki u góry: rozkazy, zatwierdzone, odmowy, łączny czas pracy AI, zatwierdzenia biczem. Dotknij ich — Raport bojowy rozbija to na poszczególne AI. Pasek Horda mówi, ilu użytkowników Horncall jest teraz online.

Trening bicza

Ikona bicza u góry ekranu otwiera trening: strzelasz, a aplikacja pokazuje siłę strzału i czy zatwierdziłby rozkaz. Na start zrób kalibrację (ok. 30 s): 5 normalnych strzałów i 3 razy zwykłe podniesienie telefonu. Próg ustawi się wyraźnie powyżej zwykłego podnoszenia, żeby nic nie zatwierdziło się przypadkiem. Mocniejszy strzał = głośniejszy trzask; dwa razy mocniej niż próg to CRITICAL. Trening nie zatwierdza prawdziwych rozkazów i nie zmienia statystyk.

Gemini, Copilot, Codex — na co uważać

• Gemini CLI pyta o zgodę sam, zanim zapyta Horncall. Żeby pytał tylko telefon, uruchamiaj go z --approval-mode yolo — Horncall i tak przepuszcza przez telefon komendy, zapisy i edycje plików. Logowanie kontem Google nie działa już dla osób prywatnych — użyj klucza API.
• Codex CLI: po podpięciu otwórz w Codexie /hooks, zaufaj trzem hookom Horncall i włącz je spacją ([x]). Działa w zwykłym, interaktywnym Codexie (nie w codex exec).
• Copilot CLI: działa od razu po ponownym uruchomieniu.
• Claude Code: limit planu (HP) Claude podaje tylko paskowi statusu; kreator może go dodać (approver install claude-statusline, wyłączenie: uninstall). Jeśli miałeś własny pasek — dalej się wyświetla.

Ustawienia aplikacji

Aplikacja mówi po polsku albo po angielsku — zgodnie z językiem telefonu.

Bezpieczeństwo i prywatność

• Rozkazy idą przez nasz serwer (ntfy w chmurze, HTTPS, plus Firebase do budzenia telefonu), zaszyfrowane kluczem, który znają tylko Twój komputer i Twoje telefony.
• Telefon podpisuje każdą decyzję kluczem, który nigdy go nie opuszcza (Android Keystore). Komputer przyjmuje odpowiedzi tylko od zaufanych telefonów — nawet kopia pliku z kluczem z komputera nie wystarczy, żeby coś zatwierdzić.
• Klucz na komputerze: ~/.horncall/config.json (na Windows dostępny tylko dla Twojego konta).
• Na telefon trafia treść pytania (komenda, ścieżka pliku) oraz liczby HP/MEM — nigdy cała rozmowa z AI. Log ~/.horncall/hook.log zapisuje tylko metadane.
• Horncall niczego nie wykonuje sam — przekazuje tylko Twoją decyzję.

Aktualizacje

• Aplikacja sama sprawdza nowe wersje — w Koszarach pojawi się zielona karta z listą zmian; kliknij Pobierz i zainstaluj. Parowanie i statystyki zostają. Nie odinstalowuj starej wersji (Android skasowałby dane).
• Program na komputerze: /horncall:approver update (albo approver update) pobiera nową wersję, sprawdza jej podpis i instaluje. Potem uruchom ponownie Claude Code. status mówi, gdy jest coś nowego. (Wersje starsze niż 0.5.10 trzeba raz zaktualizować ręcznie: pobierz ZIP i rozpakuj w to samo miejsce.)

Problemy

Odinstalowanie

/horncall:approver unpair
/plugin uninstall horncall@horncall
approver uninstall gemini      (i copilot, codex, claude-statusline — jeśli podpięte)

Potem usuń folder programu i katalog ~/.horncall, a na telefonie odinstaluj aplikację.