Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

tmux

/tmux

Steruje sesją tmux i interaktywnym terminalem, gdy zadanie w linii poleceń wymaga stałego okna.

Repozytorium
Cirno ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

96/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/find-sessions.sh, scripts/wait-for-text.sh

Co robi i kiedy

Steruje sesją tmux i interaktywnym terminalem, gdy zadanie w linii poleceń wymaga stałego okna.

Oryginalny opis (EN)

Use when a CLI task needs an interactive terminal or control of a tmux session.

Jak działa

  1. Quickstart (isolated socket, exec tool)
  2. Socket convention
  3. Targeting panes and naming
  4. Finding sessions
  5. Sending input safely
  6. Watching output
  7. Spawning processes
  8. Windows / WSL
  9. Long-running work
  10. Cleanup
Sekcje z nagłówków SKILL.md, w oryginale · 86 linii, 415 słów
Podgląd SKILL.md
---
name: tmux
description: Use when a CLI task needs an interactive terminal or control of a tmux session.
metadata: {"cirno":{"emoji":"🧵","os":["darwin","linux"],"requires":{"bins":["tmux"]}}}
---

# tmux Skill

Use tmux only when you need an interactive TTY. Prefer exec background mode for long-running, non-interactive tasks.

## Quickstart (isolated socket, exec tool)

```bash
SOCKET_DIR="${CIRNO_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/cirno-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/cirno.sock"
SESSION=cirno-python

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
```

After starting a session, always print monitor commands:

```
To monitor:
  tmux -S "$SOCKET" attach -t "$SESSION"
  tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
```

## Socket convention

- Use `CIRNO_TMUX_SOCKET_DIR` environment variable.
- Default socket path: `"$CIRNO_TMUX_SOCKET_DIR/cirno.sock"`.

## Targeting panes and naming

- Target format: `session:window.pane` (defaults to `:0.0`).
- Keep names short; avoid spaces.
- Inspect: `tmux -S "$SOCKET" list-sessions`, `tmux -S "$SOCKET" list-panes -a`.

## Finding sessions

- List sessions on your socket: `{baseDir}/scripts/find-sessions.sh -S "$SOCKET"`.
- Scan all sockets: `{baseDir}/scripts/find-sessions.sh --all` (uses `CIRNO_TMUX_SOCKET_DIR`).

## Sending input safely

- Prefer literal sends: `tmux -S "$SOCKET" send-keys -t target -l -- "$cmd"`.
- Control keys: `tmux -S "$SOCKET" send-keys -t target C-c`.

## Watching output

- Capture recent history: `tmux -S "$SOCKET" capture-pane -p -J -t target -S -200`.
- Wait for prompts: `{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'`.
- Attaching is OK; detach with `Ctrl+b d`.

## Spawning processes

- For python REPLs, set `PYTHON_BASIC_REPL=1` (non-basic REPL breaks send-keys flows).

## Windows / WSL

- tmux is supported on macOS/Linux. On Windows, use WSL and install tmux inside WSL.
- This skill is gated to `darwin`/`linux` and requires `tmux` on PATH.

## Long-running work

Use Cirno's `shell__exec` background execution and `shell__session` controls for non-interactive commands. Use tmux only when the program requires a terminal. Starting a detached terminal does not itself establish successful completion; inspect exit status and artifacts before reporting success.

## Cleanup

- Kill a session: `tmux -S "$SOCKET" kill-session -t "$SESSION"`.
- Kill all sessions on a socket: `tmux -S "$SOCKET" list-sessions -F '#{session_name}' | xargs -r -n1 tmux -S "$SOCKET" kill-session -t`.
- Remove everything on the private socket: `tmux -S "$SOCKET" kill-server`.

## Helper: wait-for-text.sh

`{baseDir}/scripts/wait-for-text.sh` polls a pane for a regex (or fixed string) with a timeout.

```bash
{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern' [-F] [-T 20] [-i 0.5] [-l 2000]
```

- `-t`/`--target` pane target (required)
- `-p`/`--pattern` regex to match (required); add `-F` for fixed string
- `-T` timeout seconds (integer, default 15)
- `-i` poll interval seconds (default 0.5)
- `-l` history lines to search (integer, default 1000)
Pliki w paczce (3)
  • SKILL.md 3 KB
  • scripts/find-sessions.sh 3 KB
  • scripts/wait-for-text.sh 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · rachebtms/Cirno96MIT
DaRacci/nix-config100MIT
julianobarbosa/claude-code-skills100MIT
G1Joshi/Agent-Skills100MIT
nicknisi/claude-plugins100MIT
hkuds/nanobot96MIT

Migawka bazy z 13.11.2026 · wersja paczki 699b3f46b564 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100tmux-automation
    Uruchamia testy aplikacji CLI w izolowanych sesjach tmux lub byobu, wysyła klawisze, przechwytuje wynik i monitoruje przebieg przez ai-monitor.
  • 100smux
    Steruje panelami tmux i komunikuje się między agentami, czytając inne panele i wysyłając wiadomości.
  • 95tmux-start
    Startuje pracę nad zgłoszeniem w nowym oknie tmux z osobnym worktree, gdy użytkownik działa w sesji tmux.
  • 95tmux-cheatsheet
    Podaje polecenia tmux: sesje, okna i panele, kopiowanie, przewijanie oraz konfigurację tmux.conf.
  • 95tmux-cli-test
    Testuje zachowanie interaktywnych interfejsów CLI i TUI w tmux: nawigację klawiaturą, monity i ponowne rysowanie ekranu.
  • 100tmux-qa
    Sprawdza zmiany przez budowanie, testy i uruchomienie aplikacji w tmux, aby potwierdzić działanie od początku do końca.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.