CLI i MCP

Polecenie skribly i serwer skribly mcp pozwalają agentom, skryptom i Tobie sterować panelami spoza okna. Agent może uruchomić obok siebie recenzenta, poczekać na niego i przeczytać wynik.

Jak to działa

API sterowania działa wewnątrz aplikacji i nasłuchuje tylko na 127.0.0.1, na losowym wolnym porcie.
Port i losowy token są zapisywane w ~/.skribly/control.json, który możesz odczytać tylko Ty. Żądania bez poprawnego tokenu dostają 401.
skribly to skrypt Node bez zależności. Działa tylko wtedy, gdy aplikacja jest uruchomiona.
Sesje uruchomione w ten sposób pojawiają się w widoku Agenci jak wszystkie inne.

Włącz

Otwórz Ustawienia, Sesje i sterowanie, Lokalne API sterowania. Domyślnie jest włączone.
W sekcji Polecenie skribly wybierz Zainstaluj, żeby dodać polecenie do PATH.
Opcjonalnie zainstaluj w projekcie umiejętność skribly. Uczy Claude Code i Codex, kiedy i jak przekazywać pracę.

Polecenia

Polecenia przyjmują cel: nazwę sesji, na przykład reviewer, identyfikator panelu albo current dla panelu, z którego je wywołujesz. Każde polecenie wypisuje JSON, a --text wypisuje zwykły tekst dla read i explain.

Polecenie skribly
Polecenie	Co robi
`skribly status`	Liczba paneli i agentów oraz ich stany
`skribly workspace list`	Projekty, drzewa robocze i panele w każdym z nich
`skribly pane list`	Wszystkie panele, powłoki i agenci
`skribly pane create`	Otwiera nowy panel
`skribly pane run`	Wpisuje polecenie powłoki i Enter
`skribly pane read`	Czyta ekran jako tekst
`skribly pane wait-output`	Czeka, aż wyjście dopasuje się do wyrażenia regularnego
`skribly pane rename`	Nadaje panelowi nazwę dla API
`skribly pane close`	Zamyka panel
`skribly agent list`	Agenci i ich stany
`skribly agent start`	Uruchamia nazwanego agenta w nowym panelu, opcjonalnie w drzewie roboczym
`skribly agent prompt`	Wysyła wiadomość i może poczekać na koniec tury
`skribly agent read`	Czyta ekran agenta
`skribly agent wait`	Czeka na wybrane stany
`skribly agent explain`	Pokazuje, dlaczego agent jest w danym stanie
`skribly agent stop`	Zamyka panel agenta
`skribly worktree list`	Wypisuje drzewa robocze projektu
`skribly worktree create`	Tworzy drzewo robocze
`skribly worktree remove`	Usuwa drzewo robocze i zostawia gałąź
`skribly notify`	Wysyła powiadomienie systemowe
`skribly mcp`	Uruchamia serwer MCP

Kody wyjścia
Kod	Znaczenie
`0`	Sukces
`1`	Błąd, na przykład nieznany cel
`2`	Złe użycie lub brak połączenia
`124`	Przekroczony limit czasu

Serwer MCP

skribly mcp udostępnia te same operacje jako narzędzia MCP przez stdin i stdout.

Claude Code:

claude mcp add skribly -- skribly mcp

Codex, w ~/.codex/config.toml:

[mcp_servers.skribly]
command = "skribly"
args = ["mcp"]

Cursor i Gemini CLI, w ustawieniach JSON:

{
  "mcpServers": {
    "skribly": { "command": "skribly", "args": ["mcp"] }
  }
}

Narzędzia MCP
Narzędzie	Odpowiednik
`skribly_status`	`status`
`skribly_list_workspaces`	`workspace list`
`skribly_list_panes`	`pane list`
`skribly_list_agents`	`agent list`
`skribly_start_agent`	`agent start`
`skribly_prompt_agent`	`agent prompt`
`skribly_read_agent`	`agent read`
`skribly_wait_agent`	`agent wait`
`skribly_explain_agent`	`agent explain`
`skribly_stop_agent`	`agent stop`
`skribly_create_pane`	`pane create`
`skribly_run_in_pane`	`pane run`
`skribly_read_pane`	`pane read`
`skribly_wait_output`	`pane wait-output`
`skribly_list_worktrees`, `skribly_create_worktree`, `skribly_remove_worktree`	`worktree list`, `create`, `remove`
`skribly_notify`	`notify`

Przepisy

Recenzent obok wykonawcy

skribly agent start reviewer --kind claude --prompt "Review the changes from git diff."
skribly agent wait reviewer --until done --timeout 600
skribly agent read reviewer --lines 60 --text

Równoległe drzewa robocze

Każdy agent dostaje własny katalog i gałąź, więc nie nadpisują sobie plików.

skribly agent start impl-api --kind codex --worktree feature/api-export --prompt "Build the CSV export endpoint per SPEC.md"
skribly agent start impl-ui --kind claude --worktree feature/ui-export --prompt "Build the export button per SPEC.md"
skribly agent wait impl-api --until finished --timeout 1800
skribly agent wait impl-ui --until finished --timeout 1800

Poczekaj i zareaguj

blocked oznacza, że agent prosi o zgodę lub wybór.

skribly agent wait impl-api --until done,blocked --timeout 900
skribly agent explain impl-api --text
skribly agent read impl-api --lines 30 --text
skribly agent prompt impl-api "1"

Poczekaj na polecenie powłoki

skribly pane create tests --kind shell
skribly pane run tests npm test
skribly pane wait-output tests "Tests:.*(passed|failed)" --timeout 300 --new

Bezpieczeństwo

Inni użytkownicy systemu nie mogą czytać control.json, ale może to każdy proces Twojego użytkownika. Jeśli nie używasz API, wyłącz je przełącznikiem w Ustawieniach.

Czytaj dalej

Poznaj skróty
Klawisze paneli, aplikacji i edytora.
Sprawdź porty
Co nasłuchuje i kto ma do tego dostęp.
Wróć do przewodnika
Od instalacji do pierwszego commita.