AgentValley — monitor Claude Code na Macu

Do czego służy AgentValley prostym językiem?

AgentValley to bezpłatna aplikacja open source do podglądu lokalnych sesji Claude Code na Macu. Najprościej: mały panel pod wcięciem ekranu pokazuje, który agent pracuje, a który czeka na odpowiedź. Nie trzeba stale przeglądać wszystkich okien terminala. Każdy agent ma osobny wiersz i pikselową postać, także podagenci uruchamiani przez sesję. Wymagane są Claude Code i macOS 15 lub nowszy.

Instalacja i pierwszy przebieg pracy

1. Pobierz oficjalny DMG, przeciągnij AgentValley do Aplikacji i uruchom. Alternatywą jest brew install --cask morsechimwai/tap/agent-valley.
2. Uruchom sesję Claude Code i skieruj wskaźnik na wcięcie. Sprawdź nazwę projektu i ostatnią czynność.
3. Z innej aplikacji otwórz panel skrótem Control–Option–Command–A, wybierz wiersz strzałkami i naciśnij Return.
4. Aby odpowiadać na prośby w panelu, włącz “Answer from the notch”, wykonaj podane w ustawieniach polecenie instalacji wtyczki i uruchom Claude Code ponownie. Po przeczytaniu wybierz “Allow once” lub “Deny”.

Wtyczka odpowiedzi wymaga oddzielnego, ręcznego dodania.

Rozpoznawanie aktywnych i oczekujących agentów

Sesje są grupowane według projektu, razem z jego worktree. Karta sesji pokazuje zadanie, model i ostatni krok każdego agenta; podagenci mają również licznik kroków. Ułatwia to oddzielenie zleconego wyszukiwania od głównego zadania.

Czerwona liczba przy wcięciu sygnalizuje pytanie lub prośbę o uprawnienie. W panelu można przeczytać treść i przejść do odpowiedniej aplikacji. Opcja “Go to the session’s tab” otwiera właściwą kartę w Terminal i iTerm2. W Ghostty wybór może być niejednoznaczny, gdy dwie sesje używają tego samego folderu. Domyślnie włączone dźwięki można wyciszyć lub zastąpić prostym sygnałem.

Koszty, tokeny i limity użycia

Przycisk wykresu otwiera History. Wybierz dzień, tydzień lub miesiąc, a następnie godziny dnia albo sesje projektu. Kwoty są obliczane według cen API; pomagają porównywać zużycie, ale nie są automatycznie rachunkiem za abonament. Eksport PDF obejmuje wszystkie projekty albo jeden wybrany. Historia pozostaje na Macu po usunięciu starych plików przez Claude Code.

Panel pokazuje też tokeny z ostatnich pięciu godzin i bieżącego dnia oraz wykres dwunastogodzinny. Opcja “Plan limits” jest domyślnie wyłączona i po włączeniu dodaje limity pięciogodzinne, tygodniowe oraz czas resetu. Stan na 25 października 2026: aplikacja jest bezpłatna, a sponsoring dobrowolny. Dostęp do Claude Code podlega osobnym warunkom.

Dane lokalne i opcjonalne zmiany

Publiczny opis wymienia odczyt ~/.claude/projects, ~/.claude/sessions, procesów oraz danych Git projektu. Dane aplikacji trafiają do ~/Library/Application Support/AgentValley. Włączenie “Plan limits” pozwala odczytać login Claude Code z Pęku kluczy i przesłać go do api.anthropic.com. Codzienne sprawdzanie aktualizacji na GitHub można wyłączyć.

Opcjonalny pasek stanu terminala zmienia ~/.claude/settings.json, instaluje font i w razie potrzeby dodaje linię konfiguracji Ghostty. Polecenie usunięcia cofa te dodatki. Nie należy więc utożsamiać lokalnego podglądu z brakiem ruchu sieciowego w każdej konfiguracji.

Dla kogo jest to przydatne?

Najwięcej korzyści daje przy kilku lokalnych sesjach i częstym szukaniu tej, która czeka. Panel można przenieść na podłączony monitor. Status “quiet” oznacza brak zapisanej aktywności przez dwie minuty, nie pewne zawieszenie ani procent ukończenia. Udokumentowany zakres to Claude Code na Macu. Kod aplikacji jest objęty MIT, a projekt nie jest powiązany z Anthropic.

Najczęstsze pytania

Czy AgentValley jest bezpłatny?

Tak. Aplikacja jest bezpłatna i open source. Dobrowolny sponsoring nie zastępuje warunków dostępu do Claude Code.

Czy szacunek kosztu jest rachunkiem?

Nie. History stosuje ceny API jako podstawę szacunku; faktyczna płatność zależy od sposobu rozliczania konta.

Czy podgląd sesji wymaga wtyczki?

Nie do zwykłego podglądu. Wtyczkę instaluje się ręcznie, aby zezwalać na operacje lub odmawiać ich wykonania z panelu.

Oficjalne pliki i wsparcie

• Oficjalne wydania i pobieranie
• Kod źródłowy i instrukcja konfiguracji
• Zgłoszenia w GitHub Issues