{"id":46108119,"url":"https://github.com/grll/dotfiles-2","last_synced_at":"2026-03-01T21:41:40.740Z","repository":{"id":337022305,"uuid":"1152055033","full_name":"grll/dotfiles-2","owner":"grll","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-23T17:09:26.000Z","size":178,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-24T00:47:19.669Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grll.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-02-07T09:43:54.000Z","updated_at":"2026-02-23T17:09:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/grll/dotfiles-2","commit_stats":null,"previous_names":["grll/dotfiles-2"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/grll/dotfiles-2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grll%2Fdotfiles-2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grll%2Fdotfiles-2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grll%2Fdotfiles-2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grll%2Fdotfiles-2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grll","download_url":"https://codeload.github.com/grll/dotfiles-2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grll%2Fdotfiles-2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29984839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T21:06:37.093Z","status":"ssl_error","status_checked_at":"2026-03-01T21:05:45.052Z","response_time":124,"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-01T21:41:40.134Z","updated_at":"2026-03-01T21:41:40.736Z","avatar_url":"https://github.com/grll.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\nKitty + tmux + git-worktree workflow for a remote dev cluster.\n\n**Kitty opens 4 tabs:** remote (kitten ssh → tmux), local shell, notion (Claude), linear (Claude).\nOn the remote, `gwt` manages git worktrees as tmux sessions. `vsc` opens VS Code locally from inside remote tmux. `notify` sends macOS notifications from remote.\n\n## Setup\n\n```bash\ngit clone git@github.com:USERNAME/dotfiles.git ~/dotfiles\ncp ~/dotfiles/config.example.sh ~/dotfiles/config.sh\nvi ~/dotfiles/config.sh   # set CLUSTER (ssh host) and REMOTE_REPO (repo path)\n```\n\n**Remote** (ssh into cluster first):\n```bash\n~/dotfiles/remote/install.sh\n# → gwt, completion, tmux.conf, bashrc block\n# ⚠ follow prompts: PATH, fzf, tmux\n# log out and SSH back in\n```\n\n**Local** (laptop):\n```bash\n~/dotfiles/local/install.sh\n# → vsc/gwt in shell rc, kitty session, kitty dotfiles.conf (remote control +\n#   notifications + startup session), ssh.conf (forward_remote_control for $CLUSTER),\n#   include directive in kitty.conf\n# restart kitty\n```\n\nKitty prerequisite: `~/.config/kitty/kitty.conf` must exist (create empty if needed).\n\n## What you get\n\n| Feature | How | Where |\n|---|---|---|\n| 4-tab kitty startup | `kitty-dotfiles.conf` → `startup_session sessions/work.conf` | local |\n| `kitten ssh` to cluster | `kitty-work.conf` — shell integration, clipboard, terminfo, remote control | local→remote |\n| Tmux auto-attach on SSH | `bashrc-gwt.sh` — attaches/creates `main` session | remote |\n| `gwt` worktree manager | `gwt \u003cbranch\u003e`, `gwt -b \u003cbranch\u003e`, `gwt -d \u003cbranch\u003e`, `gwt -l` | both |\n| `vsc [branch]` | Opens VS Code connected to remote dir; no args = cwd, with arg = worktree | both (local: `bashrc-local.sh`, remote: `bashrc-gwt.sh`) |\n| `notify [msg]` | macOS notification via `kitten @` remote control | remote (tmux) |\n| Cmd finish notifications | `notify_on_cmd_finish unfocused 15.0` — local tabs only | local |\n| Kitty passthrough in tmux | `allow-passthrough on` in `tmux.conf` — enables clipboard/notifications through tmux | remote |\n\n## File map\n\n```\nconfig.example.sh          # CLUSTER, REMOTE_REPO — cp to config.sh\nlocal/\n  install.sh               # local setup: symlinks, kitty conf, ssh.conf generation\n  bashrc-local.sh          # vsc (local version), gwt wrapper with cd\n  kitty-dotfiles.conf      # remote control, notify_on_cmd_finish, startup_session\n  kitty-work.conf          # kitty session: 4 tabs (remote, local, notion, linear)\n  ssh.conf                 # template — install.sh generates real one with $CLUSTER\nremote/\n  install.sh               # remote setup: gwt, completion, tmux, bashrc\n  bashrc-gwt.sh            # tmux auto-attach, gwt completion, vsc, notify\n  tmux.conf                # prefix C-a, mouse, fzf session picker, passthrough\n  gwt                      # git worktree ↔ tmux session manager\n  gwt-completion.bash      # bash completion for gwt\n```\n\n## gwt usage\n\n```\ngwt                       # fzf pick session (remote) or worktree (local)\ngwt \u003cbranch\u003e              # switch to existing worktree/session\ngwt -b \u003cbranch\u003e [base]    # create worktree + session (default base: origin/main)\ngwt -d \u003cbranch\u003e           # remove worktree + kill session\ngwt -l                    # list worktrees + sessions\n```\n\nCreates worktrees at `$REMOTE_REPO-\u003csanitized-branch\u003e`. Symlinks `.venv` and `.claude` from main repo. On remote, each worktree gets its own tmux session.\n\n## Security note\n\n`forward_remote_control yes` in `ssh.conf` gives the remote host full access to local kitty (launch processes, read clipboard). Only enabled for `$CLUSTER`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrll%2Fdotfiles-2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrll%2Fdotfiles-2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrll%2Fdotfiles-2/lists"}