CLI Doctor

Twoje CLI agenta padło przy starcie.
Oto dokładnie dlaczego.

CLI agenta, które nie chce wystartować, to najbardziej demotywująca awaria w kodowaniu z AI: brak wyjścia, brak stack trace, czasem tylko wracający znak zachęty. CLI Doctor łapie ten moment, czyta, co się naprawdę stało, i odpowiada na jedyne pytanie, które ma znaczenie: co się zepsuło i co mam teraz zrobić.

Zna dokładną komendę, którą uruchomił AgentsRoom, wie, która flaga pochodzi z którego ustawienia, i wie, co CLI wypisało, zanim się poddało. Tego kontekstu wynik z wyszukiwarki nigdy nie ma.

Pobierz AgentsRoomZa darmoZobacz, jak to działa

CLI Doctor

Uruchomienie nieudane

$ claude --model opus-5 --mcp-debug

error: unknown option '--mcp-debug'

Nieudane uruchomienie, prawdziwy błąd i diagnoza wskazująca odpowiedzialne ustawienie.

CLI agentów zmieniają się szybko. Flaga znika w wydaniu minor, plik binarny wypada z PATH po aktualizacji Node, logowanie wygasa, sandbox odmawia startu, plik konfiguracyjny napisany dla innego narzędzia zostaje podchwycony. Po Twojej stronie efekt zawsze jest ten sam: wysyłasz prompt i nic się nie dzieje.

Trudna część to nigdy nie jest poprawka. Chodzi o to, żeby wiedzieć, która z dwudziestu rzeczy w komendzie uruchomieniowej jest tą, która się zepsuła, i czy wzięła się z aplikacji, z ustawień dostawcy, z nadpisania, które trzy tygodnie temu ustawiłeś na tym jednym agencie, czy z samego CLI, które zmieniło się pod Tobą.

CLI Doctor domyka tę lukę. Trzyma zapis dokładnej komendy, która została uruchomiona, oznacza każdą pojedynczą flagę ustawieniem, które ją wstrzyknęło, przechwytuje to, co CLI wypisało, i zamienia to wszystko w krótką diagnozę z konkretnymi krokami. Deterministyczne sprawdzenia zawsze idą pierwsze i mają pierwszeństwo: AI odzywa się dopiero wtedy, gdy aplikacja nie potrafi odpowiedzieć sama.

Co dostajesz zamiast pustego terminala

Podsumowanie tego, co zawiodło, zwykłym językiem, a nie stack trace do rozszyfrowania. Jedno albo dwa zdania, które nazywają rzeczywistą przyczynę.

Konkretne kolejne kroki, po kolei. Każdy może nieść skrót do dokładnego panelu ustawień, komendy reinstalacji albo ponownego uruchomienia, więc nigdy nie szukasz na własną rękę, gdzie mieszka dana opcja.

Pochodzenie flag: każdy token komendy uruchomieniowej jest przypisany do swojego źródła, więc odpowiedź może powiedzieć "ta flaga pochodzi z trybu autonomicznego w Ustawieniach" zamiast zgadywać.

To samo traktowanie dla komend dev. Gdy Twoja komenda budowania, testów albo serwera zawiedzie w terminalu, diagnoza jest o jedno kliknięcie, a stamtąd możesz przekazać całość agentowi DevOps.

Jak powstaje diagnoza

Warstwy z rozmysłem: najpierw idą tanie, pewne sprawdzenia, AI jest ostatnią deską ratunku.

AgentsRoom zapisuje prawdziwe uruchomienie

W tym jednym momencie, w którym powstaje terminal, zapisywana jest pełna komenda: plik binarny, flagi, model, opcje. To ten zapis umożliwia później trafną diagnozę i obejmuje każdą drogę, którą agent może wystartować, łącznie z uruchomieniem wyzwolonym z telefonu albo z ticketu w backlogu.

Deterministyczne sprawdzenia mają pierwsze słowo

Brakujący plik binarny, flaga, której CLI już nie przyjmuje, sesja bez zalogowania, nieaktualna wersja: to znane, pewne werdykty. Odpowiada na nie od razu baner z przyciskiem naprawy. Żadnego wywołania AI, żadnego czekania.

Podejrzane uruchomienie jest potwierdzane, a nie zakładane

