{"id":47302844,"url":"https://github.com/blockful/tmux-pilot","last_synced_at":"2026-04-01T16:39:45.362Z","repository":{"id":344972662,"uuid":"1183880693","full_name":"blockful/tmux-pilot","owner":"blockful","description":"A TUI for managing tmux sessions. One keybinding to see, create, rename, switch, and kill sessions.","archived":false,"fork":false,"pushed_at":"2026-03-17T14:51:50.000Z","size":47,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-17T16:55:24.755Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blockful.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-17T03:14:56.000Z","updated_at":"2026-03-17T14:51:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blockful/tmux-pilot","commit_stats":null,"previous_names":["blockful/tmux-pilot"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/blockful/tmux-pilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftmux-pilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftmux-pilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftmux-pilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftmux-pilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blockful","download_url":"https://codeload.github.com/blockful/tmux-pilot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftmux-pilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-17T05:59:47.380Z","updated_at":"2026-04-01T16:39:45.358Z","avatar_url":"https://github.com/blockful.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tmux-pilot\n\nA minimal TUI for managing tmux sessions. No commands to memorize.\n\n[![CI](https://github.com/blockful/tmux-pilot/actions/workflows/ci.yml/badge.svg)](https://github.com/blockful/tmux-pilot/actions/workflows/ci.yml)\n\n```\n$ tp\n\n╭──────────────────────────────────────────╮\n│          tmux sessions                   │\n│                                          │\n│  ● main            3 windows  attached   │\n│  ○ api-server      1 window   detached   │\n│  ○ notes           2 windows  detached   │\n│                                          │\n╰──────────────────────────────────────────╯\n↑/k ↓/j: navigate  Enter: attach  n: new\nr: rename  x: kill  q/Esc: quit\ntip: Ctrl-b d to detach from tmux\n```\n\n`tp` is a shortcut for `tmux-pilot`, installed automatically.\n\n## Why\n\ntmux is essential for running long-lived processes on remote servers — coding agents, builds, anything you want to survive closing your laptop. But the commands are hard to remember. `tmux ls`, `tmux attach -t`, `tmux kill-session -t`... every time.\n\ntmux-pilot gives you a simple picker. No commands to memorize. Works reliably over SSH.\n\n## Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/blockful/tmux-pilot/main/install.sh | bash\n```\n\nThis installs `tmux-pilot` and the `tp` shortcut to `~/.local/bin`.\n\n### Other methods\n\n\u003cdetails\u003e\n\u003csummary\u003eHomebrew\u003c/summary\u003e\n\n```bash\nbrew install blockful/tap/tmux-pilot\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGo\u003c/summary\u003e\n\n```bash\ngo install github.com/blockful/tmux-pilot/cmd@latest\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDownload binary\u003c/summary\u003e\n\nGrab the latest binary from [Releases](https://github.com/blockful/tmux-pilot/releases).\n\u003c/details\u003e\n\n## Update\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/blockful/tmux-pilot/main/install.sh | bash\n```\n\nSame command as install. It detects your current version and skips if already up to date.\n\n## Uninstall\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/blockful/tmux-pilot/main/install.sh | bash -s -- --uninstall\n```\n\n## Usage\n\n```bash\ntp\n```\n\nThat's it. You see your sessions, you pick one.\n\n### Keybindings\n\n| Key | Action |\n|-----|--------|\n| `↑`/`k` | Navigate up |\n| `↓`/`j` | Navigate down |\n| `Enter` | Switch to session |\n| `n` | Create new session |\n| `r` | Rename session |\n| `x` | Kill session (stays in picker) |\n| `q`/`Esc` | Quit |\n\n**tip:** `Ctrl-b d` to detach from tmux (this is a tmux command, not tmux-pilot)\n\n### Flags\n\n| Flag | Description |\n|------|-------------|\n| `-h`, `--help` | Show help |\n| `-v`, `--version` | Show version |\n| `-l`, `--list` | Print sessions as TSV (pipe-friendly) |\n| `-S \u003cpath\u003e` | Custom tmux socket path |\n| `-L \u003cname\u003e` | Named tmux socket |\n| `--no-color` | Disable colors (also respects `NO_COLOR` env) |\n\n### Examples\n\n```bash\n$ tp                        # open the picker\n$ tp --list                 # non-interactive, TSV output\n$ tp -S /tmp/custom.sock    # use a specific tmux socket\n$ tp --version              # check installed version\n```\n\n## How it works\n\n- ~1000 lines of Go\n- One dependency: `golang.org/x/term` (Go extended stdlib)\n- Raw ANSI rendering — no TUI framework\n- In-place drawing — no alt screen escape sequences\n- Works cleanly through SSH → tmux layers\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockful%2Ftmux-pilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblockful%2Ftmux-pilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockful%2Ftmux-pilot/lists"}