Jeśli awaria nie jest jednym ze znanych przypadków, AgentsRoom szuka wzorca błędu w pierwszych sekundach, a potem sprawdza, co faktycznie działa w terminalu. CLI, które po prostu wolno się podnosi albo instaluje przy pierwszym uruchomieniu swoje serwery MCP, nie jest awarią i zostaje odrzucone.

Diagnozowany jest zamaskowany kontekst

Dopiero wtedy wkracza AI, z fragmentem błędu, oczyszczoną komendą i mapą pochodzenia flag. Prompty systemowe, wartości wyglądające na sekrety i długie argumenty w cudzysłowie są maskowane na Twojej maszynie, zanim cokolwiek zostanie wysłane.

Dostajesz podsumowanie i kroki, a decydujesz Ty

Diagnoza pojawia się w terminalu. Nic nigdy nie jest wykonywane za Ciebie: przycisk akcji otwiera odpowiednie ustawienia, proponuje ponowne uruchomienie albo pokazuje komendę instalacji, a naciskasz go dalej Ty.

Skąd bierze się odpowiedź

CLI Doctor czyta te same miejsca, które konfigurujesz. Oto trzy, które generują najwięcej nieudanych uruchomień.

Opcje CLI dostawcy i danego agenta

Flagi uruchomieniowe biorą się z domyślnych ustawień dostawcy, trybu autonomicznego, przypięcia modelu albo nadpisania dla danego agenta. To tu zwykle odsyła Cię diagnoza.

Dowiedz się więcej

Terminale komend dev

Komendy budowania, testów i serwera dostają tę samą diagnozę, na kliknięcie zamiast automatycznie, bo padająca pętla watch pytałaby inaczej bez końca.

Dowiedz się więcej

Śledzenie statusu agentów

To, że wiadomo, czy agent myśli, skończył, czeka czy padł, jest tym, co w ogóle mówi AgentsRoom, że coś poszło nie tak.

Dowiedz się więcej

Zbudowane z oczywistymi ograniczeniami

Zamaskowane, zanim wyjdzie

Prompty systemowe, wartości środowiskowe wyglądające na sekrety i długie argumenty w cudzysłowie są usuwane na Twojej maszynie, zanim zapytanie o diagnozę zostanie wysłane.

Nic nie jest wykonywane za Ciebie

Diagnoza może zaproponować otwarcie panelu ustawień, ponowne uruchomienie agenta albo pokazanie komendy instalacji. Nigdy sama nie uruchamia komendy.

Pewne odpowiedzi zostają pewne

Na brakujący plik binarny albo odrzuconą flagę odpowiada deterministyczne sprawdzenie, a nie model. AI odzywa się tylko tam, gdzie naprawdę nie ma nic pewnego do powiedzenia.

FAQ

Zapytaj nas o coś innego

Które CLI agentów obejmuje CLI Doctor?

Wszystkie. Zapis uruchomienia powstaje w jednym miejscu, w którym AgentsRoom spawnuje terminal, więc wszystkie 19 CLI agentów wspieranych przez AgentsRoom (Claude, Codex, GitHub Copilot CLI, Cursor i 15 innych) są objęte, razem z agentami startowanymi z aplikacji mobilnej albo z ticketu w backlogu.

Czy wysyła wyjście mojego terminala na serwer?

Wysyła zamaskowany fragment błędu uruchomienia, oczyszczoną komendę uruchomieniową i mapę pochodzenia flag, i tylko wtedy, gdy diagnoza faktycznie powstaje. Prompty systemowe, wartości środowiskowe wyglądające na sekrety i długie argumenty w cudzysłowie są najpierw usuwane na Twojej maszynie. Twój kod źródłowy nigdy nie jest tego częścią, a automatyczną diagnozę można całkowicie wyłączyć w Ustawieniach, w sekcji prywatności i danych.

Czy sam uruchomi komendy albo zmieni moje ustawienia?

Nie. Krok może nieść skrót, który otwiera właściwy panel ustawień, proponuje ponowne uruchomienie agenta albo pokazuje komendę instalacji do skopiowania. Wykonanie czegokolwiek zawsze pozostaje Twoim działaniem.

Czym konkretnie jest pochodzenie flag?

AgentsRoom składa komendę uruchomieniową z kilku warstw: domyślnych ustawień dostawcy, trybu autonomicznego, wybranego przez Ciebie modelu, poziomu rozumowania, nadpisania CLI dla danego agenta i innych. Pochodzenie flag oznacza każdy token finalnej komendy warstwą, która go tam umieściła, więc diagnoza może wskazać dokładny przełącznik do zmiany, zamiast opisywać flagę w oderwaniu.

Czy odpala się przy każdym błędzie?

Nie, i jest to celowe. W terminalu agenta odpala się raz na epizod nieudanego uruchomienia i tylko wtedy, gdy niepowodzenie zostanie potwierdzone: CLI, które po prostu wolno startuje albo instaluje przy pierwszym uruchomieniu swoje serwery MCP, jest odrzucane, a nie diagnozowane. W terminalach komend dev diagnoza jest wyłącznie na kliknięcie, bo padająca pętla watch w kółko powtarza swój błąd.

Czy jest dostępny w planie darmowym?

Tak, z miesięcznym limitem. Plus go podnosi, a Pro jest w praktyce bez ograniczeń. Deterministyczne werdykty, które pokrywają najczęstsze awarie, jak brakujący plik binarny czy odrzucona flaga, nie są w ogóle rozliczane: nigdy nie wołają modelu. Jeśli faktycznie dobijesz do limitu, dodanie w aplikacji własnego klucza API OpenAI utrzyma diagnozy działające na Twoim kluczu.

Co się dzieje z agentem działającym na zdalnej maszynie przez SSH?

Procesem pierwszoplanowym po Twojej stronie jest sam klient SSH, więc zdalne CLI, które umiera, wygląda stąd na zdrowe i epizod zostaje pominięty. To świadomy kompromis: pominięta diagnoza jest lepsza niż pewna siebie, ale błędna. Deterministyczne sprawdzenia dalej obowiązują po zdalnej stronie połączenia.

Czym to się różni od wklejenia błędu do chatbota?

Chatbot widzi tylko wiadomość, którą wkleisz. CLI Doctor ma dodatkowo dokładną komendę, która została uruchomiona, pochodzenie każdej jej flagi, używanego dostawcę i model oraz stan procesu, a Ty nie musisz tego składać. To właśnie ten kontekst zamienia ogólną odpowiedź w nazwę ustawienia do zmiany.

Może cię też zainteresować

Multi-Provider

AgentsRoom obsługuje 19 dostawców AI do kodowania: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin, Cursor, Command Code, Muse Code, Pi, MiniMax Code i ZCode. Przypisz innego dostawcę do każdego agenta, przełączaj dostawcę w trakcie rozmowy i zachowuj pełny kontekst dzięki automatycznemu handoffowi. Najlepsze multi-provider narzędzie do kodowania z AI.

Śledzenie statusu

Śledź status każdego agenta Claude Code na pierwszy rzut oka. Kolorowe wskaźniki stanów: pracuje, ukończono, nieaktywny i oczekuje odpowiedzi. Liczniki czasu, podsumowania aktywności i liczniki na poziomie projektu.

Terminale dev

Uruchamiaj build, testy i serwer deweloperski w tym samym oknie co agentów, z dzwonkiem, gdy długie polecenie się kończy, i diagnozą, gdy zakończy się błędem.

Przywracanie agentów i terminali

Otwórz aplikację ponownie i zastań agentów oraz terminale dev tam, gdzie je zostawiłeś, z opcją wznowienia poprzedniej rozmowy w CLI.

AI Commit Messages

Generator wiadomości commitów AI wbudowany w AgentsRoom. Kliknij iskierkę w polu commit, odczytuje rzeczywisty git diff i pisze jedną czystą wiadomość commit w formacie Conventional Commits. Napisz szkic, a zostanie przepisany. Zasady formatu Twojego zespołu są stosowane przy każdym generowaniu.

Sugestie Agentów

Nie wiesz, którego agenta AI użyć? Opisz swoje zadanie w prostych słowach, a AgentsRoom zasugeruje odpowiedniego agenta: z twojego pokoju, 14 wbudowanych ról lub 260+ ekspertów z katalogu, z jedną linią uzasadnienia. Jedno kliknięcie przypisuje zadanie.