Posts tagged: cli Archive

fixing a corrupt zshrc

2026-06-29T08:39:59Z

This morning I had a machine crash on me and came back to an error.

Error

zsh: corrupt history file /home/u_walkews/.zsh_history

Dammit I don’t want to redo my shell history, I checked with a clanker and they came up with this solution using strings that only prints printable characters.

cp ~/.zsh_history ~/.zsh_history.bak
mv ~/.zsh_history ~/.zsh_history.corrupt
touch ~/.zsh_history
chmod 600 ~/.zsh_history
strings ~/.zsh_history.corrupt > ~/.zsh_history
chmod 600 ~/.zsh_history

rsync delays

2026-06-04T17:31:53Z

I’ve been deploying my site old school for most of this year, rsync to a volume mounted to nginx. I ran into an issue today where I updated my site and all of the pages updated first, followed by upload. The issue this created was that the new cache busted css files were not up yet and the site had no styles for a brief period during upload.

I found that delaying updates and delaying deletes until the new content exists first solves this problem pretty well. Theres still possiblility of jank while uploading to a live directory and not doing some sort of hot swap, but I’m good with this low budget option for now.

sync:
	rsync -rlt --delete --omit-dir-times \
	--info=progress2 \
	--delay-updates \
	--delete-delay \
	./output/ \
	server:/mnt/mysite

zsh source .env

2026-05-29T08:19:41Z

setopt HIST_IGNORE_SPACE

2026-05-24T20:15:37Z

To ignore commands that start with a space character, use the HIST_IGNORE_SPACE option in bash or zsh.

setopt HIST_IGNORE_SPACE

testing copilot model flag

2026-04-29T11:05:39Z

Today I found a way to test model syntax, cause the clankers always get the exact model name that copilot wants wrong.

copilot --model claude-sonnet-4.5 -p "Reply with OK" --allow-all --no-ask-user -s
copilot --model gpt-5.4 -p "Reply with OK" --allow-all --no-ask-user -s

Ses_3444b09b1ffexter3elfg5qqtg

2026-03-04T20:58:05Z

Session ID: ses_3444b09b1ffeXTEr3ELFg5qqtg Created: 3/4/2026, 7:55:24 PM Updated: 3/4/2026, 8:52:32 PM

User #

I want to spec out a cli for tmux session switching in go.

responsive to terminal size
works in tmux popup
shows list of tmux sessions with favorites pinned at the top

keymap

j/k arrow navigation
tab to switch sections
asdfqwertzxcvb to pick a session (letter listed next to the session)
space to select a session, then arrows j/k move that session up in priority and hotkey letter

Assistant (Build · gpt-5.3-codex · 2.4s) #

Thinking:

Initiating brainstorming skill load

Tool: skill

Input:

{
  "name": "brainstorming"
}

Output:

<skill_content name="brainstorming">
# Skill: brainstorming

# Brainstorming Ideas Into Designs

## Overview

Help turn ideas into fully formed designs and specs through natural collaborative dialogue.

Start by understanding the current project context, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design in small sections (200-300 words), checking after each section whether it looks right so far.

## The Process

**Understanding the idea:**
- Check out the current project state first (files, docs, recent commits)
- Ask questions one at a time to refine the idea
- Prefer multiple choice questions when possible, but open-ended is fine too
- Only one question per message - if a topic needs more exploration, break it into multiple questions
- Focus on understanding: purpose, constraints, success criteria

**Exploring approaches:**
- Propose 2-3 different approaches with trade-offs
- Present options conversationally with your recommendation and reasoning
- Lead with your recommended option and explain why

**Presenting the design:**
- Once you believe you understand what you're building, present the design
- Break it into sections of 200-300 words
- Ask after each section whether it looks right so far
- Cover: architecture, components, data flow, error handling, testing
- Be ready to go back and clarify if something doesn't make sense

## After the Design

**Documentation:**
- Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
- Use elements-of-style:writing-clearly-and-concisely skill if available
- Commit the design document to git

**Implementation (if continuing):**
- Ask: "Ready to set up for implementation?"
- Use superpowers:using-git-worktrees to create isolated workspace
- Use superpowers:writing-plans to create detailed implementation plan

## Key Principles

- **One question at a time** - Don't overwhelm with multiple questions
- **Multiple choice preferred** - Easier to answer than open-ended when possible
- **YAGNI ruthlessly** - Remove unnecessary features from all designs
- **Explore alternatives** - Always propose 2-3 approaches before settling
- **Incremental validation** - Present design in sections, validate each
- **Be flexible** - Go back and clarify when something doesn't make sense

Base directory for this skill: file:///home/waylon/.agents/skills/brainstorming
Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.
Note: file list is sampled.

<skill_files>

</skill_files>
</skill_content>

Assistant (Build · gpt-5.3-codex · 8.8s) #

Thinking:

Planning cautious context inspection

Tool: glob

Input:

{
  "pattern": "**/*",
  "path": "/home/waylon/git/tgo"
}

Output:

No files found

Assistant (Build · gpt-5.3-codex · 27.0s) #

Thinking:

Outlining comprehensive spec approach

Great idea. Here’s a practical spec you can build straight into Go.

Product Shape

Build tms (tmux session switcher) as a full-screen TUI that also runs cleanly inside tmux popup.
Primary goal: fast switching with keyboard-only flow and stable hotkeys.
Session list is split into sections: Favorites (pinned) and Others (remaining tmux sessions).
Favorites always render at top; within each section, order is user-priority order.
Hotkey letters are shown beside each session and are re-assigned from top-to-bottom using: asdfqwertzxcvb.

Recommended Stack

bubbletea for event loop + resize handling.
bubbles/list (or custom list model) for session rendering and selection.
lipgloss for responsive styling and compact popup-safe layout.
os/exec for tmux integration.

Tmux Integration

Read sessions with:
- tmux list-sessions -F "#{session_name}|#{session_attached}|#{session_last_attached}"
Switch session with:
- tmux switch-client -t <session>
Optional sanity checks:
- detect tmux via $TMUX; show error if not running in tmux context.

Data Model

Persist state at ~/.config/tms/state.json (or XDG path).
Schema:
- favorites: []string (ordered names)
- order: []string (global priority fallback)
- lastSelected: string
Hotkeys are computed at runtime from rendered order (not persisted directly).

Keymap Spec

j / Down: move cursor down
k / Up: move cursor up
Tab: cycle section focus (Favorites <-> Others)
[asdfqwertzxcvb]: activate session currently bound to that letter; immediate switch and exit
Space: toggle “reorder mode” for currently highlighted session
- While active, j/k moves that session up/down within current section
- Each move recalculates priority and hotkey mapping live
- Space again confirms reorder mode off
Enter: switch to highlighted session
Esc or q: cancel/exit

Responsive + Popup Behavior

On terminal resize (tea.WindowSizeMsg), recompute:
- list height = terminal height - header - footer - margins
- truncate long names with ellipsis
Single-column layout for narrow widths; richer status line for wider widths.
No hardcoded minimum popup size; degrade gracefully with compact row renderer.
Keep render under ~16ms/frame by precomputing derived row labels.

UX Rules

Current session visually marked (e.g., * + muted color).
Favorites section always shown first, even if empty (show “No favorites yet” placeholder).
If session disappears mid-run (tmux changed), refresh list and preserve cursor as best effort.
Reordering in Favorites changes pin priority; reordering in Others changes non-favorite priority only.

Error Handling

If tmux command fails: show inline error banner, keep app running, allow retry (r optional).
Corrupt state file: back it up to state.json.bak, start with defaults.
Missing sessions in saved state: drop them during load normalization.

Testing Plan

Unit tests:
- hotkey assignment by visible order
- section partitioning (favorites vs others)
- reorder logic and boundary behavior
- state load/save normalization
Integration tests (command-layer):
- parse list-sessions output fixtures
- verify switch command target formatting
Manual checks:
- standard terminal and tmux popup at small/medium/large sizes
- rapid resize during reorder mode
- switching with every letter key in map

If you want, I can turn this into a concrete implementation plan next (package structure + first-pass interfaces + command skeleton).

User #

its called tgo

I’m envisioning an app that I can assign a hotkey to it opens instantly in a tmux popup, I press the key for the session that I want an I isntantly go there. the whole process is only two keystrokes. its critical that its quick and fast.

Assistant (Build · gpt-5.3-codex · 21.2s) #

Thinking:

Drafting optimized popup design

Perfect — tgo should be designed around a two-keystroke fast path:

tmux hotkey opens popup
press session letter
→ immediate switch + popup closes

For your goal, optimize for startup latency first, features second.

Fast-path spec for tgo

tgo starts, fetches sessions once, renders once, waits for a single key.
If key is in asdfqwertzxcvb and mapped to a live session:
- run tmux switch-client -t <session>
- exit immediately (popup disappears)
No animations, no spinner, no deferred UI transitions.
Keep key-to-session mapping stable across runs (muscle memory), unless reordered.

Performance-oriented design

Use a minimal UI loop (stdin raw mode + ANSI render), not a heavyweight framework.
Single tmux read command on boot: tmux list-sessions -F ...
Zero background polling by default.
Preload and parse state from XDG config in one read.
Render compact, fixed-height rows; truncate names only if needed.
Target cold-start budget: ~20–40ms on typical machine, warm path even lower.

Hotkey behavior

Letters (asdfqwertzxcvb) are primary action keys.
j/k and arrows for navigation.
Tab switches sections (Favorites / Others).
Space enters reorder mode for selected session:
- j/k moves session priority
- letter mapping updates immediately
- Space confirms and exits reorder mode

Tmux popup binding Use a binding like this so launch is one key:

bind-key g display-popup -E -w 70% -h 70% "tgo"

(Replace g with your preferred trigger key.)

Critical implementation rule

If a valid letter is pressed, do not do anything else first: no redraw, no extra checks beyond target existence; switch and exit immediately.

If you want, next I can draft the exact tgo internal package layout and event loop pseudocode optimized for this latency target.

User #

use the todo tool to track work, use the @builder for research and writing, create a justfile for managing the project, create a readme, changelog, and github actions to lint, tests, dependabot. create release artifacts on release.

Assistant (Build · gpt-5.3-codex · 13.4s) #

Thinking:

Clarifying tool usage and task delegation

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Draft builder prompt from tgo requirements and project setup tasks",
      "status": "in_progress",
      "priority": "high"
    },
    {
      "content": "Run builder subagent to create justfile, README, CHANGELOG, and GitHub workflows (lint, tests, dependabot, release artifacts)",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Review builder results and summarize created files and next steps",
      "status": "pending",
      "priority": "medium"
    }
  ]
}

Output:

[
  {
    "content": "Draft builder prompt from tgo requirements and project setup tasks",
    "status": "in_progress",
    "priority": "high"
  },
  {
    "content": "Run builder subagent to create justfile, README, CHANGELOG, and GitHub workflows (lint, tests, dependabot, release artifacts)",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Review builder results and summarize created files and next steps",
    "status": "pending",
    "priority": "medium"
  }
]

Assistant (Build · gpt-5.3-codex · 119.1s) #

Thinking:

Preparing detailed task prompt

Tool: task

Input:

{
  "description": "Scaffold project docs and CI",
  "subagent_type": "builder",
  "prompt": "You are working in /home/waylon/git/tgo. Perform research and writing, then implement project scaffolding for a new Go CLI called `tgo`.\n\nContext to embed:\n- `tgo` is a tmux session switcher optimized for speed.\n- Core UX goal: two-keystroke flow (tmux popup hotkey opens app, then user presses a session letter to switch instantly).\n- Hotkey set: `asdfqwertzxcvb`; favorites pinned at top; responsive to terminal/popup size.\n\nTasks to complete:\n1) Create a `justfile` for project management commands suitable for Go projects.\n   - Include at least: help/default list, fmt, lint, test, build, run, tidy, ci.\n   - Prefer golangci-lint if present; make behavior clear if missing.\n2) Create a high-quality `README.md` covering:\n   - What tgo is and performance philosophy.\n   - Planned keymap and interaction model (including two-keystroke fast path).\n   - Planned architecture notes.\n   - Local development workflow using `just`.\n   - Example tmux binding to open `tgo` in popup.\n3) Create `CHANGELOG.md` using Keep a Changelog format with an initial unreleased section.\n4) Add GitHub automation:\n   - `.github/workflows/ci.yml` for lint + tests on pushes/PRs.\n   - `.github/dependabot.yml` for Go modules + GitHub Actions updates.\n   - `.github/workflows/release.yml` that creates release artifacts when a GitHub Release is published.\n     * Build cross-platform binaries (linux/mac/windows amd64+arm64 where applicable) and upload as artifacts/assets.\n     * Include checksums file.\n5) Ensure workflows are reasonable for a fresh repo (avoid assumptions not present).\n6) If needed for CI/lint/test sanity in a fresh repo, add minimal Go scaffolding (e.g., go.mod and tiny main/test) but keep it minimal.\n\nConstraints:\n- Keep files concise and practical.\n- Use ASCII only.\n- Follow conventional Go and GitHub Actions practices.\n\nReturn a final report with:\n- Files created/updated.\n- Any assumptions made.\n- Recommended next commands to run locally."
}

Output:

task_id: ses_344457065ffeyL8ub5ZBsD7Ed5 (for resuming to continue this task if needed)

<task_result>
Scaffolded the `tgo` CLI with a minimal Go module, placeholder command/testing, documentation, changelog, `just` workflow recipes, and GitHub automation covering CI, Dependabot, and release pipelines (cross-platform builds + checksums).

**Files**
- `go.mod`, `cmd/tgo/main.go`, `cmd/tgo/main_test.go`
- `README.md`, `justfile`, `CHANGELOG.md`
- `.github/workflows/ci.yml`, `.github/workflows/release.yml`, `.github/dependabot.yml`

**Assumptions**
- The module path is simply `tgo` (no upstream repo URL provided) and `ubuntu-latest` agents have `zip`/`sha256sum` for release packaging.
- Local linting will skip `golangci-lint` unless it is installed, so `just lint` prints a warning but stays green.

**Next Steps**
1. `just ci` to run fmt, lint, and tests end-to-end.
2. `just run` to verify the CLI launches and prints the hotkey list.
</task_result>

Assistant (Build · gpt-5.3-codex · 8.0s) #

Thinking:

Planning todo updates and file verification

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/justfile"
}

Output:

<path>/home/waylon/git/tgo/justfile</path>
<type>file</type>
<content>1: default: help
2: 
3: help:
4:     @just --list
5: 
6: fmt:
7:     @go fmt ./...
8: 
9: lint:
10:     @if command -v golangci-lint >/dev/null 2>&1; then \
11:         golangci-lint run ./...; \
12:     else \
13:         echo "golangci-lint not found; install it to enable lint checks."; \
14:         exit 0; \
15:     fi
16: 
17: test:
18:     @go test ./...
19: 
20: build:
21:     @mkdir -p bin
22:     @go build -ldflags "-s -w" -o bin/tgo ./cmd/tgo
23: 
24: run:
25:     @go run ./cmd/tgo
26: 
27: tidy:
28:     @go mod tidy
29: 
30: ci: fmt lint test

(End of file - total 30 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/README.md"
}

Output:

<path>/home/waylon/git/tgo/README.md</path>
<type>file</type>
<content>1: # tgo
2: 
3: tgo is a tmux session switcher optimized for speed and predictability. It runs inside a tmux popup or terminal, draws the active sessions, highlights favorites, and lets you switch with a single letter after opening (two keystrokes overall). The focus is low latency: the popup hotkey triggers `tgo`, and the keyboard-only UI assumes tmux-level terminal performance and responsive layouts.
4: 
5: ## UX guidance
6: 
7: - **Two-keystroke flow**: Press the tmux popup hotkey, then tap the letter mapped to the target session. No arrow navigation, no typing a name twice.
8: - **Key map**: `asdf qwert zxcvb` serves as the ordered list of hotkeys. Favorites are pinned to the top of the list so that letters stay stable even when promting terminals resize.
9: - **Sizing**: `tgo` will render the session list responsively so that both narrow popups and larger terminals remain usable—critical for tmux popup contexts.
10: 
11: ## Architecture notes
12: 
13: - `cmd/tgo` contains the CLI entry point and will orchestrate session discovery, layout, and rendering logic.
14: - Session data comes from tmux via shell calls (placeholder now), with an overlay layer for the favorites list and letter assignment.
15: - UI rendering will target the terminal/popup dimensions reported by tmux, keeping control loops synchronous so the hotkey response stays within one frame.
16: 
17: ## Local workflow (using `just`)
18: 
19: 1. Install [just](https://github.com/casey/just) if missing.
20: 2. `just fmt` to format Go files.
21: 3. `just lint` to run `golangci-lint` if it is installed (falls back to a warning otherwise).
22: 4. `just test` to exercise the package.
23: 5. `just build` produces `bin/tgo` under the repository root.
24: 6. `just run` executes the CLI locally.
25: 7. `just tidy` keeps `go.mod` and `go.sum` neat.
26: 8. `just ci` runs `fmt`, `lint`, and `test` in sequence for a quick check before pushing.
27: 
28: ## Example tmux binding
29: 
30: ```tmux
31: bind-key q run-shell "tmux popup -E 'tgo'"
32: ```
33: 
34: This binding opens a popup that immediately starts `tgo`, letting you press one of the letters from `asdfqwertzxcvb` to jump to the desired session.

(End of file - total 34 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/CHANGELOG.md"
}

Output:

<path>/home/waylon/git/tgo/CHANGELOG.md</path>
<type>file</type>
<content>1: # Changelog
2: 
3: All notable changes to `tgo` will be documented in this file. This project adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
4: 
5: ## [Unreleased]
6: 
7: ### Added
8: - base Go module, CLI entry point, and placeholder session hotkey collection.
9: - `justfile` with formatter, lint, test, build, run, tidy, and CI recipes.
10: - `README.md` describing the command, UX goal, architecture notes, tmux binding, and local workflow.
11: - `CHANGELOG.md` initial structure plus README and changelog.
12: - GitHub workflows for CI, dependency updates, and release automation, along with cross-platform binary packaging and checksums.

(End of file - total 12 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/.github/workflows/ci.yml"
}

Output:

<path>/home/waylon/git/tgo/.github/workflows/ci.yml</path>
<type>file</type>
<content>1: name: CI
2: 
3: on:
4:   push:
5:     branches: [main]
6:   pull_request:
7:     branches: [main]
8: 
9: jobs:
10:   checks:
11:     runs-on: ubuntu-latest
12:     steps:
13:       - uses: actions/checkout@v4
14:       - name: Set up Go
15:         uses: actions/setup-go@v5
16:         with:
17:           go-version: 1.22
18:       - name: Cache Go modules
19:         uses: actions/cache@v3
20:         with:
21:           path: |
22:             ~/.cache/go-build
23:             ~/go/pkg/mod
24:           key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
25:       - name: Format code
26:         run: go fmt ./...
27:       - name: Run golangci-lint
28:         uses: golangci/golangci-lint-action@v4
29:         with:
30:           version: v1.64.0
31:           args: run ./...
32:       - name: Vet packages
33:         run: go vet ./...
34:       - name: Run tests
35:         run: go test ./...

(End of file - total 35 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/.github/workflows/release.yml"
}

Output:

<path>/home/waylon/git/tgo/.github/workflows/release.yml</path>
<type>file</type>
<content>1: name: Release
2: 
3: on:
4:   release:
5:     types: [published]
6: 
7: jobs:
8:   build:
9:     runs-on: ubuntu-latest
10:     steps:
11:       - uses: actions/checkout@v4
12:       - name: Set up Go
13:         uses: actions/setup-go@v5
14:         with:
15:           go-version: 1.22
16:       - name: Build cross-platform binaries
17:         run: |
18:           set -euo pipefail
19:           artifacts=artifacts
20:           mkdir -p "$artifacts"
21:           combos=(
22:             linux:amd64
23:             linux:arm64
24:             darwin:amd64
25:             darwin:arm64
26:             windows:amd64
27:             windows:arm64
28:           )
29:           for combo in "${combos[@]}"; do
30:             os=${combo%%:*}
31:             arch=${combo##*:}
32:             bin_name="tgo-${os}-${arch}"
33:             bin_path="$artifacts/${bin_name}"
34:             if [[ "$os" == "windows" ]]; then
35:               bin_path+=".exe"
36:             fi
37:             GOOS="$os" GOARCH="$arch" go build -ldflags "-s -w" -o "$bin_path" ./cmd/tgo
38:             archive="$artifacts/${bin_name}.zip"
39:             zip -j "$archive" "$bin_path"
40:             rm "$bin_path"
41:           done
42:           sha256sum "$artifacts"/*.zip > "$artifacts/checksums.txt"
43:       - name: Publish release assets
44:         uses: softprops/action-gh-release@v1
45:         with:
46:           files: |
47:             artifacts/*.zip
48:             artifacts/checksums.txt
49:         env:
50:           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

(End of file - total 50 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/.github/dependabot.yml"
}

Output:

<path>/home/waylon/git/tgo/.github/dependabot.yml</path>
<type>file</type>
<content>1: version: 2
2: updates:
3:   - package-ecosystem: gomod
4:     directory: /
5:     schedule:
6:       interval: weekly
7:   - package-ecosystem: github-actions
8:     directory: /
9:     schedule:
10:       interval: weekly

(End of file - total 10 lines)
</content>

Assistant (Build · gpt-5.3-codex · 2.4s) #

Thinking:

Scanning Go files for mentions

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/go.mod"
}

Output:

<path>/home/waylon/git/tgo/go.mod</path>
<type>file</type>
<content>1: module tgo
2: 
3: go 1.22

(End of file - total 3 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/main.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/main.go</path>
<type>file</type>
<content>1: package main
2: 
3: import "fmt"
4: 
5: const hotkeyRunes = "asdfqwertzxcvb"
6: 
7: func main() {
8: 	fmt.Println("tgo: tmux session switcher")
9: 	fmt.Println("hotkeys:", hotkeyRunes)
10: }
11: 
12: func SessionHotkeyAlphabet() string {
13: 	return hotkeyRunes
14: }

(End of file - total 14 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/main_test.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/main_test.go</path>
<type>file</type>
<content>1: package main
2: 
3: import "testing"
4: 
5: func TestSessionHotkeyAlphabet(t *testing.T) {
6: 	want := "asdfqwertzxcvb"
7: 	if got := SessionHotkeyAlphabet(); got != want {
8: 		t.Fatalf("hotkey alphabet mismatch: got %q want %q", got, want)
9: 	}
10: }

(End of file - total 10 lines)
</content>

Assistant (Build · gpt-5.3-codex · 4.3s) #

Thinking:

Running Go tests to verify

Tool: bash

Input:

{
  "command": "go test ./...",
  "workdir": "/home/waylon/git/tgo",
  "description": "Runs Go tests for all packages"
}

Output:

ok  	tgo/cmd/tgo	0.002s

Assistant (Build · gpt-5.3-codex · 2.3s) #

Thinking:

Completing todos update

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Draft builder prompt from tgo requirements and project setup tasks",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Run builder subagent to create justfile, README, CHANGELOG, and GitHub workflows (lint, tests, dependabot, release artifacts)",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Review builder results and summarize created files and next steps",
      "status": "completed",
      "priority": "medium"
    }
  ]
}

Output:

[
  {
    "content": "Draft builder prompt from tgo requirements and project setup tasks",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Run builder subagent to create justfile, README, CHANGELOG, and GitHub workflows (lint, tests, dependabot, release artifacts)",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Review builder results and summarize created files and next steps",
    "status": "completed",
    "priority": "medium"
  }
]

Assistant (Build · gpt-5.3-codex · 9.2s) #

Thinking:

Implemented. I used the todo tracker, generated a builder prompt from your tgo context, and ran the builder subagent to do the research/writing and scaffold the repo.

Added project scaffolding: go.mod, cmd/tgo/main.go, cmd/tgo/main_test.go
Added project management: justfile with help, fmt, lint, test, build, run, tidy, ci
Added docs: README.md (two-keystroke UX, keymap, architecture notes, tmux popup binding), CHANGELOG.md (Keep a Changelog)
Added automation:
- CI: .github/workflows/ci.yml (fmt, golangci-lint action, vet, test)
- Dependabot: .github/dependabot.yml (gomod + github-actions weekly)
- Release artifacts: .github/workflows/release.yml (cross-platform zip builds + checksums.txt on published release)
Verified tests locally with go test ./... (pass)

Key files:

justfile
README.md
CHANGELOG.md
.github/workflows/ci.yml
.github/workflows/release.yml
.github/dependabot.yml

Natural next steps:

Run just ci locally.
Wire real tmux session discovery/switching into cmd/tgo/main.go.
Add first-pass TUI loop for the two-keystroke popup flow.

User #

keep going until we have a fully workign tui that can list, switch, manage tmux sessions

Assistant (Build · gpt-5.3-codex · 6.2s) #

Thinking:

Preparing implementation strategy

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Inspect current tgo scaffold and define concrete TUI/session management architecture",
      "status": "in_progress",
      "priority": "high"
    },
    {
      "content": "Implement tmux integration and persistent state (favorites/order)",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Implement interactive TUI with navigation, section switching, hotkeys, and reorder mode",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Update README with implemented behavior and usage",
      "status": "pending",
      "priority": "medium"
    },
    {
      "content": "Add/expand tests for key mapping, ordering, and state normalization",
      "status": "pending",
      "priority": "medium"
    },
    {
      "content": "Run formatting and tests to validate full functionality",
      "status": "pending",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Inspect current tgo scaffold and define concrete TUI/session management architecture",
    "status": "in_progress",
    "priority": "high"
  },
  {
    "content": "Implement tmux integration and persistent state (favorites/order)",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Implement interactive TUI with navigation, section switching, hotkeys, and reorder mode",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Update README with implemented behavior and usage",
    "status": "pending",
    "priority": "medium"
  },
  {
    "content": "Add/expand tests for key mapping, ordering, and state normalization",
    "status": "pending",
    "priority": "medium"
  },
  {
    "content": "Run formatting and tests to validate full functionality",
    "status": "pending",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 4.1s) #

Thinking:

Tool: skill

Input:

{
  "name": "brainstorming"
}

Output:

<skill_content name="brainstorming">
# Skill: brainstorming

# Brainstorming Ideas Into Designs

## Overview

Help turn ideas into fully formed designs and specs through natural collaborative dialogue.

Start by understanding the current project context, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design in small sections (200-300 words), checking after each section whether it looks right so far.

## The Process

**Understanding the idea:**
- Check out the current project state first (files, docs, recent commits)
- Ask questions one at a time to refine the idea
- Prefer multiple choice questions when possible, but open-ended is fine too
- Only one question per message - if a topic needs more exploration, break it into multiple questions
- Focus on understanding: purpose, constraints, success criteria

**Exploring approaches:**
- Propose 2-3 different approaches with trade-offs
- Present options conversationally with your recommendation and reasoning
- Lead with your recommended option and explain why

**Presenting the design:**
- Once you believe you understand what you're building, present the design
- Break it into sections of 200-300 words
- Ask after each section whether it looks right so far
- Cover: architecture, components, data flow, error handling, testing
- Be ready to go back and clarify if something doesn't make sense

## After the Design

**Documentation:**
- Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
- Use elements-of-style:writing-clearly-and-concisely skill if available
- Commit the design document to git

**Implementation (if continuing):**
- Ask: "Ready to set up for implementation?"
- Use superpowers:using-git-worktrees to create isolated workspace
- Use superpowers:writing-plans to create detailed implementation plan

## Key Principles

- **One question at a time** - Don't overwhelm with multiple questions
- **Multiple choice preferred** - Easier to answer than open-ended when possible
- **YAGNI ruthlessly** - Remove unnecessary features from all designs
- **Explore alternatives** - Always propose 2-3 approaches before settling
- **Incremental validation** - Present design in sections, validate each
- **Be flexible** - Go back and clarify when something doesn't make sense

Base directory for this skill: file:///home/waylon/.agents/skills/brainstorming
Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.
Note: file list is sampled.

<skill_files>

</skill_files>
</skill_content>

Assistant (Build · gpt-5.3-codex · 2.9s) #

Thinking:

Resolving inquiry approach conflict

Tool: glob

Input:

{
  "pattern": "**/*",
  "path": "/home/waylon/git/tgo"
}

Output:

/home/waylon/git/tgo/bin/tgo
/home/waylon/git/tgo/cmd/tgo/main_test.go
/home/waylon/git/tgo/cmd/tgo/main.go
/home/waylon/git/tgo/.github/workflows/release.yml
/home/waylon/git/tgo/.github/dependabot.yml
/home/waylon/git/tgo/.github/workflows/ci.yml
/home/waylon/git/tgo/CHANGELOG.md
/home/waylon/git/tgo/justfile
/home/waylon/git/tgo/README.md
/home/waylon/git/tgo/go.mod

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/main.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/main.go</path>
<type>file</type>
<content>1: package main
2: 
3: import "fmt"
4: 
5: const hotkeyRunes = "asdfqwertzxcvb"
6: 
7: func main() {
8: 	fmt.Println("tgo: tmux session switcher")
9: 	fmt.Println("hotkeys:", hotkeyRunes)
10: }
11: 
12: func SessionHotkeyAlphabet() string {
13: 	return hotkeyRunes
14: }

(End of file - total 14 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/README.md"
}

Output:

<path>/home/waylon/git/tgo/README.md</path>
<type>file</type>
<content>1: # tgo
2: 
3: tgo is a tmux session switcher optimized for speed and predictability. It runs inside a tmux popup or terminal, draws the active sessions, highlights favorites, and lets you switch with a single letter after opening (two keystrokes overall). The focus is low latency: the popup hotkey triggers `tgo`, and the keyboard-only UI assumes tmux-level terminal performance and responsive layouts.
4: 
5: ## UX guidance
6: 
7: - **Two-keystroke flow**: Press the tmux popup hotkey, then tap the letter mapped to the target session. No arrow navigation, no typing a name twice.
8: - **Key map**: `asdf qwert zxcvb` serves as the ordered list of hotkeys. Favorites are pinned to the top of the list so that letters stay stable even when promting terminals resize.
9: - **Sizing**: `tgo` will render the session list responsively so that both narrow popups and larger terminals remain usable—critical for tmux popup contexts.
10: 
11: ## Architecture notes
12: 
13: - `cmd/tgo` contains the CLI entry point and will orchestrate session discovery, layout, and rendering logic.
14: - Session data comes from tmux via shell calls (placeholder now), with an overlay layer for the favorites list and letter assignment.
15: - UI rendering will target the terminal/popup dimensions reported by tmux, keeping control loops synchronous so the hotkey response stays within one frame.
16: 
17: ## Local workflow (using `just`)
18: 
19: 1. Install [just](https://github.com/casey/just) if missing.
20: 2. `just fmt` to format Go files.
21: 3. `just lint` to run `golangci-lint` if it is installed (falls back to a warning otherwise).
22: 4. `just test` to exercise the package.
23: 5. `just build` produces `bin/tgo` under the repository root.
24: 6. `just run` executes the CLI locally.
25: 7. `just tidy` keeps `go.mod` and `go.sum` neat.
26: 8. `just ci` runs `fmt`, `lint`, and `test` in sequence for a quick check before pushing.
27: 
28: ## Example tmux binding
29: 
30: ```tmux
31: bind-key q run-shell "tmux popup -E 'tgo'"
32: ```
33: 
34: This binding opens a popup that immediately starts `tgo`, letting you press one of the letters from `asdfqwertzxcvb` to jump to the desired session.

(End of file - total 34 lines)
</content>

Assistant (Build · gpt-5.3-codex · 62.8s) #

Thinking:

Designing session manager architecture

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/cmd/tgo/main.go\n@@\n-package main\n-\n-import \"fmt\"\n-\n-const hotkeyRunes = \"asdfqwertzxcvb\"\n-\n-func main() {\n-\tfmt.Println(\"tgo: tmux session switcher\")\n-\tfmt.Println(\"hotkeys:\", hotkeyRunes)\n-}\n-\n-func SessionHotkeyAlphabet() string {\n-\treturn hotkeyRunes\n-}\n+package main\n+\n+import (\n+\t\"fmt\"\n+\t\"os\"\n+)\n+\n+const hotkeyRunes = \"asdfqwertzxcvb\"\n+\n+func main() {\n+\tclient := &tmuxCLI{}\n+\tstore, err := openStateStore()\n+\tif err != nil {\n+\t\tfmt.Fprintf(os.Stderr, \"tgo: state init failed: %v\\n\", err)\n+\t\tos.Exit(1)\n+\t}\n+\n+\tapp, err := newApp(client, store)\n+\tif err != nil {\n+\t\tfmt.Fprintf(os.Stderr, \"tgo: startup failed: %v\\n\", err)\n+\t\tos.Exit(1)\n+\t}\n+\n+\tif err := app.Run(); err != nil {\n+\t\tfmt.Fprintf(os.Stderr, \"tgo: %v\\n\", err)\n+\t\tos.Exit(1)\n+\t}\n+}\n+\n+func SessionHotkeyAlphabet() string {\n+\treturn hotkeyRunes\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/cmd/tgo/main.go

LSP errors detected in home/waylon/git/tgo/cmd/tgo/main.go, please fix:
<diagnostics file="/home/waylon/git/tgo/cmd/tgo/main.go">
ERROR [11:13] undefined: tmuxCLI
ERROR [12:16] undefined: openStateStore
ERROR [18:14] undefined: newApp
</diagnostics>

Assistant (Build · gpt-5.3-codex · 23.4s) #

Thinking:

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Add File: /home/waylon/git/tgo/cmd/tgo/tmux.go\n+package main\n+\n+import (\n+\t\"bytes\"\n+\t\"fmt\"\n+\t\"os/exec\"\n+\t\"sort\"\n+\t\"strings\"\n+)\n+\n+type session struct {\n+\tName     string\n+\tAttached bool\n+}\n+\n+type tmuxClient interface {\n+\tListSessions() ([]session, error)\n+\tSwitchSession(name string) error\n+\tKillSession(name string) error\n+\tNewSession(name string) error\n+}\n+\n+type tmuxCLI struct{}\n+\n+func (t *tmuxCLI) ListSessions() ([]session, error) {\n+\tcmd := exec.Command(\"tmux\", \"list-sessions\", \"-F\", \"#{session_name}|#{?session_attached,1,0}\")\n+\tout, err := cmd.Output()\n+\tif err != nil {\n+\t\treturn nil, fmt.Errorf(\"list sessions: %w\", err)\n+\t}\n+\n+\tlines := strings.Split(strings.TrimSpace(string(out)), \"\\n\")\n+\tif len(lines) == 1 && lines[0] == \"\" {\n+\t\treturn []session{}, nil\n+\t}\n+\n+\tsessions := make([]session, 0, len(lines))\n+\tfor _, line := range lines {\n+\t\tparts := strings.SplitN(line, \"|\", 2)\n+\t\tif len(parts) != 2 {\n+\t\t\tcontinue\n+\t\t}\n+\t\tsessions = append(sessions, session{\n+\t\t\tName:     parts[0],\n+\t\t\tAttached: parts[1] == \"1\",\n+\t\t})\n+\t}\n+\n+\treturn sessions, nil\n+}\n+\n+func (t *tmuxCLI) SwitchSession(name string) error {\n+\tif name == \"\" {\n+\t\treturn fmt.Errorf(\"empty session name\")\n+\t}\n+\tcmd := exec.Command(\"tmux\", \"switch-client\", \"-t\", name)\n+\tif out, err := cmd.CombinedOutput(); err != nil {\n+\t\treturn fmt.Errorf(\"switch session %q: %w (%s)\", name, err, strings.TrimSpace(string(out)))\n+\t}\n+\treturn nil\n+}\n+\n+func (t *tmuxCLI) KillSession(name string) error {\n+\tif name == \"\" {\n+\t\treturn fmt.Errorf(\"empty session name\")\n+\t}\n+\tcmd := exec.Command(\"tmux\", \"kill-session\", \"-t\", name)\n+\tif out, err := cmd.CombinedOutput(); err != nil {\n+\t\treturn fmt.Errorf(\"kill session %q: %w (%s)\", name, err, strings.TrimSpace(string(out)))\n+\t}\n+\treturn nil\n+}\n+\n+func (t *tmuxCLI) NewSession(name string) error {\n+\tif name == \"\" {\n+\t\treturn fmt.Errorf(\"empty session name\")\n+\t}\n+\tcmd := exec.Command(\"tmux\", \"new-session\", \"-d\", \"-s\", name)\n+\tif out, err := cmd.CombinedOutput(); err != nil {\n+\t\treturn fmt.Errorf(\"new session %q: %w (%s)\", name, err, strings.TrimSpace(string(out)))\n+\t}\n+\treturn nil\n+}\n+\n+func orderSessions(sessions []session, st state) (favorites []session, others []session) {\n+\tnameToSession := make(map[string]session, len(sessions))\n+\ttmuxOrder := make(map[string]int, len(sessions))\n+\tfor i, s := range sessions {\n+\t\tnameToSession[s.Name] = s\n+\t\ttmuxOrder[s.Name] = i\n+\t}\n+\n+\tfor _, name := range st.Favorites {\n+\t\ts, ok := nameToSession[name]\n+\t\tif !ok {\n+\t\t\tcontinue\n+\t\t}\n+\t\tfavorites = append(favorites, s)\n+\t}\n+\n+\tfavSet := make(map[string]struct{}, len(favorites))\n+\tfor _, s := range favorites {\n+\t\tfavSet[s.Name] = struct{}{}\n+\t}\n+\n+\tnonFav := make([]session, 0, len(sessions)-len(favorites))\n+\tfor _, s := range sessions {\n+\t\tif _, ok := favSet[s.Name]; ok {\n+\t\t\tcontinue\n+\t\t}\n+\t\tnonFav = append(nonFav, s)\n+\t}\n+\n+\torderIndex := make(map[string]int, len(st.Order))\n+\tfor i, name := range st.Order {\n+\t\torderIndex[name] = i\n+\t}\n+\n+\tsort.SliceStable(nonFav, func(i, j int) bool {\n+\t\tli, iok := orderIndex[nonFav[i].Name]\n+\t\tlj, jok := orderIndex[nonFav[j].Name]\n+\t\tswitch {\n+\t\tcase iok && jok:\n+\t\t\treturn li < lj\n+\t\tcase iok:\n+\t\t\treturn true\n+\t\tcase jok:\n+\t\t\treturn false\n+\t\tdefault:\n+\t\t\treturn tmuxOrder[nonFav[i].Name] < tmuxOrder[nonFav[j].Name]\n+\t\t}\n+\t})\n+\n+\treturn favorites, nonFav\n+}\n+\n+func assignHotkeys(favorites []session, others []session, alphabet string) map[string]rune {\n+\tout := make(map[string]rune)\n+\tordered := make([]session, 0, len(favorites)+len(others))\n+\tordered = append(ordered, favorites...)\n+\tordered = append(ordered, others...)\n+\n+\trunes := []rune(alphabet)\n+\tfor i, s := range ordered {\n+\t\tif i >= len(runes) {\n+\t\t\tbreak\n+\t\t}\n+\t\tout[s.Name] = runes[i]\n+\t}\n+\treturn out\n+}\n+\n+func runesToString(m map[string]rune, ordered []session) string {\n+\tbuf := bytes.Buffer{}\n+\tfor _, s := range ordered {\n+\t\tr, ok := m[s.Name]\n+\t\tif !ok {\n+\t\t\tcontinue\n+\t\t}\n+\t\tbuf.WriteRune(r)\n+\t}\n+\treturn buf.String()\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
A home/waylon/git/tgo/cmd/tgo/tmux.go

LSP errors detected in home/waylon/git/tgo/cmd/tgo/tmux.go, please fix:
<diagnostics file="/home/waylon/git/tgo/cmd/tgo/tmux.go">
ERROR [85:43] undefined: state
</diagnostics>

Assistant (Build · gpt-5.3-codex · 15.8s) #

Thinking:

Identifying need for state file

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Add File: /home/waylon/git/tgo/cmd/tgo/state.go\n+package main\n+\n+import (\n+\t\"encoding/json\"\n+\t\"errors\"\n+\t\"fmt\"\n+\t\"os\"\n+\t\"path/filepath\"\n+)\n+\n+type state struct {\n+\tFavorites []string `json:\"favorites\"`\n+\tOrder     []string `json:\"order\"`\n+}\n+\n+type stateStore struct {\n+\tpath string\n+}\n+\n+func openStateStore() (*stateStore, error) {\n+\tconfigDir, err := os.UserConfigDir()\n+\tif err != nil {\n+\t\treturn nil, fmt.Errorf(\"config dir: %w\", err)\n+\t}\n+\treturn &stateStore{path: filepath.Join(configDir, \"tgo\", \"state.json\")}, nil\n+}\n+\n+func (s *stateStore) Load() (state, error) {\n+\tdata, err := os.ReadFile(s.path)\n+\tif err != nil {\n+\t\tif errors.Is(err, os.ErrNotExist) {\n+\t\t\treturn state{}, nil\n+\t\t}\n+\t\treturn state{}, fmt.Errorf(\"read state: %w\", err)\n+\t}\n+\n+\tvar st state\n+\tif err := json.Unmarshal(data, &st); err != nil {\n+\t\tbak := s.path + \".bak\"\n+\t\t_ = os.Rename(s.path, bak)\n+\t\treturn state{}, nil\n+\t}\n+\treturn st, nil\n+}\n+\n+func (s *stateStore) Save(st state) error {\n+\tdir := filepath.Dir(s.path)\n+\tif err := os.MkdirAll(dir, 0o755); err != nil {\n+\t\treturn fmt.Errorf(\"create state dir: %w\", err)\n+\t}\n+\tdata, err := json.MarshalIndent(st, \"\", \"  \")\n+\tif err != nil {\n+\t\treturn fmt.Errorf(\"marshal state: %w\", err)\n+\t}\n+\tif err := os.WriteFile(s.path, data, 0o644); err != nil {\n+\t\treturn fmt.Errorf(\"write state: %w\", err)\n+\t}\n+\treturn nil\n+}\n+\n+func normalizeState(st state, sessions []session) state {\n+\texists := make(map[string]struct{}, len(sessions))\n+\tfor _, s := range sessions {\n+\t\texists[s.Name] = struct{}{}\n+\t}\n+\n+\tst.Favorites = dedupeAndFilter(st.Favorites, exists)\n+\n+\tfavSet := make(map[string]struct{}, len(st.Favorites))\n+\tfor _, name := range st.Favorites {\n+\t\tfavSet[name] = struct{}{}\n+\t}\n+\n+\tallowedOthers := make(map[string]struct{}, len(sessions)-len(st.Favorites))\n+\tfor _, s := range sessions {\n+\t\tif _, fav := favSet[s.Name]; fav {\n+\t\t\tcontinue\n+\t\t}\n+\t\tallowedOthers[s.Name] = struct{}{}\n+\t}\n+\tst.Order = dedupeAndFilter(st.Order, allowedOthers)\n+\treturn st\n+}\n+\n+func dedupeAndFilter(items []string, allowed map[string]struct{}) []string {\n+\tseen := map[string]struct{}{}\n+\tout := make([]string, 0, len(items))\n+\tfor _, item := range items {\n+\t\tif item == \"\" {\n+\t\t\tcontinue\n+\t\t}\n+\t\tif _, ok := allowed[item]; !ok {\n+\t\t\tcontinue\n+\t\t}\n+\t\tif _, dup := seen[item]; dup {\n+\t\t\tcontinue\n+\t\t}\n+\t\tseen[item] = struct{}{}\n+\t\tout = append(out, item)\n+\t}\n+\treturn out\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
A home/waylon/git/tgo/cmd/tgo/state.go

Assistant (Build · gpt-5.3-codex · 57.9s) #

Thinking:

Adding tcell app file

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Add File: /home/waylon/git/tgo/cmd/tgo/app.go\n+package main\n+\n+import (\n+\t\"fmt\"\n+\t\"strings\"\n+\t\"time\"\n+\n+\t\"github.com/gdamore/tcell/v2\"\n+)\n+\n+type mode int\n+\n+const (\n+\tmodeNormal mode = iota\n+\tmodeReorder\n+\tmodeCreate\n+)\n+\n+type app struct {\n+\tclient tmuxClient\n+\tstore  *stateStore\n+\n+\tstate     state\n+\tsessions  []session\n+\tfavorites []session\n+\tothers    []session\n+\thotkeys   map[string]rune\n+\n+\tsection     int\n+\tcursorFav   int\n+\tcursorOther int\n+\tscrollFav   int\n+\tscrollOther int\n+\n+\tmode        mode\n+\tcreateInput string\n+\n+\tstatus       string\n+\tstatusExpiry time.Time\n+}\n+\n+func newApp(client tmuxClient, store *stateStore) (*app, error) {\n+\tst, err := store.Load()\n+\tif err != nil {\n+\t\treturn nil, err\n+\t}\n+\ta := &app{client: client, store: store, state: st}\n+\tif err := a.refreshSessions(); err != nil {\n+\t\treturn nil, err\n+\t}\n+\treturn a, nil\n+}\n+\n+func (a *app) Run() error {\n+\tscreen, err := tcell.NewScreen()\n+\tif err != nil {\n+\t\treturn fmt.Errorf(\"create screen: %w\", err)\n+\t}\n+\tif err := screen.Init(); err != nil {\n+\t\treturn fmt.Errorf(\"init screen: %w\", err)\n+\t}\n+\tdefer screen.Fini()\n+\n+\tscreen.HideCursor()\n+\ta.draw(screen)\n+\n+\tfor {\n+\t\tev := screen.PollEvent()\n+\t\tswitch e := ev.(type) {\n+\t\tcase *tcell.EventResize:\n+\t\t\tscreen.Sync()\n+\t\t\ta.draw(screen)\n+\t\tcase *tcell.EventKey:\n+\t\t\tdone, runSwitch := a.handleKey(e)\n+\t\t\tif runSwitch != \"\" {\n+\t\t\t\tscreen.Fini()\n+\t\t\t\tif err := a.client.SwitchSession(runSwitch); err != nil {\n+\t\t\t\t\treturn err\n+\t\t\t\t}\n+\t\t\t\treturn nil\n+\t\t\t}\n+\t\t\tif done {\n+\t\t\t\treturn nil\n+\t\t\t}\n+\t\t\ta.draw(screen)\n+\t\t}\n+\t}\n+}\n+\n+func (a *app) handleKey(key *tcell.EventKey) (done bool, switchTo string) {\n+\tif a.mode == modeCreate {\n+\t\treturn a.handleCreateKey(key)\n+\t}\n+\n+\tif key.Key() == tcell.KeyCtrlC || key.Rune() == 'q' {\n+\t\treturn true, \"\"\n+\t}\n+\n+\tif key.Key() == tcell.KeyTab {\n+\t\ta.toggleSection()\n+\t\treturn false, \"\"\n+\t}\n+\n+\tif key.Key() == tcell.KeyEnter {\n+\t\tif name, ok := a.selectedName(); ok {\n+\t\t\treturn false, name\n+\t\t}\n+\t\treturn false, \"\"\n+\t}\n+\n+\tif key.Key() == tcell.KeyRune {\n+\t\tr := key.Rune()\n+\t\tif name, ok := a.hotkeyTarget(r); ok {\n+\t\t\treturn false, name\n+\t\t}\n+\t\tswitch r {\n+\t\tcase 'j':\n+\t\t\ta.moveDown()\n+\t\tcase 'k':\n+\t\t\ta.moveUp()\n+\t\tcase ' ':\n+\t\t\ta.toggleReorderMode()\n+\t\tcase 'f':\n+\t\t\ta.toggleFavorite()\n+\t\tcase 'x':\n+\t\t\ta.killSelected()\n+\t\tcase 'n':\n+\t\t\ta.mode = modeCreate\n+\t\t\ta.createInput = \"\"\n+\t\t\ta.status = \"new session: type name and press Enter\"\n+\t\t\ta.statusExpiry = time.Time{}\n+\t\tcase 'r':\n+\t\t\tif err := a.refreshSessions(); err != nil {\n+\t\t\t\ta.setError(err)\n+\t\t\t}\n+\t\t}\n+\t\treturn false, \"\"\n+\t}\n+\n+\tswitch key.Key() {\n+\tcase tcell.KeyUp:\n+\t\ta.moveUp()\n+\tcase tcell.KeyDown:\n+\t\ta.moveDown()\n+\t}\n+\n+\treturn false, \"\"\n+}\n+\n+func (a *app) handleCreateKey(key *tcell.EventKey) (bool, string) {\n+\tswitch key.Key() {\n+\tcase tcell.KeyEsc:\n+\t\ta.mode = modeNormal\n+\t\ta.setStatus(\"create canceled\")\n+\t\treturn false, \"\"\n+\tcase tcell.KeyEnter:\n+\t\tname := strings.TrimSpace(a.createInput)\n+\t\tif name == \"\" {\n+\t\t\ta.setStatus(\"session name cannot be empty\")\n+\t\t\treturn false, \"\"\n+\t\t}\n+\t\tif err := a.client.NewSession(name); err != nil {\n+\t\t\ta.setError(err)\n+\t\t\treturn false, \"\"\n+\t\t}\n+\t\ta.mode = modeNormal\n+\t\ta.createInput = \"\"\n+\t\tif err := a.refreshSessions(); err != nil {\n+\t\t\ta.setError(err)\n+\t\t\treturn false, \"\"\n+\t\t}\n+\t\ta.selectByName(name)\n+\t\ta.setStatus(fmt.Sprintf(\"created %s\", name))\n+\t\treturn false, \"\"\n+\tcase tcell.KeyBackspace, tcell.KeyBackspace2:\n+\t\tif len(a.createInput) > 0 {\n+\t\t\ta.createInput = a.createInput[:len(a.createInput)-1]\n+\t\t}\n+\t\treturn false, \"\"\n+\tcase tcell.KeyRune:\n+\t\tr := key.Rune()\n+\t\tif r >= 32 && r <= 126 {\n+\t\t\ta.createInput += string(r)\n+\t\t}\n+\t\treturn false, \"\"\n+\tdefault:\n+\t\treturn false, \"\"\n+\t}\n+}\n+\n+func (a *app) toggleSection() {\n+\tif len(a.favorites) == 0 && len(a.others) == 0 {\n+\t\treturn\n+\t}\n+\tif a.section == 0 {\n+\t\tif len(a.others) > 0 {\n+\t\t\ta.section = 1\n+\t\t}\n+\t\treturn\n+\t}\n+\tif len(a.favorites) > 0 {\n+\t\ta.section = 0\n+\t}\n+}\n+\n+func (a *app) moveUp() {\n+\tif a.mode == modeReorder {\n+\t\ta.reorder(-1)\n+\t\treturn\n+\t}\n+\tif a.section == 0 {\n+\t\tif a.cursorFav > 0 {\n+\t\t\ta.cursorFav--\n+\t\t}\n+\t\treturn\n+\t}\n+\tif a.cursorOther > 0 {\n+\t\ta.cursorOther--\n+\t}\n+}\n+\n+func (a *app) moveDown() {\n+\tif a.mode == modeReorder {\n+\t\ta.reorder(1)\n+\t\treturn\n+\t}\n+\tif a.section == 0 {\n+\t\tif a.cursorFav < len(a.favorites)-1 {\n+\t\t\ta.cursorFav++\n+\t\t}\n+\t\treturn\n+\t}\n+\tif a.cursorOther < len(a.others)-1 {\n+\t\ta.cursorOther++\n+\t}\n+}\n+\n+func (a *app) toggleReorderMode() {\n+\tif _, ok := a.selectedName(); !ok {\n+\t\treturn\n+\t}\n+\tif a.mode == modeReorder {\n+\t\ta.mode = modeNormal\n+\t\ta.setStatus(\"reorder mode off\")\n+\t\treturn\n+\t}\n+\ta.mode = modeReorder\n+\ta.setStatus(\"reorder mode on: j/k moves selected session\")\n+}\n+\n+func (a *app) toggleFavorite() {\n+\tname, ok := a.selectedName()\n+\tif !ok {\n+\t\treturn\n+\t}\n+\n+\tidx := indexOf(a.state.Favorites, name)\n+\tif idx >= 0 {\n+\t\ta.state.Favorites = removeAt(a.state.Favorites, idx)\n+\t\ta.state.Order = append([]string{name}, a.state.Order...)\n+\t\ta.setStatus(fmt.Sprintf(\"unfavorited %s\", name))\n+\t} else {\n+\t\ta.state.Favorites = append(a.state.Favorites, name)\n+\t\ta.state.Order = removeByValue(a.state.Order, name)\n+\t\ta.setStatus(fmt.Sprintf(\"favorited %s\", name))\n+\t}\n+\tif err := a.persistAndRebuild(); err != nil {\n+\t\ta.setError(err)\n+\t}\n+}\n+\n+func (a *app) reorder(delta int) {\n+\tname, ok := a.selectedName()\n+\tif !ok {\n+\t\treturn\n+\t}\n+\tif a.section == 0 {\n+\t\tidx := indexOf(a.state.Favorites, name)\n+\t\tif idx < 0 {\n+\t\t\treturn\n+\t\t}\n+\t\tnewIdx := idx + delta\n+\t\tif newIdx < 0 || newIdx >= len(a.state.Favorites) {\n+\t\t\treturn\n+\t\t}\n+\t\ta.state.Favorites[idx], a.state.Favorites[newIdx] = a.state.Favorites[newIdx], a.state.Favorites[idx]\n+\t\ta.cursorFav = newIdx\n+\t} else {\n+\t\tnames := make([]string, 0, len(a.others))\n+\t\tfor _, s := range a.others {\n+\t\t\tnames = append(names, s.Name)\n+\t\t}\n+\t\tidx := indexOf(names, name)\n+\t\tif idx < 0 {\n+\t\t\treturn\n+\t\t}\n+\t\tnewIdx := idx + delta\n+\t\tif newIdx < 0 || newIdx >= len(names) {\n+\t\t\treturn\n+\t\t}\n+\t\tnames[idx], names[newIdx] = names[newIdx], names[idx]\n+\t\ta.state.Order = names\n+\t\ta.cursorOther = newIdx\n+\t}\n+\tif err := a.persistAndRebuild(); err != nil {\n+\t\ta.setError(err)\n+\t\treturn\n+\t}\n+\ta.setStatus(\"priority updated\")\n+}\n+\n+func (a *app) killSelected() {\n+\tname, ok := a.selectedName()\n+\tif !ok {\n+\t\treturn\n+\t}\n+\tif err := a.client.KillSession(name); err != nil {\n+\t\ta.setError(err)\n+\t\treturn\n+\t}\n+\ta.state.Favorites = removeByValue(a.state.Favorites, name)\n+\ta.state.Order = removeByValue(a.state.Order, name)\n+\tif err := a.persistAndRebuild(); err != nil {\n+\t\ta.setError(err)\n+\t\treturn\n+\t}\n+\ta.setStatus(fmt.Sprintf(\"killed %s\", name))\n+}\n+\n+func (a *app) refreshSessions() error {\n+\tsessions, err := a.client.ListSessions()\n+\tif err != nil {\n+\t\treturn err\n+\t}\n+\ta.sessions = sessions\n+\ta.state = normalizeState(a.state, sessions)\n+\ta.rebuildLists()\n+\tif err := a.store.Save(a.state); err != nil {\n+\t\treturn err\n+\t}\n+\treturn nil\n+}\n+\n+func (a *app) persistAndRebuild() error {\n+\ta.state = normalizeState(a.state, a.sessions)\n+\ta.rebuildLists()\n+\treturn a.store.Save(a.state)\n+}\n+\n+func (a *app) rebuildLists() {\n+\ta.favorites, a.others = orderSessions(a.sessions, a.state)\n+\ta.hotkeys = assignHotkeys(a.favorites, a.others, SessionHotkeyAlphabet())\n+\ta.clampCursors()\n+}\n+\n+func (a *app) clampCursors() {\n+\tif a.cursorFav >= len(a.favorites) {\n+\t\ta.cursorFav = max(len(a.favorites)-1, 0)\n+\t}\n+\tif a.cursorOther >= len(a.others) {\n+\t\ta.cursorOther = max(len(a.others)-1, 0)\n+\t}\n+\tif a.section == 0 && len(a.favorites) == 0 && len(a.others) > 0 {\n+\t\ta.section = 1\n+\t}\n+\tif a.section == 1 && len(a.others) == 0 && len(a.favorites) > 0 {\n+\t\ta.section = 0\n+\t}\n+}\n+\n+func (a *app) selectedName() (string, bool) {\n+\tif a.section == 0 {\n+\t\tif len(a.favorites) == 0 {\n+\t\t\treturn \"\", false\n+\t\t}\n+\t\treturn a.favorites[a.cursorFav].Name, true\n+\t}\n+\tif len(a.others) == 0 {\n+\t\treturn \"\", false\n+\t}\n+\treturn a.others[a.cursorOther].Name, true\n+}\n+\n+func (a *app) hotkeyTarget(r rune) (string, bool) {\n+\tfor name, key := range a.hotkeys {\n+\t\tif key == r {\n+\t\t\treturn name, true\n+\t\t}\n+\t}\n+\treturn \"\", false\n+}\n+\n+func (a *app) selectByName(name string) {\n+\tif idx := indexSession(a.favorites, name); idx >= 0 {\n+\t\ta.section = 0\n+\t\ta.cursorFav = idx\n+\t\treturn\n+\t}\n+\tif idx := indexSession(a.others, name); idx >= 0 {\n+\t\ta.section = 1\n+\t\ta.cursorOther = idx\n+\t}\n+}\n+\n+func (a *app) setStatus(msg string) {\n+\ta.status = msg\n+\ta.statusExpiry = time.Now().Add(4 * time.Second)\n+}\n+\n+func (a *app) setError(err error) {\n+\ta.status = \"error: \" + err.Error()\n+\ta.statusExpiry = time.Now().Add(8 * time.Second)\n+}\n+\n+func (a *app) visibleStatus() string {\n+\tif a.status == \"\" {\n+\t\treturn \"\"\n+\t}\n+\tif a.statusExpiry.IsZero() || time.Now().Before(a.statusExpiry) {\n+\t\treturn a.status\n+\t}\n+\ta.status = \"\"\n+\treturn \"\"\n+}\n+\n+func indexSession(sessions []session, name string) int {\n+\tfor i, s := range sessions {\n+\t\tif s.Name == name {\n+\t\t\treturn i\n+\t\t}\n+\t}\n+\treturn -1\n+}\n+\n+func indexOf(items []string, target string) int {\n+\tfor i, item := range items {\n+\t\tif item == target {\n+\t\t\treturn i\n+\t\t}\n+\t}\n+\treturn -1\n+}\n+\n+func removeAt(items []string, idx int) []string {\n+\tout := make([]string, 0, len(items)-1)\n+\tout = append(out, items[:idx]...)\n+\tout = append(out, items[idx+1:]...)\n+\treturn out\n+}\n+\n+func removeByValue(items []string, target string) []string {\n+\tout := make([]string, 0, len(items))\n+\tfor _, item := range items {\n+\t\tif item == target {\n+\t\t\tcontinue\n+\t\t}\n+\t\tout = append(out, item)\n+\t}\n+\treturn out\n+}\n+\n+func max(a int, b int) int {\n+\tif a > b {\n+\t\treturn a\n+\t}\n+\treturn b\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
A home/waylon/git/tgo/cmd/tgo/app.go

LSP errors detected in home/waylon/git/tgo/cmd/tgo/app.go, please fix:
<diagnostics file="/home/waylon/git/tgo/cmd/tgo/app.go">
ERROR [8:2] could not import github.com/gdamore/tcell/v2 (no required module provides package "github.com/gdamore/tcell/v2")
ERROR [55:17] undefined: tcell
ERROR [65:4] a.draw undefined (type *app has no field or method draw)
ERROR [70:9] undefined: tcell
ERROR [72:6] a.draw undefined (type *app has no field or method draw)
ERROR [73:9] undefined: tcell
ERROR [85:6] a.draw undefined (type *app has no field or method draw)
ERROR [90:30] undefined: tcell
ERROR [95:18] undefined: tcell
ERROR [99:18] undefined: tcell
ERROR [104:18] undefined: tcell
ERROR [111:18] undefined: tcell
ERROR [141:7] undefined: tcell
ERROR [143:7] undefined: tcell
ERROR [150:36] undefined: tcell
ERROR [152:7] undefined: tcell
ERROR [156:7] undefined: tcell
ERROR [175:7] undefined: tcell
ERROR [175:27] undefined: tcell
ERROR [180:7] undefined: tcell
</diagnostics>

Assistant (Build · gpt-5.3-codex · 20.9s) #

Thinking:

Creating view file and adding dependency

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Add File: /home/waylon/git/tgo/cmd/tgo/view.go\n+package main\n+\n+import (\n+\t\"fmt\"\n+\t\"strings\"\n+\n+\t\"github.com/gdamore/tcell/v2\"\n+)\n+\n+func (a *app) draw(screen tcell.Screen) {\n+\twidth, height := screen.Size()\n+\tscreen.Clear()\n+\n+\theaderStyle := tcell.StyleDefault.Foreground(tcell.ColorAqua).Bold(true)\n+\thelpStyle := tcell.StyleDefault.Foreground(tcell.ColorGray)\n+\tstatusStyle := tcell.StyleDefault.Foreground(tcell.ColorGreen)\n+\terrorStyle := tcell.StyleDefault.Foreground(tcell.ColorRed)\n+\n+\tline := 0\n+\ta.drawText(screen, 0, line, headerStyle, \"tgo - tmux session switcher\")\n+\tline++\n+\n+\thelp := \"[letters] switch  [j/k or arrows] move  [tab] section  [space] reorder  [f] favorite  [n] new  [x] kill  [r] refresh  [enter] switch  [q] quit\"\n+\ta.drawText(screen, 0, line, helpStyle, truncate(help, width))\n+\tline++\n+\n+\tif a.mode == modeCreate {\n+\t\tprompt := \"new session name: \" + a.createInput\n+\t\ta.drawText(screen, 0, line, tcell.StyleDefault.Foreground(tcell.ColorYellow), truncate(prompt, width))\n+\t\tline++\n+\t}\n+\n+\tline = a.drawSection(screen, line, width, height, \"Favorites\", a.favorites, a.cursorFav, a.section == 0)\n+\tline = a.drawSection(screen, line, width, height, \"Others\", a.others, a.cursorOther, a.section == 1)\n+\n+\tstatus := a.visibleStatus()\n+\tif status != \"\" {\n+\t\tstyle := statusStyle\n+\t\tif strings.HasPrefix(status, \"error:\") {\n+\t\t\tstyle = errorStyle\n+\t\t}\n+\t\ta.drawText(screen, 0, height-1, style, truncate(status, width))\n+\t}\n+\n+\tscreen.Show()\n+}\n+\n+func (a *app) drawSection(screen tcell.Screen, y int, width int, height int, title string, rows []session, cursor int, active bool) int {\n+\tif y >= height-1 {\n+\t\treturn y\n+\t}\n+\n+\ttitleStyle := tcell.StyleDefault.Foreground(tcell.ColorWhite)\n+\tif active {\n+\t\ttitleStyle = titleStyle.Bold(true).Foreground(tcell.ColorBlue)\n+\t}\n+\ta.drawText(screen, 0, y, titleStyle, fmt.Sprintf(\"%s (%d)\", title, len(rows)))\n+\ty++\n+\n+\tif len(rows) == 0 {\n+\t\ta.drawText(screen, 2, y, tcell.StyleDefault.Foreground(tcell.ColorGray), \"- no sessions -\")\n+\t\treturn y + 1\n+\t}\n+\n+\tavailable := max((height-1)-y, 1)\n+\tif cursor < 0 {\n+\t\tcursor = 0\n+\t}\n+\tstart := 0\n+\tif cursor >= available {\n+\t\tstart = cursor - available + 1\n+\t}\n+\tend := min(start+available, len(rows))\n+\n+\tfor i := start; i < end; i++ {\n+\t\tif y >= height-1 {\n+\t\t\tbreak\n+\t\t}\n+\t\ts := rows[i]\n+\t\tkeyLabel := \" \"\n+\t\tif r, ok := a.hotkeys[s.Name]; ok {\n+\t\t\tkeyLabel = string(r)\n+\t\t}\n+\t\tattached := \" \"\n+\t\tif s.Attached {\n+\t\t\tattached = \"*\"\n+\t\t}\n+\t\tprefix := \"  \"\n+\t\tstyle := tcell.StyleDefault\n+\t\tif i == cursor && active {\n+\t\t\tprefix = \"> \"\n+\t\t\tstyle = style.Background(tcell.ColorGray).Foreground(tcell.ColorBlack)\n+\t\t}\n+\t\tif a.mode == modeReorder && i == cursor && active {\n+\t\t\tstyle = style.Background(tcell.ColorYellow).Foreground(tcell.ColorBlack)\n+\t\t}\n+\t\trow := fmt.Sprintf(\"%s[%s] %s %s\", prefix, keyLabel, attached, s.Name)\n+\t\ta.drawText(screen, 0, y, style, truncate(row, width))\n+\t\ty++\n+\t}\n+\n+\treturn y\n+}\n+\n+func (a *app) drawText(screen tcell.Screen, x int, y int, style tcell.Style, text string) {\n+\tfor _, r := range text {\n+\t\tscreen.SetContent(x, y, r, nil, style)\n+\t\tx++\n+\t}\n+}\n+\n+func truncate(text string, width int) string {\n+\tif width <= 0 {\n+\t\treturn \"\"\n+\t}\n+\trunes := []rune(text)\n+\tif len(runes) <= width {\n+\t\treturn text\n+\t}\n+\tif width == 1 {\n+\t\treturn \"…\"\n+\t}\n+\treturn string(runes[:width-1]) + \"…\"\n+}\n+\n+func min(a int, b int) int {\n+\tif a < b {\n+\t\treturn a\n+\t}\n+\treturn b\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
A home/waylon/git/tgo/cmd/tgo/view.go

LSP errors detected in home/waylon/git/tgo/cmd/tgo/view.go, please fix:
<diagnostics file="/home/waylon/git/tgo/cmd/tgo/view.go">
ERROR [10:27] undefined: tcell
ERROR [14:17] undefined: tcell
ERROR [14:47] undefined: tcell
ERROR [15:15] undefined: tcell
ERROR [15:45] undefined: tcell
ERROR [16:17] undefined: tcell
ERROR [16:47] undefined: tcell
ERROR [17:16] undefined: tcell
ERROR [17:46] undefined: tcell
ERROR [29:31] undefined: tcell
ERROR [29:61] undefined: tcell
ERROR [48:34] undefined: tcell
ERROR [53:16] undefined: tcell
ERROR [53:46] undefined: tcell
ERROR [55:49] undefined: tcell
ERROR [61:28] undefined: tcell
ERROR [61:58] undefined: tcell
ERROR [89:12] undefined: tcell
ERROR [92:29] undefined: tcell
ERROR [92:57] undefined: tcell
... and 4 more
</diagnostics>

Assistant (Build · gpt-5.3-codex · 5.3s) #

Thinking:

Running dependencies update

Tool: bash

Input:

{
  "command": "go get github.com/gdamore/tcell/v2 && go mod tidy",
  "workdir": "/home/waylon/git/tgo",
  "description": "Adds tcell dependency and tidies module"
}

Output:

go: downloading github.com/gdamore/tcell/v2 v2.13.8
go: downloading github.com/gdamore/tcell v1.4.1
go: downloading golang.org/x/text v0.31.0
go: downloading golang.org/x/term v0.37.0
go: upgraded go 1.22 => 1.24.0
go: added github.com/gdamore/encoding v1.0.1
go: added github.com/gdamore/tcell/v2 v2.13.8
go: added github.com/lucasb-eyer/go-colorful v1.3.0
go: added github.com/rivo/uniseg v0.4.7
go: added golang.org/x/sys v0.38.0
go: added golang.org/x/term v0.37.0
go: added golang.org/x/text v0.31.0

Assistant (Build · gpt-5.3-codex · 2.2s) #

Thinking:

Assessing Go version upgrade

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/go.mod"
}

Output:

<path>/home/waylon/git/tgo/go.mod</path>
<type>file</type>
<content>1: module tgo
2: 
3: go 1.24.0
4: 
5: require github.com/gdamore/tcell/v2 v2.13.8
6: 
7: require (
8: 	github.com/gdamore/encoding v1.0.1 // indirect
9: 	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
10: 	github.com/rivo/uniseg v0.4.7 // indirect
11: 	golang.org/x/sys v0.38.0 // indirect
12: 	golang.org/x/term v0.37.0 // indirect
13: 	golang.org/x/text v0.31.0 // indirect
14: )

(End of file - total 14 lines)
</content>

Assistant (Build · gpt-5.3-codex · 9.9s) #

Thinking:

Planning Go version and lint fixes

Tool: bash

Input:

{
  "command": "go test ./...",
  "workdir": "/home/waylon/git/tgo",
  "description": "Runs tests to check compilation"
}

Output:

ok  	tgo/cmd/tgo	0.002s

Assistant (Build · gpt-5.3-codex · 10.8s) #

Thinking:

Planning input handling fixes

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/cmd/tgo/app.go\n@@\n import (\n \t\"fmt\"\n \t\"strings\"\n \t\"time\"\n+\t\"unicode\"\n@@\n \tcursorFav   int\n \tcursorOther int\n-\tscrollFav   int\n-\tscrollOther int\n@@\n-\tif key.Key() == tcell.KeyCtrlC || key.Rune() == 'q' {\n+\tif key.Key() == tcell.KeyCtrlC || key.Key() == tcell.KeyEscape {\n \t\treturn true, \"\"\n \t}\n@@\n \tif key.Key() == tcell.KeyRune {\n-\t\tr := key.Rune()\n+\t\tr := unicode.ToLower(key.Rune())\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/cmd/tgo/app.go

Assistant (Build · gpt-5.3-codex · 3.8s) #

Thinking:

Updating quit hotkey in help text

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/cmd/tgo/view.go\n@@\n-\thelp := \"[letters] switch  [j/k or arrows] move  [tab] section  [space] reorder  [f] favorite  [n] new  [x] kill  [r] refresh  [enter] switch  [q] quit\"\n+\thelp := \"[letters] switch  [j/k or arrows] move  [tab] section  [space] reorder  [f] favorite  [n] new  [x] kill  [r] refresh  [enter] switch  [esc/ctrl+c] quit\"\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/cmd/tgo/view.go

Assistant (Build · gpt-5.3-codex · 19.4s) #

Thinking:

Planning focused unit tests

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Add File: /home/waylon/git/tgo/cmd/tgo/logic_test.go\n+package main\n+\n+import (\n+\t\"reflect\"\n+\t\"testing\"\n+)\n+\n+func TestNormalizeState(t *testing.T) {\n+\tsessions := []session{{Name: \"api\"}, {Name: \"web\"}, {Name: \"db\"}}\n+\tst := state{\n+\t\tFavorites: []string{\"web\", \"web\", \"missing\", \"api\"},\n+\t\tOrder:     []string{\"db\", \"api\", \"missing\", \"db\"},\n+\t}\n+\n+\tgot := normalizeState(st, sessions)\n+\n+\tif !reflect.DeepEqual(got.Favorites, []string{\"web\", \"api\"}) {\n+\t\tt.Fatalf(\"favorites mismatch: got %v\", got.Favorites)\n+\t}\n+\tif !reflect.DeepEqual(got.Order, []string{\"db\"}) {\n+\t\tt.Fatalf(\"order mismatch: got %v\", got.Order)\n+\t}\n+}\n+\n+func TestOrderSessions(t *testing.T) {\n+\tsessions := []session{{Name: \"api\"}, {Name: \"web\"}, {Name: \"db\"}, {Name: \"docs\"}}\n+\tst := state{\n+\t\tFavorites: []string{\"web\", \"api\"},\n+\t\tOrder:     []string{\"docs\", \"db\"},\n+\t}\n+\n+\tfavorites, others := orderSessions(sessions, st)\n+\n+\tif got := names(favorites); !reflect.DeepEqual(got, []string{\"web\", \"api\"}) {\n+\t\tt.Fatalf(\"favorites order mismatch: got %v\", got)\n+\t}\n+\tif got := names(others); !reflect.DeepEqual(got, []string{\"docs\", \"db\"}) {\n+\t\tt.Fatalf(\"others order mismatch: got %v\", got)\n+\t}\n+}\n+\n+func TestAssignHotkeys(t *testing.T) {\n+\tfavorites := []session{{Name: \"web\"}, {Name: \"api\"}}\n+\tothers := []session{{Name: \"db\"}, {Name: \"docs\"}}\n+\n+\tgot := assignHotkeys(favorites, others, SessionHotkeyAlphabet())\n+\n+\tassertHotkey(t, got, \"web\", 'a')\n+\tassertHotkey(t, got, \"api\", 's')\n+\tassertHotkey(t, got, \"db\", 'd')\n+\tassertHotkey(t, got, \"docs\", 'f')\n+}\n+\n+func TestAssignHotkeysLimit(t *testing.T) {\n+\talpha := \"as\"\n+\tfavorites := []session{{Name: \"one\"}}\n+\tothers := []session{{Name: \"two\"}, {Name: \"three\"}}\n+\n+\tgot := assignHotkeys(favorites, others, alpha)\n+\n+\tassertHotkey(t, got, \"one\", 'a')\n+\tassertHotkey(t, got, \"two\", 's')\n+\tif _, ok := got[\"three\"]; ok {\n+\t\tt.Fatalf(\"expected no hotkey for third session\")\n+\t}\n+}\n+\n+func names(sessions []session) []string {\n+\tout := make([]string, 0, len(sessions))\n+\tfor _, s := range sessions {\n+\t\tout = append(out, s.Name)\n+\t}\n+\treturn out\n+}\n+\n+func assertHotkey(t *testing.T, got map[string]rune, name string, expected rune) {\n+\tt.Helper()\n+\tif got[name] != expected {\n+\t\tt.Fatalf(\"hotkey mismatch for %s: got %q want %q\", name, got[name], expected)\n+\t}\n+}\n*** End Patch"
}

Output:

Success. Updated the following files:
A home/waylon/git/tgo/cmd/tgo/logic_test.go

Assistant (Build · gpt-5.3-codex · 19.1s) #

Thinking:

Planning README rewrite

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/README.md\n@@\n-# tgo\n-\n-tgo is a tmux session switcher optimized for speed and predictability. It runs inside a tmux popup or terminal, draws the active sessions, highlights favorites, and lets you switch with a single letter after opening (two keystrokes overall). The focus is low latency: the popup hotkey triggers `tgo`, and the keyboard-only UI assumes tmux-level terminal performance and responsive layouts.\n-\n-## UX guidance\n-\n-- **Two-keystroke flow**: Press the tmux popup hotkey, then tap the letter mapped to the target session. No arrow navigation, no typing a name twice.\n-- **Key map**: `asdf qwert zxcvb` serves as the ordered list of hotkeys. Favorites are pinned to the top of the list so that letters stay stable even when promting terminals resize.\n-- **Sizing**: `tgo` will render the session list responsively so that both narrow popups and larger terminals remain usable—critical for tmux popup contexts.\n-\n-## Architecture notes\n-\n-- `cmd/tgo` contains the CLI entry point and will orchestrate session discovery, layout, and rendering logic.\n-- Session data comes from tmux via shell calls (placeholder now), with an overlay layer for the favorites list and letter assignment.\n-- UI rendering will target the terminal/popup dimensions reported by tmux, keeping control loops synchronous so the hotkey response stays within one frame.\n-\n-## Local workflow (using `just`)\n-\n-1. Install [just](https://github.com/casey/just) if missing.\n-2. `just fmt` to format Go files.\n-3. `just lint` to run `golangci-lint` if it is installed (falls back to a warning otherwise).\n-4. `just test` to exercise the package.\n-5. `just build` produces `bin/tgo` under the repository root.\n-6. `just run` executes the CLI locally.\n-7. `just tidy` keeps `go.mod` and `go.sum` neat.\n-8. `just ci` runs `fmt`, `lint`, and `test` in sequence for a quick check before pushing.\n-\n-## Example tmux binding\n-\n-```tmux\n-bind-key q run-shell \"tmux popup -E 'tgo'\"\n-```\n-\n-This binding opens a popup that immediately starts `tgo`, letting you press one of the letters from `asdfqwertzxcvb` to jump to the desired session.\n+# tgo\n+\n+`tgo` is a fast tmux session switcher built for popup workflows.\n+\n+The core flow is two keystrokes:\n+\n+1. open `tgo` in a tmux popup from a tmux key binding\n+2. press the session letter and switch instantly\n+\n+`tgo` lists tmux sessions, pins favorites at the top, and keeps hotkeys stable by priority.\n+\n+## Features\n+\n+- responsive terminal UI that works in standard terminals and tmux popups\n+- direct switch hotkeys using `asdfqwertzxcvb`\n+- favorite pinning with favorites always rendered first\n+- reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment\n+- tmux session management from the UI: create (`n`) and kill (`x`)\n+\n+## Keymap\n+\n+- `asdfqwertzxcvb`: switch directly to listed session\n+- `j/k` or arrow keys: move cursor\n+- `tab`: switch active section (`Favorites` / `Others`)\n+- `space`: toggle reorder mode for selected session\n+- `enter`: switch to selected session\n+- `f`: toggle favorite on selected session\n+- `n`: create new tmux session (type name, `enter`)\n+- `x`: kill selected tmux session\n+- `r`: refresh tmux session list\n+- `esc` or `ctrl+c`: quit\n+\n+## tmux popup binding\n+\n+```tmux\n+bind-key g display-popup -E -w 70% -h 70% \"tgo\"\n+```\n+\n+Pick any key you want instead of `g`.\n+\n+## State storage\n+\n+`tgo` stores favorites and non-favorite ordering in:\n+\n+- `~/.config/tgo/state.json`\n+\n+Missing or stale sessions are automatically removed from saved state.\n+\n+## Local development\n+\n+1. Install [just](https://github.com/casey/just)\n+2. Run `just build` to produce `bin/tgo`\n+3. Run `just run` inside tmux to use the app\n+4. Run `just ci` before pushing changes\n+\n+## Notes\n+\n+- `tgo` expects a running tmux server and a tmux client context.\n+- switching is implemented with `tmux switch-client -t <session>`.\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/README.md

Assistant (Build · gpt-5.3-codex · 5.1s) #

Thinking:

Updating changelog

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/CHANGELOG.md\n@@\n ## [Unreleased]\n \n ### Added\n-- base Go module, CLI entry point, and placeholder session hotkey collection.\n-- `justfile` with formatter, lint, test, build, run, tidy, and CI recipes.\n-- `README.md` describing the command, UX goal, architecture notes, tmux binding, and local workflow.\n-- `CHANGELOG.md` initial structure plus README and changelog.\n-- GitHub workflows for CI, dependency updates, and release automation, along with cross-platform binary packaging and checksums.\n+- interactive TUI built with `tcell`, including responsive rendering for tmux popup usage.\n+- tmux integration for listing sessions, switching clients, creating sessions, and killing sessions.\n+- sectioned session view with favorites pinned at the top and direct hotkey switching via `asdfqwertzxcvb`.\n+- reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment.\n+- persisted state file at `~/.config/tgo/state.json` with normalization for removed/stale sessions.\n+- unit tests for ordering, normalization, and hotkey assignment logic.\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/CHANGELOG.md

Assistant (Build · gpt-5.3-codex · 4.5s) #

Thinking:

Updating CI Go version and release workflow

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/.github/workflows/ci.yml\n@@\n       - name: Set up Go\n         uses: actions/setup-go@v5\n         with:\n-          go-version: 1.22\n+          go-version: 1.24\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/.github/workflows/ci.yml

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/.github/workflows/release.yml\n@@\n       - name: Set up Go\n         uses: actions/setup-go@v5\n         with:\n-          go-version: 1.22\n+          go-version: 1.24\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/.github/workflows/release.yml

Assistant (Build · gpt-5.3-codex · 3.9s) #

Thinking:

Running gofmt and tests

Tool: bash

Input:

{
  "command": "gofmt -w ./cmd/tgo/*.go && go test ./...",
  "workdir": "/home/waylon/git/tgo",
  "description": "Formats Go files and runs tests"
}

Output:

ok  	tgo/cmd/tgo	0.003s

Assistant (Build · gpt-5.3-codex · 4.7s) #

Thinking:

Planning sequential test updates

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Inspect current tgo scaffold and define concrete TUI/session management architecture",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Implement tmux integration and persistent state (favorites/order)",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Implement interactive TUI with navigation, section switching, hotkeys, and reorder mode",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Update README with implemented behavior and usage",
      "status": "completed",
      "priority": "medium"
    },
    {
      "content": "Add/expand tests for key mapping, ordering, and state normalization",
      "status": "completed",
      "priority": "medium"
    },
    {
      "content": "Run formatting and tests to validate full functionality",
      "status": "completed",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Inspect current tgo scaffold and define concrete TUI/session management architecture",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Implement tmux integration and persistent state (favorites/order)",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Implement interactive TUI with navigation, section switching, hotkeys, and reorder mode",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Update README with implemented behavior and usage",
    "status": "completed",
    "priority": "medium"
  },
  {
    "content": "Add/expand tests for key mapping, ordering, and state normalization",
    "status": "completed",
    "priority": "medium"
  },
  {
    "content": "Run formatting and tests to validate full functionality",
    "status": "completed",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 4.2s) #

Thinking:

Reviewing main application code

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/app.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/app.go</path>
<type>file</type>
<content>1: package main
2: 
3: import (
4: 	"fmt"
5: 	"strings"
6: 	"time"
7: 	"unicode"
8: 
9: 	"github.com/gdamore/tcell/v2"
10: )
11: 
12: type mode int
13: 
14: const (
15: 	modeNormal mode = iota
16: 	modeReorder
17: 	modeCreate
18: )
19: 
20: type app struct {
21: 	client tmuxClient
22: 	store  *stateStore
23: 
24: 	state     state
25: 	sessions  []session
26: 	favorites []session
27: 	others    []session
28: 	hotkeys   map[string]rune
29: 
30: 	section     int
31: 	cursorFav   int
32: 	cursorOther int
33: 
34: 	mode        mode
35: 	createInput string
36: 
37: 	status       string
38: 	statusExpiry time.Time
39: }
40: 
41: func newApp(client tmuxClient, store *stateStore) (*app, error) {
42: 	st, err := store.Load()
43: 	if err != nil {
44: 		return nil, err
45: 	}
46: 	a := &app{client: client, store: store, state: st}
47: 	if err := a.refreshSessions(); err != nil {
48: 		return nil, err
49: 	}
50: 	return a, nil
51: }
52: 
53: func (a *app) Run() error {
54: 	screen, err := tcell.NewScreen()
55: 	if err != nil {
56: 		return fmt.Errorf("create screen: %w", err)
57: 	}
58: 	if err := screen.Init(); err != nil {
59: 		return fmt.Errorf("init screen: %w", err)
60: 	}
61: 	defer screen.Fini()
62: 
63: 	screen.HideCursor()
64: 	a.draw(screen)
65: 
66: 	for {
67: 		ev := screen.PollEvent()
68: 		switch e := ev.(type) {
69: 		case *tcell.EventResize:
70: 			screen.Sync()
71: 			a.draw(screen)
72: 		case *tcell.EventKey:
73: 			done, runSwitch := a.handleKey(e)
74: 			if runSwitch != "" {
75: 				screen.Fini()
76: 				if err := a.client.SwitchSession(runSwitch); err != nil {
77: 					return err
78: 				}
79: 				return nil
80: 			}
81: 			if done {
82: 				return nil
83: 			}
84: 			a.draw(screen)
85: 		}
86: 	}
87: }
88: 
89: func (a *app) handleKey(key *tcell.EventKey) (done bool, switchTo string) {
90: 	if a.mode == modeCreate {
91: 		return a.handleCreateKey(key)
92: 	}
93: 
94: 	if key.Key() == tcell.KeyCtrlC || key.Key() == tcell.KeyEscape {
95: 		return true, ""
96: 	}
97: 
98: 	if key.Key() == tcell.KeyTab {
99: 		a.toggleSection()
100: 		return false, ""
101: 	}
102: 
103: 	if key.Key() == tcell.KeyEnter {
104: 		if name, ok := a.selectedName(); ok {
105: 			return false, name
106: 		}
107: 		return false, ""
108: 	}
109: 
110: 	if key.Key() == tcell.KeyRune {
111: 		r := unicode.ToLower(key.Rune())
112: 		if name, ok := a.hotkeyTarget(r); ok {
113: 			return false, name
114: 		}
115: 		switch r {
116: 		case 'j':
117: 			a.moveDown()
118: 		case 'k':
119: 			a.moveUp()
120: 		case ' ':
121: 			a.toggleReorderMode()
122: 		case 'f':
123: 			a.toggleFavorite()
124: 		case 'x':
125: 			a.killSelected()
126: 		case 'n':
127: 			a.mode = modeCreate
128: 			a.createInput = ""
129: 			a.status = "new session: type name and press Enter"
130: 			a.statusExpiry = time.Time{}
131: 		case 'r':
132: 			if err := a.refreshSessions(); err != nil {
133: 				a.setError(err)
134: 			}
135: 		}
136: 		return false, ""
137: 	}
138: 
139: 	switch key.Key() {
140: 	case tcell.KeyUp:
141: 		a.moveUp()
142: 	case tcell.KeyDown:
143: 		a.moveDown()
144: 	}
145: 
146: 	return false, ""
147: }
148: 
149: func (a *app) handleCreateKey(key *tcell.EventKey) (bool, string) {
150: 	switch key.Key() {
151: 	case tcell.KeyEsc:
152: 		a.mode = modeNormal
153: 		a.setStatus("create canceled")
154: 		return false, ""
155: 	case tcell.KeyEnter:
156: 		name := strings.TrimSpace(a.createInput)
157: 		if name == "" {
158: 			a.setStatus("session name cannot be empty")
159: 			return false, ""
160: 		}
161: 		if err := a.client.NewSession(name); err != nil {
162: 			a.setError(err)
163: 			return false, ""
164: 		}
165: 		a.mode = modeNormal
166: 		a.createInput = ""
167: 		if err := a.refreshSessions(); err != nil {
168: 			a.setError(err)
169: 			return false, ""
170: 		}
171: 		a.selectByName(name)
172: 		a.setStatus(fmt.Sprintf("created %s", name))
173: 		return false, ""
174: 	case tcell.KeyBackspace, tcell.KeyBackspace2:
175: 		if len(a.createInput) > 0 {
176: 			a.createInput = a.createInput[:len(a.createInput)-1]
177: 		}
178: 		return false, ""
179: 	case tcell.KeyRune:
180: 		r := key.Rune()
181: 		if r >= 32 && r <= 126 {
182: 			a.createInput += string(r)
183: 		}
184: 		return false, ""
185: 	default:
186: 		return false, ""
187: 	}
188: }
189: 
190: func (a *app) toggleSection() {
191: 	if len(a.favorites) == 0 && len(a.others) == 0 {
192: 		return
193: 	}
194: 	if a.section == 0 {
195: 		if len(a.others) > 0 {
196: 			a.section = 1
197: 		}
198: 		return
199: 	}
200: 	if len(a.favorites) > 0 {
201: 		a.section = 0
202: 	}
203: }
204: 
205: func (a *app) moveUp() {
206: 	if a.mode == modeReorder {
207: 		a.reorder(-1)
208: 		return
209: 	}
210: 	if a.section == 0 {
211: 		if a.cursorFav > 0 {
212: 			a.cursorFav--
213: 		}
214: 		return
215: 	}
216: 	if a.cursorOther > 0 {
217: 		a.cursorOther--
218: 	}
219: }
220: 
221: func (a *app) moveDown() {
222: 	if a.mode == modeReorder {
223: 		a.reorder(1)
224: 		return
225: 	}
226: 	if a.section == 0 {
227: 		if a.cursorFav < len(a.favorites)-1 {
228: 			a.cursorFav++
229: 		}
230: 		return
231: 	}
232: 	if a.cursorOther < len(a.others)-1 {
233: 		a.cursorOther++
234: 	}
235: }
236: 
237: func (a *app) toggleReorderMode() {
238: 	if _, ok := a.selectedName(); !ok {
239: 		return
240: 	}
241: 	if a.mode == modeReorder {
242: 		a.mode = modeNormal
243: 		a.setStatus("reorder mode off")
244: 		return
245: 	}
246: 	a.mode = modeReorder
247: 	a.setStatus("reorder mode on: j/k moves selected session")
248: }
249: 
250: func (a *app) toggleFavorite() {
251: 	name, ok := a.selectedName()
252: 	if !ok {
253: 		return
254: 	}
255: 
256: 	idx := indexOf(a.state.Favorites, name)
257: 	if idx >= 0 {
258: 		a.state.Favorites = removeAt(a.state.Favorites, idx)
259: 		a.state.Order = append([]string{name}, a.state.Order...)
260: 		a.setStatus(fmt.Sprintf("unfavorited %s", name))
261: 	} else {
262: 		a.state.Favorites = append(a.state.Favorites, name)
263: 		a.state.Order = removeByValue(a.state.Order, name)
264: 		a.setStatus(fmt.Sprintf("favorited %s", name))
265: 	}
266: 	if err := a.persistAndRebuild(); err != nil {
267: 		a.setError(err)
268: 	}
269: }
270: 
271: func (a *app) reorder(delta int) {
272: 	name, ok := a.selectedName()
273: 	if !ok {
274: 		return
275: 	}
276: 	if a.section == 0 {
277: 		idx := indexOf(a.state.Favorites, name)
278: 		if idx < 0 {
279: 			return
280: 		}
281: 		newIdx := idx + delta
282: 		if newIdx < 0 || newIdx >= len(a.state.Favorites) {
283: 			return
284: 		}
285: 		a.state.Favorites[idx], a.state.Favorites[newIdx] = a.state.Favorites[newIdx], a.state.Favorites[idx]
286: 		a.cursorFav = newIdx
287: 	} else {
288: 		names := make([]string, 0, len(a.others))
289: 		for _, s := range a.others {
290: 			names = append(names, s.Name)
291: 		}
292: 		idx := indexOf(names, name)
293: 		if idx < 0 {
294: 			return
295: 		}
296: 		newIdx := idx + delta
297: 		if newIdx < 0 || newIdx >= len(names) {
298: 			return
299: 		}
300: 		names[idx], names[newIdx] = names[newIdx], names[idx]
301: 		a.state.Order = names
302: 		a.cursorOther = newIdx
303: 	}
304: 	if err := a.persistAndRebuild(); err != nil {
305: 		a.setError(err)
306: 		return
307: 	}
308: 	a.setStatus("priority updated")
309: }
310: 
311: func (a *app) killSelected() {
312: 	name, ok := a.selectedName()
313: 	if !ok {
314: 		return
315: 	}
316: 	if err := a.client.KillSession(name); err != nil {
317: 		a.setError(err)
318: 		return
319: 	}
320: 	a.state.Favorites = removeByValue(a.state.Favorites, name)
321: 	a.state.Order = removeByValue(a.state.Order, name)
322: 	if err := a.persistAndRebuild(); err != nil {
323: 		a.setError(err)
324: 		return
325: 	}
326: 	a.setStatus(fmt.Sprintf("killed %s", name))
327: }
328: 
329: func (a *app) refreshSessions() error {
330: 	sessions, err := a.client.ListSessions()
331: 	if err != nil {
332: 		return err
333: 	}
334: 	a.sessions = sessions
335: 	a.state = normalizeState(a.state, sessions)
336: 	a.rebuildLists()
337: 	if err := a.store.Save(a.state); err != nil {
338: 		return err
339: 	}
340: 	return nil
341: }
342: 
343: func (a *app) persistAndRebuild() error {
344: 	a.state = normalizeState(a.state, a.sessions)
345: 	a.rebuildLists()
346: 	return a.store.Save(a.state)
347: }
348: 
349: func (a *app) rebuildLists() {
350: 	a.favorites, a.others = orderSessions(a.sessions, a.state)
351: 	a.hotkeys = assignHotkeys(a.favorites, a.others, SessionHotkeyAlphabet())
352: 	a.clampCursors()
353: }
354: 
355: func (a *app) clampCursors() {
356: 	if a.cursorFav >= len(a.favorites) {
357: 		a.cursorFav = max(len(a.favorites)-1, 0)
358: 	}
359: 	if a.cursorOther >= len(a.others) {
360: 		a.cursorOther = max(len(a.others)-1, 0)
361: 	}
362: 	if a.section == 0 && len(a.favorites) == 0 && len(a.others) > 0 {
363: 		a.section = 1
364: 	}
365: 	if a.section == 1 && len(a.others) == 0 && len(a.favorites) > 0 {
366: 		a.section = 0
367: 	}
368: }
369: 
370: func (a *app) selectedName() (string, bool) {
371: 	if a.section == 0 {
372: 		if len(a.favorites) == 0 {
373: 			return "", false
374: 		}
375: 		return a.favorites[a.cursorFav].Name, true
376: 	}
377: 	if len(a.others) == 0 {
378: 		return "", false
379: 	}
380: 	return a.others[a.cursorOther].Name, true
381: }
382: 
383: func (a *app) hotkeyTarget(r rune) (string, bool) {
384: 	for name, key := range a.hotkeys {
385: 		if key == r {
386: 			return name, true
387: 		}
388: 	}
389: 	return "", false
390: }
391: 
392: func (a *app) selectByName(name string) {
393: 	if idx := indexSession(a.favorites, name); idx >= 0 {
394: 		a.section = 0
395: 		a.cursorFav = idx
396: 		return
397: 	}
398: 	if idx := indexSession(a.others, name); idx >= 0 {
399: 		a.section = 1
400: 		a.cursorOther = idx
401: 	}
402: }
403: 
404: func (a *app) setStatus(msg string) {
405: 	a.status = msg
406: 	a.statusExpiry = time.Now().Add(4 * time.Second)
407: }
408: 
409: func (a *app) setError(err error) {
410: 	a.status = "error: " + err.Error()
411: 	a.statusExpiry = time.Now().Add(8 * time.Second)
412: }
413: 
414: func (a *app) visibleStatus() string {
415: 	if a.status == "" {
416: 		return ""
417: 	}
418: 	if a.statusExpiry.IsZero() || time.Now().Before(a.statusExpiry) {
419: 		return a.status
420: 	}
421: 	a.status = ""
422: 	return ""
423: }
424: 
425: func indexSession(sessions []session, name string) int {
426: 	for i, s := range sessions {
427: 		if s.Name == name {
428: 			return i
429: 		}
430: 	}
431: 	return -1
432: }
433: 
434: func indexOf(items []string, target string) int {
435: 	for i, item := range items {
436: 		if item == target {
437: 			return i
438: 		}
439: 	}
440: 	return -1
441: }
442: 
443: func removeAt(items []string, idx int) []string {
444: 	out := make([]string, 0, len(items)-1)
445: 	out = append(out, items[:idx]...)
446: 	out = append(out, items[idx+1:]...)
447: 	return out
448: }
449: 
450: func removeByValue(items []string, target string) []string {
451: 	out := make([]string, 0, len(items))
452: 	for _, item := range items {
453: 		if item == target {
454: 			continue
455: 		}
456: 		out = append(out, item)
457: 	}
458: 	return out
459: }
460: 
461: func max(a int, b int) int {
462: 	if a > b {
463: 		return a
464: 	}
465: 	return b
466: }

(End of file - total 466 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/view.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/view.go</path>
<type>file</type>
<content>1: package main
2: 
3: import (
4: 	"fmt"
5: 	"strings"
6: 
7: 	"github.com/gdamore/tcell/v2"
8: )
9: 
10: func (a *app) draw(screen tcell.Screen) {
11: 	width, height := screen.Size()
12: 	screen.Clear()
13: 
14: 	headerStyle := tcell.StyleDefault.Foreground(tcell.ColorAqua).Bold(true)
15: 	helpStyle := tcell.StyleDefault.Foreground(tcell.ColorGray)
16: 	statusStyle := tcell.StyleDefault.Foreground(tcell.ColorGreen)
17: 	errorStyle := tcell.StyleDefault.Foreground(tcell.ColorRed)
18: 
19: 	line := 0
20: 	a.drawText(screen, 0, line, headerStyle, "tgo - tmux session switcher")
21: 	line++
22: 
23: 	help := "[letters] switch  [j/k or arrows] move  [tab] section  [space] reorder  [f] favorite  [n] new  [x] kill  [r] refresh  [enter] switch  [esc/ctrl+c] quit"
24: 	a.drawText(screen, 0, line, helpStyle, truncate(help, width))
25: 	line++
26: 
27: 	if a.mode == modeCreate {
28: 		prompt := "new session name: " + a.createInput
29: 		a.drawText(screen, 0, line, tcell.StyleDefault.Foreground(tcell.ColorYellow), truncate(prompt, width))
30: 		line++
31: 	}
32: 
33: 	line = a.drawSection(screen, line, width, height, "Favorites", a.favorites, a.cursorFav, a.section == 0)
34: 	line = a.drawSection(screen, line, width, height, "Others", a.others, a.cursorOther, a.section == 1)
35: 
36: 	status := a.visibleStatus()
37: 	if status != "" {
38: 		style := statusStyle
39: 		if strings.HasPrefix(status, "error:") {
40: 			style = errorStyle
41: 		}
42: 		a.drawText(screen, 0, height-1, style, truncate(status, width))
43: 	}
44: 
45: 	screen.Show()
46: }
47: 
48: func (a *app) drawSection(screen tcell.Screen, y int, width int, height int, title string, rows []session, cursor int, active bool) int {
49: 	if y >= height-1 {
50: 		return y
51: 	}
52: 
53: 	titleStyle := tcell.StyleDefault.Foreground(tcell.ColorWhite)
54: 	if active {
55: 		titleStyle = titleStyle.Bold(true).Foreground(tcell.ColorBlue)
56: 	}
57: 	a.drawText(screen, 0, y, titleStyle, fmt.Sprintf("%s (%d)", title, len(rows)))
58: 	y++
59: 
60: 	if len(rows) == 0 {
61: 		a.drawText(screen, 2, y, tcell.StyleDefault.Foreground(tcell.ColorGray), "- no sessions -")
62: 		return y + 1
63: 	}
64: 
65: 	available := max((height-1)-y, 1)
66: 	if cursor < 0 {
67: 		cursor = 0
68: 	}
69: 	start := 0
70: 	if cursor >= available {
71: 		start = cursor - available + 1
72: 	}
73: 	end := min(start+available, len(rows))
74: 
75: 	for i := start; i < end; i++ {
76: 		if y >= height-1 {
77: 			break
78: 		}
79: 		s := rows[i]
80: 		keyLabel := " "
81: 		if r, ok := a.hotkeys[s.Name]; ok {
82: 			keyLabel = string(r)
83: 		}
84: 		attached := " "
85: 		if s.Attached {
86: 			attached = "*"
87: 		}
88: 		prefix := "  "
89: 		style := tcell.StyleDefault
90: 		if i == cursor && active {
91: 			prefix = "> "
92: 			style = style.Background(tcell.ColorGray).Foreground(tcell.ColorBlack)
93: 		}
94: 		if a.mode == modeReorder && i == cursor && active {
95: 			style = style.Background(tcell.ColorYellow).Foreground(tcell.ColorBlack)
96: 		}
97: 		row := fmt.Sprintf("%s[%s] %s %s", prefix, keyLabel, attached, s.Name)
98: 		a.drawText(screen, 0, y, style, truncate(row, width))
99: 		y++
100: 	}
101: 
102: 	return y
103: }
104: 
105: func (a *app) drawText(screen tcell.Screen, x int, y int, style tcell.Style, text string) {
106: 	for _, r := range text {
107: 		screen.SetContent(x, y, r, nil, style)
108: 		x++
109: 	}
110: }
111: 
112: func truncate(text string, width int) string {
113: 	if width <= 0 {
114: 		return ""
115: 	}
116: 	runes := []rune(text)
117: 	if len(runes) <= width {
118: 		return text
119: 	}
120: 	if width == 1 {
121: 		return "…"
122: 	}
123: 	return string(runes[:width-1]) + "…"
124: }
125: 
126: func min(a int, b int) int {
127: 	if a < b {
128: 		return a
129: 	}
130: 	return b
131: }

(End of file - total 131 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/tmux.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/tmux.go</path>
<type>file</type>
<content>1: package main
2: 
3: import (
4: 	"bytes"
5: 	"fmt"
6: 	"os/exec"
7: 	"sort"
8: 	"strings"
9: )
10: 
11: type session struct {
12: 	Name     string
13: 	Attached bool
14: }
15: 
16: type tmuxClient interface {
17: 	ListSessions() ([]session, error)
18: 	SwitchSession(name string) error
19: 	KillSession(name string) error
20: 	NewSession(name string) error
21: }
22: 
23: type tmuxCLI struct{}
24: 
25: func (t *tmuxCLI) ListSessions() ([]session, error) {
26: 	cmd := exec.Command("tmux", "list-sessions", "-F", "#{session_name}|#{?session_attached,1,0}")
27: 	out, err := cmd.Output()
28: 	if err != nil {
29: 		return nil, fmt.Errorf("list sessions: %w", err)
30: 	}
31: 
32: 	lines := strings.Split(strings.TrimSpace(string(out)), "\n")
33: 	if len(lines) == 1 && lines[0] == "" {
34: 		return []session{}, nil
35: 	}
36: 
37: 	sessions := make([]session, 0, len(lines))
38: 	for _, line := range lines {
39: 		parts := strings.SplitN(line, "|", 2)
40: 		if len(parts) != 2 {
41: 			continue
42: 		}
43: 		sessions = append(sessions, session{
44: 			Name:     parts[0],
45: 			Attached: parts[1] == "1",
46: 		})
47: 	}
48: 
49: 	return sessions, nil
50: }
51: 
52: func (t *tmuxCLI) SwitchSession(name string) error {
53: 	if name == "" {
54: 		return fmt.Errorf("empty session name")
55: 	}
56: 	cmd := exec.Command("tmux", "switch-client", "-t", name)
57: 	if out, err := cmd.CombinedOutput(); err != nil {
58: 		return fmt.Errorf("switch session %q: %w (%s)", name, err, strings.TrimSpace(string(out)))
59: 	}
60: 	return nil
61: }
62: 
63: func (t *tmuxCLI) KillSession(name string) error {
64: 	if name == "" {
65: 		return fmt.Errorf("empty session name")
66: 	}
67: 	cmd := exec.Command("tmux", "kill-session", "-t", name)
68: 	if out, err := cmd.CombinedOutput(); err != nil {
69: 		return fmt.Errorf("kill session %q: %w (%s)", name, err, strings.TrimSpace(string(out)))
70: 	}
71: 	return nil
72: }
73: 
74: func (t *tmuxCLI) NewSession(name string) error {
75: 	if name == "" {
76: 		return fmt.Errorf("empty session name")
77: 	}
78: 	cmd := exec.Command("tmux", "new-session", "-d", "-s", name)
79: 	if out, err := cmd.CombinedOutput(); err != nil {
80: 		return fmt.Errorf("new session %q: %w (%s)", name, err, strings.TrimSpace(string(out)))
81: 	}
82: 	return nil
83: }
84: 
85: func orderSessions(sessions []session, st state) (favorites []session, others []session) {
86: 	nameToSession := make(map[string]session, len(sessions))
87: 	tmuxOrder := make(map[string]int, len(sessions))
88: 	for i, s := range sessions {
89: 		nameToSession[s.Name] = s
90: 		tmuxOrder[s.Name] = i
91: 	}
92: 
93: 	for _, name := range st.Favorites {
94: 		s, ok := nameToSession[name]
95: 		if !ok {
96: 			continue
97: 		}
98: 		favorites = append(favorites, s)
99: 	}
100: 
101: 	favSet := make(map[string]struct{}, len(favorites))
102: 	for _, s := range favorites {
103: 		favSet[s.Name] = struct{}{}
104: 	}
105: 
106: 	nonFav := make([]session, 0, len(sessions)-len(favorites))
107: 	for _, s := range sessions {
108: 		if _, ok := favSet[s.Name]; ok {
109: 			continue
110: 		}
111: 		nonFav = append(nonFav, s)
112: 	}
113: 
114: 	orderIndex := make(map[string]int, len(st.Order))
115: 	for i, name := range st.Order {
116: 		orderIndex[name] = i
117: 	}
118: 
119: 	sort.SliceStable(nonFav, func(i, j int) bool {
120: 		li, iok := orderIndex[nonFav[i].Name]
121: 		lj, jok := orderIndex[nonFav[j].Name]
122: 		switch {
123: 		case iok && jok:
124: 			return li < lj
125: 		case iok:
126: 			return true
127: 		case jok:
128: 			return false
129: 		default:
130: 			return tmuxOrder[nonFav[i].Name] < tmuxOrder[nonFav[j].Name]
131: 		}
132: 	})
133: 
134: 	return favorites, nonFav
135: }
136: 
137: func assignHotkeys(favorites []session, others []session, alphabet string) map[string]rune {
138: 	out := make(map[string]rune)
139: 	ordered := make([]session, 0, len(favorites)+len(others))
140: 	ordered = append(ordered, favorites...)
141: 	ordered = append(ordered, others...)
142: 
143: 	runes := []rune(alphabet)
144: 	for i, s := range ordered {
145: 		if i >= len(runes) {
146: 			break
147: 		}
148: 		out[s.Name] = runes[i]
149: 	}
150: 	return out
151: }
152: 
153: func runesToString(m map[string]rune, ordered []session) string {
154: 	buf := bytes.Buffer{}
155: 	for _, s := range ordered {
156: 		r, ok := m[s.Name]
157: 		if !ok {
158: 			continue
159: 		}
160: 		buf.WriteRune(r)
161: 	}
162: 	return buf.String()
163: }

(End of file - total 163 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/cmd/tgo/state.go"
}

Output:

<path>/home/waylon/git/tgo/cmd/tgo/state.go</path>
<type>file</type>
<content>1: package main
2: 
3: import (
4: 	"encoding/json"
5: 	"errors"
6: 	"fmt"
7: 	"os"
8: 	"path/filepath"
9: )
10: 
11: type state struct {
12: 	Favorites []string `json:"favorites"`
13: 	Order     []string `json:"order"`
14: }
15: 
16: type stateStore struct {
17: 	path string
18: }
19: 
20: func openStateStore() (*stateStore, error) {
21: 	configDir, err := os.UserConfigDir()
22: 	if err != nil {
23: 		return nil, fmt.Errorf("config dir: %w", err)
24: 	}
25: 	return &stateStore{path: filepath.Join(configDir, "tgo", "state.json")}, nil
26: }
27: 
28: func (s *stateStore) Load() (state, error) {
29: 	data, err := os.ReadFile(s.path)
30: 	if err != nil {
31: 		if errors.Is(err, os.ErrNotExist) {
32: 			return state{}, nil
33: 		}
34: 		return state{}, fmt.Errorf("read state: %w", err)
35: 	}
36: 
37: 	var st state
38: 	if err := json.Unmarshal(data, &st); err != nil {
39: 		bak := s.path + ".bak"
40: 		_ = os.Rename(s.path, bak)
41: 		return state{}, nil
42: 	}
43: 	return st, nil
44: }
45: 
46: func (s *stateStore) Save(st state) error {
47: 	dir := filepath.Dir(s.path)
48: 	if err := os.MkdirAll(dir, 0o755); err != nil {
49: 		return fmt.Errorf("create state dir: %w", err)
50: 	}
51: 	data, err := json.MarshalIndent(st, "", "  ")
52: 	if err != nil {
53: 		return fmt.Errorf("marshal state: %w", err)
54: 	}
55: 	if err := os.WriteFile(s.path, data, 0o644); err != nil {
56: 		return fmt.Errorf("write state: %w", err)
57: 	}
58: 	return nil
59: }
60: 
61: func normalizeState(st state, sessions []session) state {
62: 	exists := make(map[string]struct{}, len(sessions))
63: 	for _, s := range sessions {
64: 		exists[s.Name] = struct{}{}
65: 	}
66: 
67: 	st.Favorites = dedupeAndFilter(st.Favorites, exists)
68: 
69: 	favSet := make(map[string]struct{}, len(st.Favorites))
70: 	for _, name := range st.Favorites {
71: 		favSet[name] = struct{}{}
72: 	}
73: 
74: 	allowedOthers := make(map[string]struct{}, len(sessions)-len(st.Favorites))
75: 	for _, s := range sessions {
76: 		if _, fav := favSet[s.Name]; fav {
77: 			continue
78: 		}
79: 		allowedOthers[s.Name] = struct{}{}
80: 	}
81: 	st.Order = dedupeAndFilter(st.Order, allowedOthers)
82: 	return st
83: }
84: 
85: func dedupeAndFilter(items []string, allowed map[string]struct{}) []string {
86: 	seen := map[string]struct{}{}
87: 	out := make([]string, 0, len(items))
88: 	for _, item := range items {
89: 		if item == "" {
90: 			continue
91: 		}
92: 		if _, ok := allowed[item]; !ok {
93: 			continue
94: 		}
95: 		if _, dup := seen[item]; dup {
96: 			continue
97: 		}
98: 		seen[item] = struct{}{}
99: 		out = append(out, item)
100: 	}
101: 	return out
102: }

(End of file - total 102 lines)
</content>

Assistant (Build · gpt-5.3-codex · 4.0s) #

Thinking:

Assessing unused code and tests

Tool: bash

Input:

{
  "command": "go build ./cmd/tgo",
  "workdir": "/home/waylon/git/tgo",
  "description": "Builds tgo command to verify compile"
}

Assistant (Build · gpt-5.3-codex · 2.1s) #

Thinking:

Checking Go 1.24 and CI caching

Tool: glob

Input:

{
  "pattern": "go.sum",
  "path": "/home/waylon/git/tgo"
}

Output:

/home/waylon/git/tgo/go.sum

Assistant (Build · gpt-5.3-codex · 8.7s) #

Thinking:

Summarizing completed TUI changes

Implemented: tgo is now a real interactive TUI for listing, switching, and managing tmux sessions with your fast popup flow.

Built a full terminal UI with tcell in cmd/tgo/app.go and cmd/tgo/view.go:
- j/k + arrow navigation
- tab section switching (Favorites / Others)
- letter switching via asdfqwertzxcvb (instant switch + exit)
- space toggles reorder mode; j/k reorders and updates hotkey priority live
Added tmux operations in cmd/tgo/tmux.go:
- list sessions
- switch client
- create session (n)
- kill session (x)
Added persistent priority/favorites state in cmd/tgo/state.go:
- saved at ~/.config/tgo/state.json
- stale/missing sessions are normalized out automatically
- corrupt state is backed up to .bak
Updated startup wiring in cmd/tgo/main.go to run the full app.
Expanded tests in cmd/tgo/logic_test.go for normalization, ordering, and hotkey assignment.
Updated docs in README.md and CHANGELOG.md to reflect the implemented behavior.
Updated CI/release Go version to match module version in .github/workflows/ci.yml and .github/workflows/release.yml.

Validation I ran:

go test ./... (pass)
go build ./cmd/tgo (pass)

Next steps you can run:

Launch in tmux now with just run and verify your exact popup flow.
Add your tmux binding from README.md to make it a true two-keystroke switch.
If you want, I can now add optional flags (like --debug, --state-path, --no-manage) and a startup benchmark mode for latency tuning.

User #

version it and cut a release

Assistant (Build · gpt-5.3-codex · 5.5s) #

Thinking:

Assessing git repository state

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
      "status": "in_progress",
      "priority": "high"
    },
    {
      "content": "Choose and apply initial semantic version in changelog",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Commit release prep changes and create git tag",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Create GitHub release with notes and verify artifact workflow trigger",
      "status": "pending",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
    "status": "in_progress",
    "priority": "high"
  },
  {
    "content": "Choose and apply initial semantic version in changelog",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Commit release prep changes and create git tag",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Create GitHub release with notes and verify artifact workflow trigger",
    "status": "pending",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 10.0s) #

Thinking:

Planning parallel git operations

Tool: bash

Input:

{
  "command": "git status --short --branch",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows branch and working tree status"
}

Output:

## main...origin/main

Tool: bash

Input:

{
  "command": "git remote -v",
  "workdir": "/home/waylon/git/tgo",
  "description": "Lists configured git remotes"
}

Output:

origin	https://github.com/WaylonWalker/tgo.git (fetch)
origin	https://github.com/WaylonWalker/tgo.git (push)

Tool: bash

Input:

{
  "command": "git tag --list",
  "workdir": "/home/waylon/git/tgo",
  "description": "Lists existing git tags"
}

Assistant (Build · gpt-5.3-codex · 2.9s) #

Thinking:

Reviewing release setup details

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/CHANGELOG.md"
}

Output:

<path>/home/waylon/git/tgo/CHANGELOG.md</path>
<type>file</type>
<content>1: # Changelog
2: 
3: All notable changes to `tgo` will be documented in this file. This project adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
4: 
5: ## [Unreleased]
6: 
7: ### Added
8: - interactive TUI built with `tcell`, including responsive rendering for tmux popup usage.
9: - tmux integration for listing sessions, switching clients, creating sessions, and killing sessions.
10: - sectioned session view with favorites pinned at the top and direct hotkey switching via `asdfqwertzxcvb`.
11: - reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment.
12: - persisted state file at `~/.config/tgo/state.json` with normalization for removed/stale sessions.
13: - unit tests for ordering, normalization, and hotkey assignment logic.

(End of file - total 13 lines)
</content>

Assistant (Build · gpt-5.3-codex · 3.6s) #

Thinking:

Setting initial version

Tool: bash

Input:

{
  "command": "gh auth status",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks GitHub CLI authentication status"
}

Output:

github.com
  ✓ Logged in to github.com account WaylonWalker (keyring)
  - Active account: true
  - Git operations protocol: https
  - Token: gho_************************************
  - Token scopes: 'gist', 'read:org', 'repo', 'workflow'

Tool: bash

Input:

{
  "command": "git log --oneline -n 5",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows recent commit message style"
}

Output:

41ea734 init

Assistant (Build · gpt-5.3-codex · 7.5s) #

Thinking:

Updating changelog with version

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/CHANGELOG.md\n@@\n ## [Unreleased]\n+\n+## [0.1.0] - 2026-03-04\n \n ### Added\n - interactive TUI built with `tcell`, including responsive rendering for tmux popup usage.\n - tmux integration for listing sessions, switching clients, creating sessions, and killing sessions.\n - sectioned session view with favorites pinned at the top and direct hotkey switching via `asdfqwertzxcvb`.\n - reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment.\n - persisted state file at `~/.config/tgo/state.json` with normalization for removed/stale sessions.\n - unit tests for ordering, normalization, and hotkey assignment logic.\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/CHANGELOG.md

Assistant (Build · gpt-5.3-codex · 5.3s) #

Thinking:

Updating todo status

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Choose and apply initial semantic version in changelog",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Commit release prep changes and create git tag",
      "status": "in_progress",
      "priority": "high"
    },
    {
      "content": "Create GitHub release with notes and verify artifact workflow trigger",
      "status": "pending",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Choose and apply initial semantic version in changelog",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Commit release prep changes and create git tag",
    "status": "in_progress",
    "priority": "high"
  },
  {
    "content": "Create GitHub release with notes and verify artifact workflow trigger",
    "status": "pending",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 3.5s) #

Thinking:

Running pre-commit checks

Tool: bash

Input:

{
  "command": "git status --short",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows files changed for commit"
}

Output:

 M CHANGELOG.md

Tool: bash

Input:

{
  "command": "git diff --staged; git diff",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows staged and unstaged diffs"
}

Output:

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 74804dc..d800505 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,8 @@ All notable changes to `tgo` will be documented in this file. This project adher
 
 ## [Unreleased]
 
+## [0.1.0] - 2026-03-04
+
 ### Added
 - interactive TUI built with `tcell`, including responsive rendering for tmux popup usage.
 - tmux integration for listing sessions, switching clients, creating sessions, and killing sessions.

Tool: bash

Input:

{
  "command": "git log --oneline -n 10",
  "workdir": "/home/waylon/git/tgo",
  "description": "Displays recent commit messages"
}

Output:

41ea734 init

Assistant (Build · gpt-5.3-codex · 2.9s) #

Thinking:

Preparing initial commit

Tool: bash

Input:

{
  "command": "git add CHANGELOG.md && git commit -m \"release: cut v0.1.0\" && git tag -a v0.1.0 -m \"v0.1.0\" && git status --short --branch",
  "workdir": "/home/waylon/git/tgo",
  "description": "Commits changelog and creates v0.1.0 tag"
}

Output:

[main d210c44] release: cut v0.1.0
 1 file changed, 2 insertions(+)
## main...origin/main [ahead 1]

Assistant (Build · gpt-5.3-codex · 4.9s) #

Thinking:

Planning GitHub release creation

Tool: bash

Input:

{
  "command": "git push origin main && git push origin v0.1.0",
  "workdir": "/home/waylon/git/tgo",
  "description": "Pushes release commit and tag to origin"
}

Output:

To https://github.com/WaylonWalker/tgo.git
   41ea734..d210c44  main -> main
To https://github.com/WaylonWalker/tgo.git
 * [new tag]         v0.1.0 -> v0.1.0

Assistant (Build · gpt-5.3-codex · 8.2s) #

Thinking:

Creating GitHub release with notes

Tool: bash

Input:

{
  "command": "gh release create v0.1.0 --title \"v0.1.0\" --notes \"## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.\"",
  "workdir": "/home/waylon/git/tgo",
  "description": "Creates GitHub release for v0.1.0 tag"
}

Output:

zsh:1: command not found: asdfqwertzxcvb
https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0

Assistant (Build · gpt-5.3-codex · 4.0s) #

Thinking:

Inspecting created release notes

Tool: bash

Input:

{
  "command": "gh release view v0.1.0 --json url,name,tagName,isDraft,isPrerelease,body",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows created release details and notes"
}

Output:

{"body":"## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.","isDraft":false,"isPrerelease":false,"name":"v0.1.0","tagName":"v0.1.0","url":"https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0"}

Assistant (Build · gpt-5.3-codex · 4.3s) #

Thinking:

Fixing release body quoting

Tool: bash

Input:

{
  "command": "gh release edit v0.1.0 --notes '## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.'",
  "workdir": "/home/waylon/git/tgo",
  "description": "Fixes release notes formatting for v0.1.0"
}

Output:

https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0

Assistant (Build · gpt-5.3-codex · 8.4s) #

Thinking:

Checking workflow trigger status

Tool: bash

Input:

{
  "command": "gh run list --workflow release.yml --limit 5 --json databaseId,status,conclusion,displayTitle,event,headBranch,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks latest release workflow runs"
}

Output:

[{"conclusion":"","databaseId":22699585815,"displayTitle":"v0.1.0","event":"release","headBranch":"v0.1.0","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699585815"}]

Assistant (Build · gpt-5.3-codex · 1.9s) #

Thinking:

Checking git status cleanliness

Tool: bash

Input:

{
  "command": "git status --short --branch",
  "workdir": "/home/waylon/git/tgo",
  "description": "Confirms branch status after release"
}

Output:

## main...origin/main

Assistant (Build · gpt-5.3-codex · 2.6s) #

Thinking:

Completing todo updates

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Choose and apply initial semantic version in changelog",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Commit release prep changes and create git tag",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Create GitHub release with notes and verify artifact workflow trigger",
      "status": "completed",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Inspect git/release readiness (repo state, remotes, tags, gh auth)",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Choose and apply initial semantic version in changelog",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Commit release prep changes and create git tag",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Create GitHub release with notes and verify artifact workflow trigger",
    "status": "completed",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 4.2s) #

Done — I versioned and cut the first release.

Versioned as v0.1.0 by updating CHANGELOG.md:7 with ## [0.1.0] - 2026-03-04.
Committed release prep as d210c44 with message release: cut v0.1.0.
Created and pushed tag v0.1.0.
Pushed main and tag to origin.
Created GitHub release: https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0.
Confirmed release workflow started: https://github.com/WaylonWalker/tgo/actions/runs/22699585815 (currently in progress).
Working tree is clean and synced (main...origin/main).

If you want, I can monitor that workflow run and report back when artifacts/checksums are fully published.

User #

in the readme suggest common ways to install out of a release, here are two I know.

mise use -g github:waylonwalker/tgo curl https://i.jpillora.com/waylonwalker/tgo | bash

Assistant (Build · gpt-5.3-codex · 3.3s) #

Thinking:

Planning README installation update

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/README.md"
}

Output:

<path>/home/waylon/git/tgo/README.md</path>
<type>file</type>
<content>1: # tgo
2: 
3: `tgo` is a fast tmux session switcher built for popup workflows.
4: 
5: The core flow is two keystrokes:
6: 
7: 1. open `tgo` in a tmux popup from a tmux key binding
8: 2. press the session letter and switch instantly
9: 
10: `tgo` lists tmux sessions, pins favorites at the top, and keeps hotkeys stable by priority.
11: 
12: ## Features
13: 
14: - responsive terminal UI that works in standard terminals and tmux popups
15: - direct switch hotkeys using `asdfqwertzxcvb`
16: - favorite pinning with favorites always rendered first
17: - reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment
18: - tmux session management from the UI: create (`n`) and kill (`x`)
19: 
20: ## Keymap
21: 
22: - `asdfqwertzxcvb`: switch directly to listed session
23: - `j/k` or arrow keys: move cursor
24: - `tab`: switch active section (`Favorites` / `Others`)
25: - `space`: toggle reorder mode for selected session
26: - `enter`: switch to selected session
27: - `f`: toggle favorite on selected session
28: - `n`: create new tmux session (type name, `enter`)
29: - `x`: kill selected tmux session
30: - `r`: refresh tmux session list
31: - `esc` or `ctrl+c`: quit
32: 
33: ## tmux popup binding
34: 
35: ```tmux
36: bind-key g display-popup -E -w 70% -h 70% "tgo"
37: ```
38: 
39: Pick any key you want instead of `g`.
40: 
41: ## State storage
42: 
43: `tgo` stores favorites and non-favorite ordering in:
44: 
45: - `~/.config/tgo/state.json`
46: 
47: Missing or stale sessions are automatically removed from saved state.
48: 
49: ## Local development
50: 
51: 1. Install [just](https://github.com/casey/just)
52: 2. Run `just build` to produce `bin/tgo`
53: 3. Run `just run` inside tmux to use the app
54: 4. Run `just ci` before pushing changes
55: 
56: ## Notes
57: 
58: - `tgo` expects a running tmux server and a tmux client context.
59: - switching is implemented with `tmux switch-client -t <session>`.

(End of file - total 59 lines)
</content>

Assistant (Build · gpt-5.3-codex · 7.2s) #

Thinking:

Adding install section placement

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/README.md\n@@\n ## Features\n@@\n - reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment\n - tmux session management from the UI: create (`n`) and kill (`x`)\n+\n+## Install\n+\n+Common release install options:\n+\n+```bash\n+mise use -g github:waylonwalker/tgo\n+```\n+\n+```bash\n+curl https://i.jpillora.com/waylonwalker/tgo | bash\n+```\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/README.md

Assistant (Build · gpt-5.3-codex · 1.9s) #

Added an Install section to README.md with both release install methods:

mise use -g github:waylonwalker/tgo
curl https://i.jpillora.com/waylonwalker/tgo | bash

Updated file: README.md

User #

are there more ways?, you surely konw more

Assistant (Build · gpt-5.3-codex · 5.8s) #

Thinking:

Listing Go CLI install methods

Yep, definitely. For a Go CLI like tgo, common install paths are:

go install (build from source):
- go install github.com/waylonwalker/tgo/cmd/tgo@latest
GitHub CLI (download release asset):
- gh release download --repo waylonwalker/tgo --pattern 'tgo-*-linux-amd64.zip'
Manual release download (curl/wget + unzip):
- download from Releases page, unzip, move tgo into $PATH (like /usr/local/bin)
Package managers (if you add them):
- Homebrew tap/formula
- Scoop (Windows)
- Nix flake/package
- asdf plugin (or mise backend plugin)

So your two are great, and the most broadly useful additions right now are:

go install ...@latest
gh release download ... + unzip/move binary

If you want, I can add a polished multi-platform install matrix to README.md next (Linux/macOS/Windows examples).

User #

add those

Assistant (Build · gpt-5.3-codex · 7.1s) #

Thinking:

Updating README with method details

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/README.md\n@@\n ## Install\n \n Common release install options:\n@@\n ```bash\n curl https://i.jpillora.com/waylonwalker/tgo | bash\n ```\n+\n+Install with Go:\n+\n+```bash\n+go install github.com/waylonwalker/tgo/cmd/tgo@latest\n+```\n+\n+Download a release asset with GitHub CLI (example for Linux amd64):\n+\n+```bash\n+gh release download --repo waylonwalker/tgo --pattern 'tgo-linux-amd64.zip'\n+unzip tgo-linux-amd64.zip\n+chmod +x tgo-linux-amd64\n+mv tgo-linux-amd64 /usr/local/bin/tgo\n+```\n+\n+Manual install from the Releases page:\n+\n+1. Download the archive for your OS/arch from `https://github.com/WaylonWalker/tgo/releases`.\n+2. Unzip it.\n+3. Move the binary to a directory in your `PATH` (for example `/usr/local/bin/tgo`).\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/README.md

Assistant (Build · gpt-5.3-codex · 2.3s) #

Added them to README.md under Install:

go install github.com/waylonwalker/tgo/cmd/tgo@latest
gh release download ... flow (with unzip/chmod/mv example)
Manual Releases-page install steps

Updated file: README.md

User #

push changes, move tag, move release, fix all broken ci workflows. address all PRS. delegate to @builder .

Assistant (Build · gpt-5.3-codex · 5.8s) #

Thinking:

Planning delegation with builder

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Draft builder delegation prompt for push, retag/release move, CI fixes, and PR handling",
      "status": "in_progress",
      "priority": "high"
    },
    {
      "content": "Run builder subagent to execute requested git/GitHub operations end-to-end",
      "status": "pending",
      "priority": "high"
    },
    {
      "content": "Review builder output and report final repository/release/CI/PR status",
      "status": "pending",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Draft builder delegation prompt for push, retag/release move, CI fixes, and PR handling",
    "status": "in_progress",
    "priority": "high"
  },
  {
    "content": "Run builder subagent to execute requested git/GitHub operations end-to-end",
    "status": "pending",
    "priority": "high"
  },
  {
    "content": "Review builder output and report final repository/release/CI/PR status",
    "status": "pending",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 41.4s) #

Thinking:

Delegating release and PR tasks

Tool: task

Input:

{
  "description": "Execute repo maintenance tasks",
  "subagent_type": "builder",
  "prompt": "You are operating in /home/waylon/git/tgo with full git and GitHub CLI access.\n\nUser request: \"push changes, move tag, move release, fix all broken ci workflows. address all PRS.\"\n\nContext:\n- Repo: WaylonWalker/tgo\n- Existing release/tag: v0.1.0 already created and pushed previously.\n- Recent local change: README install section updates are present and need to be included.\n- CI/release workflows exist in .github/workflows.\n\nPlease execute this end-to-end (not just research):\n1) Inspect current repo status, branches, tags, open PRs, workflow failures, and release state.\n2) Commit and push any pending local changes needed.\n3) \"Move tag\" and \"move release\" to include latest commit:\n   - Repoint v0.1.0 tag to the desired latest commit.\n   - Ensure GitHub release v0.1.0 points to that updated tag and has accurate notes.\n   - Use safe/non-interactive commands. If force push of tag is required, do it only for the tag.\n4) Fix all currently broken CI workflows (including GitHub Actions config issues). Iterate until failing runs are resolved or clearly limited by external constraints.\n5) Address all open PRs in this repo:\n   - Review each open PR status/checks.\n   - If PR is mergeable and appropriate, merge it.\n   - If not mergeable, leave a concise actionable comment and/or push fixes to resolve blockers when feasible.\n   - Keep branch protections in mind.\n6) Ensure repository ends in a clean state with pushed fixes.\n\nConstraints:\n- Do not rewrite main branch history.\n- Avoid destructive operations except moving the requested tag/release.\n- Do not use interactive git flags.\n\nReturn a concise final report containing:\n- Commits created (hash + message)\n- Tags/releases updated\n- Workflows fixed (what changed and resulting run URLs/status)\n- PRs addressed (IDs, actions taken, resulting state)\n- Any remaining blockers with exact next action."
}

Output:

task_id: ses_34423ebdaffeOtsDOZz2jlNu0i (for resuming to continue this task if needed)

<task_result>
**Commits created**
- None (tooling here prevents running `git status`/`git commit`; README install section edits already in the working tree at `README.md` so they’re ready to commit once CLI access is available).

**Tags/releases updated**
- None (can’t move tag or release without the ability to run `git tag -f`/`git push --force` and `gh release edit`).

**Workflows fixed**
- Not touched; `.github/workflows/ci.yml` and `release.yml` exist but I can’t run or modify them without shell access. Need the ability to inspect failing run logs and push fixes.

**PRs addressed**
- None; unable to list or act on GitHub pull requests because GH CLI/git commands are unavailable.

**Remaining blockers**
- No shell/`git`/`gh` access in this environment; please run the git status history, commit the README edits, force-move the `v0.1.0` tag, update the GitHub release, inspect CI failures, and address the open PRs.
</task_result>

Assistant (Build · gpt-5.3-codex · 10.9s) #

Thinking:

Planning manual task continuation

Tool: bash

Input:

{
  "command": "git status --short --branch",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows git branch and changed files"
}

Output:

## main...origin/main
 M README.md

Tool: bash

Input:

{
  "command": "git diff -- README.md",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows README unstaged changes"
}

Output:

diff --git a/README.md b/README.md
index 400cbc6..555b248 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,39 @@ The core flow is two keystrokes:
 - reorder mode (`space` + `j/k` or arrows) to change session priority and hotkey assignment
 - tmux session management from the UI: create (`n`) and kill (`x`)
 
+## Install
+
+Common release install options:
+
+```bash
+mise use -g github:waylonwalker/tgo
+```
+
+```bash
+curl https://i.jpillora.com/waylonwalker/tgo | bash
+```
+
+Install with Go:
+
+```bash
+go install github.com/waylonwalker/tgo/cmd/tgo@latest
+```
+
+Download a release asset with GitHub CLI (example for Linux amd64):
+
+```bash
+gh release download --repo waylonwalker/tgo --pattern 'tgo-linux-amd64.zip'
+unzip tgo-linux-amd64.zip
+chmod +x tgo-linux-amd64
+mv tgo-linux-amd64 /usr/local/bin/tgo
+```
+
+Manual install from the Releases page:
+
+1. Download the archive for your OS/arch from `https://github.com/WaylonWalker/tgo/releases`.
+2. Unzip it.
+3. Move the binary to a directory in your `PATH` (for example `/usr/local/bin/tgo`).
+
 ## Keymap
 
 - `asdfqwertzxcvb`: switch directly to listed session

Tool: bash

Input:

{
  "command": "gh pr list --state open --limit 50 --json number,title,headRefName,baseRefName,isDraft,mergeable,url,author",
  "workdir": "/home/waylon/git/tgo",
  "description": "Lists open pull requests with mergeability"
}

Output:

[{"author":{"is_bot":true,"login":"app/dependabot"},"baseRefName":"main","headRefName":"dependabot/github_actions/golangci/golangci-lint-action-9","isDraft":false,"mergeable":"UNKNOWN","number":5,"title":"Bump golangci/golangci-lint-action from 4 to 9","url":"https://github.com/WaylonWalker/tgo/pull/5"},{"author":{"is_bot":true,"login":"app/dependabot"},"baseRefName":"main","headRefName":"dependabot/github_actions/actions/checkout-6","isDraft":false,"mergeable":"UNKNOWN","number":4,"title":"Bump actions/checkout from 4 to 6","url":"https://github.com/WaylonWalker/tgo/pull/4"},{"author":{"is_bot":true,"login":"app/dependabot"},"baseRefName":"main","headRefName":"dependabot/github_actions/softprops/action-gh-release-2","isDraft":false,"mergeable":"UNKNOWN","number":3,"title":"Bump softprops/action-gh-release from 1 to 2","url":"https://github.com/WaylonWalker/tgo/pull/3"},{"author":{"is_bot":true,"login":"app/dependabot"},"baseRefName":"main","headRefName":"dependabot/github_actions/actions/cache-5","isDraft":false,"mergeable":"UNKNOWN","number":2,"title":"Bump actions/cache from 3 to 5","url":"https://github.com/WaylonWalker/tgo/pull/2"},{"author":{"is_bot":true,"login":"app/dependabot"},"baseRefName":"main","headRefName":"dependabot/github_actions/actions/setup-go-6","isDraft":false,"mergeable":"UNKNOWN","number":1,"title":"Bump actions/setup-go from 5 to 6","url":"https://github.com/WaylonWalker/tgo/pull/1"}]

Tool: bash

Input:

{
  "command": "gh run list --limit 20 --json databaseId,workflowName,displayTitle,status,conclusion,event,headBranch,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Lists recent GitHub Actions workflow runs"
}

Output:

[{"conclusion":"failure","databaseId":22699585815,"displayTitle":"v0.1.0","event":"release","headBranch":"v0.1.0","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699585815","workflowName":"Release"},{"conclusion":"failure","databaseId":22699582094,"displayTitle":"release: cut v0.1.0","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699582094","workflowName":"CI"},{"conclusion":"failure","databaseId":22699581066,"displayTitle":"Bump golangci/golangci-lint-action from 4 to 9","event":"pull_request","headBranch":"dependabot/github_actions/golangci/golangci-lint-action-9","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699581066","workflowName":"CI"},{"conclusion":"failure","databaseId":22699579673,"displayTitle":"Bump actions/checkout from 4 to 6","event":"pull_request","headBranch":"dependabot/github_actions/actions/checkout-6","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699579673","workflowName":"CI"},{"conclusion":"failure","databaseId":22699578446,"displayTitle":"Bump softprops/action-gh-release from 1 to 2","event":"pull_request","headBranch":"dependabot/github_actions/softprops/action-gh-release-2","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699578446","workflowName":"CI"},{"conclusion":"failure","databaseId":22699577147,"displayTitle":"Bump actions/cache from 3 to 5","event":"pull_request","headBranch":"dependabot/github_actions/actions/cache-5","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699577147","workflowName":"CI"},{"conclusion":"failure","databaseId":22699576373,"displayTitle":"Bump actions/setup-go from 5 to 6","event":"pull_request","headBranch":"dependabot/github_actions/actions/setup-go-6","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699576373","workflowName":"CI"},{"conclusion":"success","databaseId":22699563990,"displayTitle":"go_modules in /. - Update #1268814535","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699563990","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699563842,"displayTitle":"github_actions in /. - Update #1268814536","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699563842","workflowName":"Dependabot Updates"},{"conclusion":"failure","databaseId":22699562904,"displayTitle":"init","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699562904","workflowName":"CI"}]

Assistant (Build · gpt-5.3-codex · 6.6s) #

Thinking:

Inspecting failed workflow logs

Tool: bash

Input:

{
  "command": "gh run view 22699582094 --log-failed",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows failed logs for main CI run"
}

Output:

checks	Run golangci-lint	2026-03-05T02:35:13.6477293Z ##[group]Run golangci/golangci-lint-action@v4
checks	Run golangci-lint	2026-03-05T02:35:13.6477595Z with:
checks	Run golangci-lint	2026-03-05T02:35:13.6477763Z   version: v1.64.0
checks	Run golangci-lint	2026-03-05T02:35:13.6477938Z   args: run ./...
checks	Run golangci-lint	2026-03-05T02:35:13.6478255Z   github-token: ***
checks	Run golangci-lint	2026-03-05T02:35:13.6478888Z   only-new-issues: false
checks	Run golangci-lint	2026-03-05T02:35:13.6479109Z   skip-cache: false
checks	Run golangci-lint	2026-03-05T02:35:13.6479299Z   skip-pkg-cache: false
checks	Run golangci-lint	2026-03-05T02:35:13.6479505Z   skip-build-cache: false
checks	Run golangci-lint	2026-03-05T02:35:13.6479713Z   install-mode: binary
checks	Run golangci-lint	2026-03-05T02:35:13.6479899Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:35:13.8055884Z ##[group]prepare environment
checks	Run golangci-lint	2026-03-05T02:35:13.8060321Z Checking for go.mod: go.mod
checks	Run golangci-lint	2026-03-05T02:35:13.9100921Z ##[warning]Failed to restore: Cache service responded with 400
checks	Run golangci-lint	2026-03-05T02:35:13.9111419Z Cache not found for input keys: golangci-lint.cache-2931-2e9307367ecafa9cfe0e490aacded5605e3eff13, golangci-lint.cache-2931-
checks	Run golangci-lint	2026-03-05T02:35:13.9112578Z Finding needed golangci-lint version...
checks	Run golangci-lint	2026-03-05T02:35:13.9113062Z Installation mode: binary
checks	Run golangci-lint	2026-03-05T02:35:13.9113568Z Installing golangci-lint binary v1.64.0...
checks	Run golangci-lint	2026-03-05T02:35:13.9114998Z Downloading binary https://github.com/golangci/golangci-lint/releases/download/v1.64.0/golangci-lint-1.64.0-linux-amd64.tar.gz ...
checks	Run golangci-lint	2026-03-05T02:35:14.1330367Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:35:14.1386981Z ##[error]Failed to run: Error: Unexpected HTTP response: 404, Error: Unexpected HTTP response: 404
checks	Run golangci-lint	    at /home/runner/work/_actions/golangci/golangci-lint-action/v4/dist/run/index.js:7078:25
checks	Run golangci-lint	    at Generator.next (<anonymous>)
checks	Run golangci-lint	    at fulfilled (/home/runner/work/_actions/golangci/golangci-lint-action/v4/dist/run/index.js:6988:58)
checks	Run golangci-lint	    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
checks	Run golangci-lint	2026-03-05T02:35:14.1391395Z ##[error]Unexpected HTTP response: 404

Tool: bash

Input:

{
  "command": "gh run view 22699585815 --log-failed",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows failed logs for release run"
}

Output:

build	Publish release assets	2026-03-05T02:35:55.1423406Z ##[group]Run softprops/action-gh-release@v1
build	Publish release assets	2026-03-05T02:35:55.1423689Z with:
build	Publish release assets	2026-03-05T02:35:55.1423899Z   files: artifacts/*.zip
build	Publish release assets	artifacts/checksums.txt
build	Publish release assets	
build	Publish release assets	2026-03-05T02:35:55.1424317Z   token: ***
build	Publish release assets	2026-03-05T02:35:55.1424474Z env:
build	Publish release assets	2026-03-05T02:35:55.1424717Z   GITHUB_TOKEN: ***
build	Publish release assets	2026-03-05T02:35:55.1424893Z ##[endgroup]
build	Publish release assets	2026-03-05T02:35:55.5637067Z ⚠️ Unexpected error fetching GitHub release for tag refs/tags/v0.1.0: HttpError: Resource not accessible by integration
build	Publish release assets	2026-03-05T02:35:55.5660126Z ##[error]Resource not accessible by integration

Assistant (Build · gpt-5.3-codex · 15.2s) #

Thinking:

Updating CI workflows and actions

Tool: bash

Input:

{
  "command": "gh pr diff 1",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows diff for PR 1"
}

Output:

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c6e17a..6ebdf4c 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,7 +12,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Set up Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version: 1.24
       - name: Cache Go modules
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index b928326..2accb13 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -10,7 +10,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Set up Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version: 1.24
       - name: Build cross-platform binaries

Tool: bash

Input:

{
  "command": "gh pr diff 2",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows diff for PR 2"
}

Output:

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c6e17a..52957a1 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -16,7 +16,7 @@ jobs:
         with:
           go-version: 1.24
       - name: Cache Go modules
-        uses: actions/cache@v3
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cache/go-build

Tool: bash

Input:

{
  "command": "gh pr diff 3",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows diff for PR 3"
}

Output:

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index b928326..3d50947 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -41,7 +41,7 @@ jobs:
           done
           sha256sum "$artifacts"/*.zip > "$artifacts/checksums.txt"
       - name: Publish release assets
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           files: |
             artifacts/*.zip

Tool: bash

Input:

{
  "command": "gh pr diff 4",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows diff for PR 4"
}

Output:

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c6e17a..12ada8d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -10,7 +10,7 @@ jobs:
   checks:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index b928326..5ba15b5 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -8,7 +8,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Go
         uses: actions/setup-go@v5
         with:

Tool: bash

Input:

{
  "command": "gh pr diff 5",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows diff for PR 5"
}

Output:

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c6e17a..96c24af 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -25,7 +25,7 @@ jobs:
       - name: Format code
         run: go fmt ./...
       - name: Run golangci-lint
-        uses: golangci/golangci-lint-action@v4
+        uses: golangci/golangci-lint-action@v9
         with:
           version: v1.64.0
           args: run ./...

Assistant (Build · gpt-5.3-codex · 5.5s) #

Thinking:

Upgrading GitHub actions versions and permissions

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/.github/workflows/ci.yml"
}

Output:

<path>/home/waylon/git/tgo/.github/workflows/ci.yml</path>
<type>file</type>
<content>1: name: CI
2: 
3: on:
4:   push:
5:     branches: [main]
6:   pull_request:
7:     branches: [main]
8: 
9: jobs:
10:   checks:
11:     runs-on: ubuntu-latest
12:     steps:
13:       - uses: actions/checkout@v4
14:       - name: Set up Go
15:         uses: actions/setup-go@v5
16:         with:
17:           go-version: 1.24
18:       - name: Cache Go modules
19:         uses: actions/cache@v3
20:         with:
21:           path: |
22:             ~/.cache/go-build
23:             ~/go/pkg/mod
24:           key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
25:       - name: Format code
26:         run: go fmt ./...
27:       - name: Run golangci-lint
28:         uses: golangci/golangci-lint-action@v4
29:         with:
30:           version: v1.64.0
31:           args: run ./...
32:       - name: Vet packages
33:         run: go vet ./...
34:       - name: Run tests
35:         run: go test ./...

(End of file - total 35 lines)
</content>

Tool: read

Input:

{
  "filePath": "/home/waylon/git/tgo/.github/workflows/release.yml"
}

Output:

<path>/home/waylon/git/tgo/.github/workflows/release.yml</path>
<type>file</type>
<content>1: name: Release
2: 
3: on:
4:   release:
5:     types: [published]
6: 
7: jobs:
8:   build:
9:     runs-on: ubuntu-latest
10:     steps:
11:       - uses: actions/checkout@v4
12:       - name: Set up Go
13:         uses: actions/setup-go@v5
14:         with:
15:           go-version: 1.24
16:       - name: Build cross-platform binaries
17:         run: |
18:           set -euo pipefail
19:           artifacts=artifacts
20:           mkdir -p "$artifacts"
21:           combos=(
22:             linux:amd64
23:             linux:arm64
24:             darwin:amd64
25:             darwin:arm64
26:             windows:amd64
27:             windows:arm64
28:           )
29:           for combo in "${combos[@]}"; do
30:             os=${combo%%:*}
31:             arch=${combo##*:}
32:             bin_name="tgo-${os}-${arch}"
33:             bin_path="$artifacts/${bin_name}"
34:             if [[ "$os" == "windows" ]]; then
35:               bin_path+=".exe"
36:             fi
37:             GOOS="$os" GOARCH="$arch" go build -ldflags "-s -w" -o "$bin_path" ./cmd/tgo
38:             archive="$artifacts/${bin_name}.zip"
39:             zip -j "$archive" "$bin_path"
40:             rm "$bin_path"
41:           done
42:           sha256sum "$artifacts"/*.zip > "$artifacts/checksums.txt"
43:       - name: Publish release assets
44:         uses: softprops/action-gh-release@v1
45:         with:
46:           files: |
47:             artifacts/*.zip
48:             artifacts/checksums.txt
49:         env:
50:           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

(End of file - total 50 lines)
</content>

Assistant (Build · gpt-5.3-codex · 10.4s) #

Thinking:

Planning Go version and patch updates

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/.github/workflows/ci.yml\n@@\n     runs-on: ubuntu-latest\n     steps:\n-      - uses: actions/checkout@v4\n+      - uses: actions/checkout@v6\n       - name: Set up Go\n-        uses: actions/setup-go@v5\n+        uses: actions/setup-go@v6\n         with:\n           go-version: 1.24\n       - name: Cache Go modules\n-        uses: actions/cache@v3\n+        uses: actions/cache@v5\n@@\n       - name: Run golangci-lint\n-        uses: golangci/golangci-lint-action@v4\n+        uses: golangci/golangci-lint-action@v9\n         with:\n-          version: v1.64.0\n+          version: latest\n           args: run ./...\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/.github/workflows/ci.yml

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/.github/workflows/release.yml\n@@\n on:\n   release:\n     types: [published]\n+\n+permissions:\n+  contents: write\n@@\n   build:\n     runs-on: ubuntu-latest\n     steps:\n-      - uses: actions/checkout@v4\n+      - uses: actions/checkout@v6\n       - name: Set up Go\n-        uses: actions/setup-go@v5\n+        uses: actions/setup-go@v6\n         with:\n           go-version: 1.24\n@@\n       - name: Publish release assets\n-        uses: softprops/action-gh-release@v1\n+        uses: softprops/action-gh-release@v2\n         with:\n           files: |\n             artifacts/*.zip\n             artifacts/checksums.txt\n-        env:\n-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/.github/workflows/release.yml

Assistant (Build · gpt-5.3-codex · 5.8s) #

Thinking:

Committing changes and running tests

Tool: bash

Input:

{
  "command": "go test ./...",
  "workdir": "/home/waylon/git/tgo",
  "description": "Runs Go tests before committing changes"
}

Output:

ok  	tgo/cmd/tgo	(cached)

Tool: bash

Input:

{
  "command": "git status --short",
  "workdir": "/home/waylon/git/tgo",
  "description": "Shows files changed before commit"
}

Output:

 M .github/workflows/ci.yml
 M .github/workflows/release.yml
 M README.md

Assistant (Build · gpt-5.3-codex · 3.1s) #

Thinking:

Committing initial changes

Tool: bash

Input:

{
  "command": "git add README.md .github/workflows/ci.yml .github/workflows/release.yml && git commit -m \"chore: update install docs and stabilize actions\" && git push origin main",
  "workdir": "/home/waylon/git/tgo",
  "description": "Commits changes and pushes main branch"
}

Output:

[main db51a9e] chore: update install docs and stabilize actions
 3 files changed, 44 insertions(+), 10 deletions(-)
To https://github.com/WaylonWalker/tgo.git
   d210c44..db51a9e  main -> main

Assistant (Build · gpt-5.3-codex · 8.3s) #

Thinking:

Planning tag and release move

Tool: bash

Input:

{
  "command": "git tag -f v0.1.0 db51a9e && git push --force origin v0.1.0",
  "workdir": "/home/waylon/git/tgo",
  "description": "Moves v0.1.0 tag to latest commit"
}

Output:

Updated tag 'v0.1.0' (was 69667e6)
To https://github.com/WaylonWalker/tgo.git
 + 69667e6...db51a9e v0.1.0 -> v0.1.0 (forced update)

Assistant (Build · gpt-5.3-codex · 4.9s) #

Thinking:

Noticing non-commit object in history

Tool: bash

Input:

{
  "command": "gh release edit v0.1.0 --target db51a9e --notes '## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.\n- Added installation docs for mise, jpillora installer, go install, and GitHub release assets.\n- Updated GitHub Actions versions and release permissions to fix CI/release pipeline failures.'",
  "workdir": "/home/waylon/git/tgo",
  "description": "Moves release target and refreshes release notes"
}

Output:

HTTP 422: Validation Failed (https://api.github.com/repos/WaylonWalker/tgo/releases/293241996)
Release.target_commitish is invalid

Assistant (Build · gpt-5.3-codex · 6.0s) #

Thinking:

Adjusting target parameter usage

Tool: bash

Input:

{
  "command": "gh release edit v0.1.0 --target main --notes '## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.\n- Added installation docs for mise, jpillora installer, go install, and GitHub release assets.\n- Updated GitHub Actions versions and release permissions to fix CI/release pipeline failures.'",
  "workdir": "/home/waylon/git/tgo",
  "description": "Retargets v0.1.0 release to main branch"
}

Output:

https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0

Assistant (Build · gpt-5.3-codex · 11.6s) #

Thinking:

Adding manual workflow trigger and reviewing PRs

Tool: bash

Input:

{
  "command": "gh run list --limit 10 --json databaseId,workflowName,displayTitle,status,conclusion,event,headBranch,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks latest workflow runs after workflow updates"
}

Output:

[{"conclusion":"","databaseId":22699699908,"displayTitle":"github_actions in / for actions/checkout - Update #1268818413","event":"dynamic","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699908","workflowName":"Dependabot Updates"},{"conclusion":"","databaseId":22699699789,"displayTitle":"github_actions in / for golangci/golangci-lint-action - Update #1268818411","event":"dynamic","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699789","workflowName":"Dependabot Updates"},{"conclusion":"","databaseId":22699699295,"displayTitle":"github_actions in / for softprops/action-gh-release - Update #1268818408","event":"dynamic","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699295","workflowName":"Dependabot Updates"},{"conclusion":"","databaseId":22699699236,"displayTitle":"github_actions in / for actions/cache - Update #1268818405","event":"dynamic","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699236","workflowName":"Dependabot Updates"},{"conclusion":"","databaseId":22699698905,"displayTitle":"github_actions in / for actions/setup-go - Update #1268818404","event":"dynamic","headBranch":"main","status":"queued","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699698905","workflowName":"Dependabot Updates"},{"conclusion":"","databaseId":22699690701,"displayTitle":"chore: update install docs and stabilize actions","event":"push","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699690701","workflowName":"CI"},{"conclusion":"failure","databaseId":22699585815,"displayTitle":"v0.1.0","event":"release","headBranch":"v0.1.0","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699585815","workflowName":"Release"},{"conclusion":"failure","databaseId":22699582094,"displayTitle":"release: cut v0.1.0","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699582094","workflowName":"CI"},{"conclusion":"failure","databaseId":22699581066,"displayTitle":"Bump golangci/golangci-lint-action from 4 to 9","event":"pull_request","headBranch":"dependabot/github_actions/golangci/golangci-lint-action-9","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699581066","workflowName":"CI"},{"conclusion":"failure","databaseId":22699579673,"displayTitle":"Bump actions/checkout from 4 to 6","event":"pull_request","headBranch":"dependabot/github_actions/actions/checkout-6","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699579673","workflowName":"CI"}]

Assistant (Build · gpt-5.3-codex · 2.6s) #

Thinking:

Waiting for CI results

Tool: bash

Input:

{
  "command": "gh run watch 22699690701 --exit-status",
  "workdir": "/home/waylon/git/tgo",
  "description": "Watches latest CI run until completion"
}

Output:

Run CI (22699690701) has already completed with 'failure'

Assistant (Build · gpt-5.3-codex · 8.4s) #

Thinking:

Reviewing failure logs

Tool: bash

Input:

{
  "command": "gh run view 22699690701 --log-failed",
  "workdir": "/home/waylon/git/tgo",
  "description": "Displays failed logs for latest CI run"
}

Output:

checks	Run golangci-lint	2026-03-05T02:39:53.4100336Z ##[group]Run golangci/golangci-lint-action@v9
checks	Run golangci-lint	2026-03-05T02:39:53.4100685Z with:
checks	Run golangci-lint	2026-03-05T02:39:53.4100865Z   version: latest
checks	Run golangci-lint	2026-03-05T02:39:53.4101062Z   args: run ./...
checks	Run golangci-lint	2026-03-05T02:39:53.4101253Z   install-mode: binary
checks	Run golangci-lint	2026-03-05T02:39:53.4101462Z   install-only: false
checks	Run golangci-lint	2026-03-05T02:39:53.4101856Z   github-token: ***
checks	Run golangci-lint	2026-03-05T02:39:53.4102056Z   verify: true
checks	Run golangci-lint	2026-03-05T02:39:53.4102253Z   only-new-issues: false
checks	Run golangci-lint	2026-03-05T02:39:53.4102484Z   skip-cache: false
checks	Run golangci-lint	2026-03-05T02:39:53.4102677Z   skip-save-cache: false
checks	Run golangci-lint	2026-03-05T02:39:53.4102894Z   cache-invalidation-interval: 7
checks	Run golangci-lint	2026-03-05T02:39:53.4103142Z   problem-matchers: false
checks	Run golangci-lint	2026-03-05T02:39:53.4103358Z env:
checks	Run golangci-lint	2026-03-05T02:39:53.4103537Z   GOTOOLCHAIN: local
checks	Run golangci-lint	2026-03-05T02:39:53.4103723Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:39:53.5573089Z ##[group]Restore cache
checks	Run golangci-lint	2026-03-05T02:39:53.5577067Z Checking for go.mod: go.mod
checks	Run golangci-lint	2026-03-05T02:39:53.5582547Z (node:2480) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
checks	Run golangci-lint	2026-03-05T02:39:53.5583547Z (Use `node --trace-deprecation ...` to show where the warning was created)
checks	Run golangci-lint	2026-03-05T02:39:53.6275095Z Cache not found for input keys: golangci-lint.cache-Linux-2931-2e9307367ecafa9cfe0e490aacded5605e3eff13, golangci-lint.cache-Linux-2931-
checks	Run golangci-lint	2026-03-05T02:39:53.6276699Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:39:53.6277821Z ##[group]Install
checks	Run golangci-lint	2026-03-05T02:39:53.6278396Z Finding needed golangci-lint version...
checks	Run golangci-lint	2026-03-05T02:39:53.6662031Z Requested golangci-lint 'latest', using 'v2.10.1', calculation took 38ms
checks	Run golangci-lint	2026-03-05T02:39:53.6662945Z Installation mode: binary
checks	Run golangci-lint	2026-03-05T02:39:53.6663462Z Installing golangci-lint binary v2.10.1...
checks	Run golangci-lint	2026-03-05T02:39:53.6664712Z Downloading binary https://github.com/golangci/golangci-lint/releases/download/v2.10.1/golangci-lint-2.10.1-linux-amd64.tar.gz ...
checks	Run golangci-lint	2026-03-05T02:39:53.8524715Z [command]/usr/bin/tar xz --overwrite --warning=no-unknown-keyword --overwrite -C /home/runner -f /home/runner/work/_temp/986f8f88-51b3-446e-8f7b-ff5685a00315
checks	Run golangci-lint	2026-03-05T02:39:54.1104111Z Installed golangci-lint into /home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint in 444ms
checks	Run golangci-lint	2026-03-05T02:39:54.1108152Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:39:54.1111841Z ##[group]run golangci-lint
checks	Run golangci-lint	2026-03-05T02:39:54.1117179Z Running [/home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint config path] in [/home/runner/work/tgo/tgo] ...
checks	Run golangci-lint	2026-03-05T02:39:54.1910735Z Running [/home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint run  run ./...] in [/home/runner/work/tgo/tgo] ...
checks	Run golangci-lint	2026-03-05T02:40:04.6184982Z 0 issues.
checks	Run golangci-lint	2026-03-05T02:40:04.6185253Z 
checks	Run golangci-lint	2026-03-05T02:40:04.6185889Z level=error msg="[linters_context] typechecking error: stat /home/runner/work/tgo/tgo/run: directory not found"
checks	Run golangci-lint	2026-03-05T02:40:04.6186597Z 
checks	Run golangci-lint	2026-03-05T02:40:04.6204030Z ##[error]golangci-lint exit with code 7
checks	Run golangci-lint	2026-03-05T02:40:04.6212754Z Ran golangci-lint in 10428ms
checks	Run golangci-lint	2026-03-05T02:40:04.6213257Z ##[endgroup]

Assistant (Build · gpt-5.3-codex · 4.5s) #

Thinking:

Fixing duplicate run in CI args

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/.github/workflows/ci.yml\n@@\n       - name: Run golangci-lint\n         uses: golangci/golangci-lint-action@v9\n         with:\n           version: latest\n-          args: run ./...\n+          args: ./...\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/.github/workflows/ci.yml

Assistant (Build · gpt-5.3-codex · 7.7s) #

Thinking:

Committing CI fix and reviewing PRs

Tool: bash

Input:

{
  "command": "git add .github/workflows/ci.yml && git commit -m \"fix: correct golangci-lint action args\" && git push origin main",
  "workdir": "/home/waylon/git/tgo",
  "description": "Commits CI lint argument fix and pushes"
}

Output:

[main 29f8b3f] fix: correct golangci-lint action args
 1 file changed, 1 insertion(+), 1 deletion(-)
To https://github.com/WaylonWalker/tgo.git
   db51a9e..29f8b3f  main -> main

Assistant (Build · gpt-5.3-codex · 5.8s) #

Thinking:

Moving tag to latest commit

Tool: bash

Input:

{
  "command": "git tag -f v0.1.0 29f8b3f && git push --force origin v0.1.0",
  "workdir": "/home/waylon/git/tgo",
  "description": "Moves v0.1.0 tag to latest CI-fix commit"
}

Output:

Updated tag 'v0.1.0' (was db51a9e)
To https://github.com/WaylonWalker/tgo.git
 + db51a9e...29f8b3f v0.1.0 -> v0.1.0 (forced update)

Assistant (Build · gpt-5.3-codex · 7.6s) #

Thinking:

Recreating release to fix workflow

Tool: bash

Input:

{
  "command": "gh release delete v0.1.0 --yes && gh release create v0.1.0 --title \"v0.1.0\" --notes '## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.\n- Added installation docs for mise, jpillora installer, go install, and GitHub release assets.\n- Updated GitHub Actions versions and release permissions to stabilize CI and release pipelines.'",
  "workdir": "/home/waylon/git/tgo",
  "description": "Recreates v0.1.0 release to trigger release workflow"
}

Output:

https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0

Assistant (Build · gpt-5.3-codex · 12.7s) #

Thinking:

Closing all superseded PRs

Tool: bash

Input:

{
  "command": "for pr in 1 2 3 4 5; do gh pr comment \"$pr\" --body \"Thanks for the update. I applied these workflow action/version updates directly on main while fixing CI and release automation, so this PR is now superseded.\"; gh pr close \"$pr\"; done",
  "workdir": "/home/waylon/git/tgo",
  "description": "Comments on and closes superseded Dependabot PRs"
}

Output:

https://github.com/WaylonWalker/tgo/pull/1#issuecomment-4001721898
! Pull request WaylonWalker/tgo#1 (Bump actions/setup-go from 5 to 6) is already closed
https://github.com/WaylonWalker/tgo/pull/2#issuecomment-4001721948
! Pull request WaylonWalker/tgo#2 (Bump actions/cache from 3 to 5) is already closed
https://github.com/WaylonWalker/tgo/pull/3#issuecomment-4001722008
! Pull request WaylonWalker/tgo#3 (Bump softprops/action-gh-release from 1 to 2) is already closed
https://github.com/WaylonWalker/tgo/pull/4#issuecomment-4001722055
! Pull request WaylonWalker/tgo#4 (Bump actions/checkout from 4 to 6) is already closed
https://github.com/WaylonWalker/tgo/pull/5#issuecomment-4001722100
! Pull request WaylonWalker/tgo#5 (Bump golangci/golangci-lint-action from 4 to 9) is already closed

Assistant (Build · gpt-5.3-codex · 13.7s) #

Thinking:

Verifying PR and workflow status

Tool: bash

Input:

{
  "command": "gh pr list --state open --limit 20 --json number,title,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks for any remaining open pull requests"
}

Output:

[]

Assistant (Build · gpt-5.3-codex · 4.6s) #

Thinking:

Checking workflow statuses

Tool: bash

Input:

{
  "command": "gh run list --limit 20 --json databaseId,workflowName,displayTitle,status,conclusion,event,headBranch,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Lists recent workflow runs to verify fixes"
}

Output:

[{"conclusion":"","databaseId":22699716792,"displayTitle":"v0.1.0","event":"release","headBranch":"v0.1.0","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699716792","workflowName":"Release"},{"conclusion":"failure","databaseId":22699711833,"displayTitle":"fix: correct golangci-lint action args","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699711833","workflowName":"CI"},{"conclusion":"success","databaseId":22699699908,"displayTitle":"github_actions in / for actions/checkout - Update #1268818413","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699908","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699789,"displayTitle":"github_actions in / for golangci/golangci-lint-action - Update #1268818411","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699789","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699295,"displayTitle":"github_actions in / for softprops/action-gh-release - Update #1268818408","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699295","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699236,"displayTitle":"github_actions in / for actions/cache - Update #1268818405","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699236","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699698905,"displayTitle":"github_actions in / for actions/setup-go - Update #1268818404","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699698905","workflowName":"Dependabot Updates"},{"conclusion":"failure","databaseId":22699690701,"displayTitle":"chore: update install docs and stabilize actions","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699690701","workflowName":"CI"},{"conclusion":"failure","databaseId":22699585815,"displayTitle":"Release","event":"release","headBranch":"v0.1.0","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699585815","workflowName":"Release"},{"conclusion":"failure","databaseId":22699582094,"displayTitle":"release: cut v0.1.0","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699582094","workflowName":"CI"},{"conclusion":"failure","databaseId":22699581066,"displayTitle":"Bump golangci/golangci-lint-action from 4 to 9","event":"pull_request","headBranch":"dependabot/github_actions/golangci/golangci-lint-action-9","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699581066","workflowName":"CI"},{"conclusion":"failure","databaseId":22699579673,"displayTitle":"Bump actions/checkout from 4 to 6","event":"pull_request","headBranch":"dependabot/github_actions/actions/checkout-6","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699579673","workflowName":"CI"},{"conclusion":"failure","databaseId":22699578446,"displayTitle":"Bump softprops/action-gh-release from 1 to 2","event":"pull_request","headBranch":"dependabot/github_actions/softprops/action-gh-release-2","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699578446","workflowName":"CI"},{"conclusion":"failure","databaseId":22699577147,"displayTitle":"Bump actions/cache from 3 to 5","event":"pull_request","headBranch":"dependabot/github_actions/actions/cache-5","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699577147","workflowName":"CI"},{"conclusion":"failure","databaseId":22699576373,"displayTitle":"Bump actions/setup-go from 5 to 6","event":"pull_request","headBranch":"dependabot/github_actions/actions/setup-go-6","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699576373","workflowName":"CI"},{"conclusion":"success","databaseId":22699563990,"displayTitle":"go_modules in /. - Update #1268814535","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699563990","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699563842,"displayTitle":"github_actions in /. - Update #1268814536","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699563842","workflowName":"Dependabot Updates"},{"conclusion":"failure","databaseId":22699562904,"displayTitle":"init","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699562904","workflowName":"CI"}]

Assistant (Build · gpt-5.3-codex · 4.2s) #

Thinking:

Examining CI failure cause

Tool: bash

Input:

{
  "command": "gh run view 22699711833 --log-failed",
  "workdir": "/home/waylon/git/tgo",
  "description": "Displays failed logs for latest CI run"
}

Output:

checks	Run golangci-lint	2026-03-05T02:40:41.6888912Z ##[group]Run golangci/golangci-lint-action@v9
checks	Run golangci-lint	2026-03-05T02:40:41.6889217Z with:
checks	Run golangci-lint	2026-03-05T02:40:41.6889379Z   version: latest
checks	Run golangci-lint	2026-03-05T02:40:41.6889559Z   args: ./...
checks	Run golangci-lint	2026-03-05T02:40:41.6889724Z   install-mode: binary
checks	Run golangci-lint	2026-03-05T02:40:41.6889917Z   install-only: false
checks	Run golangci-lint	2026-03-05T02:40:41.6890233Z   github-token: ***
checks	Run golangci-lint	2026-03-05T02:40:41.6890412Z   verify: true
checks	Run golangci-lint	2026-03-05T02:40:41.6890596Z   only-new-issues: false
checks	Run golangci-lint	2026-03-05T02:40:41.6890794Z   skip-cache: false
checks	Run golangci-lint	2026-03-05T02:40:41.6891186Z   skip-save-cache: false
checks	Run golangci-lint	2026-03-05T02:40:41.6891555Z   cache-invalidation-interval: 7
checks	Run golangci-lint	2026-03-05T02:40:41.6891793Z   problem-matchers: false
checks	Run golangci-lint	2026-03-05T02:40:41.6891983Z env:
checks	Run golangci-lint	2026-03-05T02:40:41.6892145Z   GOTOOLCHAIN: local
checks	Run golangci-lint	2026-03-05T02:40:41.6892321Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:40:41.8304996Z ##[group]Restore cache
checks	Run golangci-lint	2026-03-05T02:40:41.8309650Z Checking for go.mod: go.mod
checks	Run golangci-lint	2026-03-05T02:40:41.8315055Z (node:2406) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
checks	Run golangci-lint	2026-03-05T02:40:41.8316012Z (Use `node --trace-deprecation ...` to show where the warning was created)
checks	Run golangci-lint	2026-03-05T02:40:42.0403836Z Cache hit for: golangci-lint.cache-Linux-2931-2e9307367ecafa9cfe0e490aacded5605e3eff13
checks	Run golangci-lint	2026-03-05T02:40:42.0515022Z (node:2406) [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead. CVEs are not issued for `url.parse()` vulnerabilities.
checks	Run golangci-lint	2026-03-05T02:40:42.3105604Z Received 6048 of 6048 (100.0%), 0.1 MBs/sec
checks	Run golangci-lint	2026-03-05T02:40:42.3106256Z Cache Size: ~0 MB (6048 B)
checks	Run golangci-lint	2026-03-05T02:40:42.3135179Z [command]/usr/bin/tar -xf /home/runner/work/_temp/c31c6f51-5894-40dc-8dac-43cb4ab23586/cache.tzst -P -C /home/runner/work/tgo/tgo --use-compress-program unzstd
checks	Run golangci-lint	2026-03-05T02:40:42.3297774Z Cache restored successfully
checks	Run golangci-lint	2026-03-05T02:40:42.3301976Z Restored cache for golangci-lint from key 'golangci-lint.cache-Linux-2931-2e9307367ecafa9cfe0e490aacded5605e3eff13' in 500ms
checks	Run golangci-lint	2026-03-05T02:40:42.3304437Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:40:42.3305201Z ##[group]Install
checks	Run golangci-lint	2026-03-05T02:40:42.3305737Z Finding needed golangci-lint version...
checks	Run golangci-lint	2026-03-05T02:40:42.3974950Z Requested golangci-lint 'latest', using 'v2.10.1', calculation took 67ms
checks	Run golangci-lint	2026-03-05T02:40:42.3975656Z Installation mode: binary
checks	Run golangci-lint	2026-03-05T02:40:42.3976316Z Installing golangci-lint binary v2.10.1...
checks	Run golangci-lint	2026-03-05T02:40:42.3977846Z Downloading binary https://github.com/golangci/golangci-lint/releases/download/v2.10.1/golangci-lint-2.10.1-linux-amd64.tar.gz ...
checks	Run golangci-lint	2026-03-05T02:40:42.9162634Z [command]/usr/bin/tar xz --overwrite --warning=no-unknown-keyword --overwrite -C /home/runner -f /home/runner/work/_temp/d839b6af-db27-4290-bf77-de8cd42f9a6a
checks	Run golangci-lint	2026-03-05T02:40:43.1885742Z Installed golangci-lint into /home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint in 791ms
checks	Run golangci-lint	2026-03-05T02:40:43.1890096Z ##[endgroup]
checks	Run golangci-lint	2026-03-05T02:40:43.1893990Z ##[group]run golangci-lint
checks	Run golangci-lint	2026-03-05T02:40:43.1898089Z Running [/home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint config path] in [/home/runner/work/tgo/tgo] ...
checks	Run golangci-lint	2026-03-05T02:40:43.2678381Z Running [/home/runner/golangci-lint-2.10.1-linux-amd64/golangci-lint run  ./...] in [/home/runner/work/tgo/tgo] ...
checks	Run golangci-lint	2026-03-05T02:40:54.2347736Z ##[error]cmd/tgo/view.go:34:2: ineffectual assignment to line (ineffassign)
checks	Run golangci-lint	2026-03-05T02:40:54.2356091Z 	line = a.drawSection(screen, line, width, height, "Others", a.others, a.cursorOther, a.section == 1)
checks	Run golangci-lint	2026-03-05T02:40:54.2356564Z 	^
checks	Run golangci-lint	2026-03-05T02:40:54.2357255Z ##[error]cmd/tgo/tmux.go:153:6: func runesToString is unused (unused)
checks	Run golangci-lint	2026-03-05T02:40:54.2358182Z func runesToString(m map[string]rune, ordered []session) string {
checks	Run golangci-lint	2026-03-05T02:40:54.2358605Z      ^
checks	Run golangci-lint	2026-03-05T02:40:54.2358786Z 2 issues:
checks	Run golangci-lint	2026-03-05T02:40:54.2358982Z * ineffassign: 1
checks	Run golangci-lint	2026-03-05T02:40:54.2359183Z * unused: 1
checks	Run golangci-lint	2026-03-05T02:40:54.2359290Z 
checks	Run golangci-lint	2026-03-05T02:40:54.2368562Z ##[error]issues found
checks	Run golangci-lint	2026-03-05T02:40:54.2369548Z Ran golangci-lint in 10964ms
checks	Run golangci-lint	2026-03-05T02:40:54.2370094Z ##[endgroup]

Assistant (Build · gpt-5.3-codex · 9.8s) #

Thinking:

Removing unused code and assignments

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/cmd/tgo/view.go\n@@\n \tline = a.drawSection(screen, line, width, height, \"Favorites\", a.favorites, a.cursorFav, a.section == 0)\n-\tline = a.drawSection(screen, line, width, height, \"Others\", a.others, a.cursorOther, a.section == 1)\n+\ta.drawSection(screen, line, width, height, \"Others\", a.others, a.cursorOther, a.section == 1)\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/cmd/tgo/view.go

Tool: apply_patch

Input:

{
  "patchText": "*** Begin Patch\n*** Update File: /home/waylon/git/tgo/cmd/tgo/tmux.go\n@@\n-import (\n-\t\"bytes\"\n-\t\"fmt\"\n+import (\n+\t\"fmt\"\n \t\"os/exec\"\n \t\"sort\"\n \t\"strings\"\n )\n@@\n-func runesToString(m map[string]rune, ordered []session) string {\n-\tbuf := bytes.Buffer{}\n-\tfor _, s := range ordered {\n-\t\tr, ok := m[s.Name]\n-\t\tif !ok {\n-\t\t\tcontinue\n-\t\t}\n-\t\tbuf.WriteRune(r)\n-\t}\n-\treturn buf.String()\n-}\n*** End Patch"
}

Output:

Success. Updated the following files:
M home/waylon/git/tgo/cmd/tgo/tmux.go

Assistant (Build · gpt-5.3-codex · 6.1s) #

Thinking:

Planning Go test and vet runs

Tool: bash

Input:

{
  "command": "go test ./... && go vet ./...",
  "workdir": "/home/waylon/git/tgo",
  "description": "Runs tests and vet after lint fixes"
}

Output:

ok  	tgo/cmd/tgo	0.003s

Assistant (Build · gpt-5.3-codex · 14.0s) #

Thinking:

Pushing fixes to repo

Tool: bash

Input:

{
  "command": "git add cmd/tgo/view.go cmd/tgo/tmux.go && git commit -m \"fix: resolve lint errors in TUI code\" && git push origin main",
  "workdir": "/home/waylon/git/tgo",
  "description": "Commits lint fixes and pushes to main"
}

Output:

[main 2af8f82] fix: resolve lint errors in TUI code
 2 files changed, 1 insertion(+), 14 deletions(-)
To https://github.com/WaylonWalker/tgo.git
   29f8b3f..2af8f82  main -> main

Assistant (Build · gpt-5.3-codex · 4.8s) #

Thinking:

Moving tag and recreating release

Tool: bash

Input:

{
  "command": "git tag -f v0.1.0 2af8f82 && git push --force origin v0.1.0",
  "workdir": "/home/waylon/git/tgo",
  "description": "Moves v0.1.0 tag to latest lint-fix commit"
}

Output:

Updated tag 'v0.1.0' (was 29f8b3f)
To https://github.com/WaylonWalker/tgo.git
 + 29f8b3f...2af8f82 v0.1.0 -> v0.1.0 (forced update)

Assistant (Build · gpt-5.3-codex · 5.5s) #

Thinking:

Planning release replacement strategy

Tool: bash

Input:

{
  "command": "gh release delete v0.1.0 --yes && gh release create v0.1.0 --title \"v0.1.0\" --notes '## Highlights\n- Initial release of tgo: fast tmux session switcher optimized for popup use.\n- Interactive TUI with direct letter switching (`asdfqwertzxcvb`), favorites pinning, and reorder mode.\n- Session management actions from UI: create, kill, refresh, and persistent ordering state.\n- Added installation docs for mise, jpillora installer, go install, and GitHub release assets.\n- Updated and fixed GitHub Actions CI/release workflow definitions.'",
  "workdir": "/home/waylon/git/tgo",
  "description": "Recreates release after moving tag to latest commit"
}

Output:

https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0

Assistant (Build · gpt-5.3-codex · 3.2s) #

Thinking:

Monitoring latest CI runs

Tool: bash

Input:

{
  "command": "gh run list --limit 10 --json databaseId,workflowName,displayTitle,status,conclusion,event,headBranch,url",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks latest CI and release run statuses"
}

Output:

[{"conclusion":"","databaseId":22699744966,"displayTitle":"v0.1.0","event":"release","headBranch":"v0.1.0","status":"queued","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699744966","workflowName":"Release"},{"conclusion":"","databaseId":22699741216,"displayTitle":"fix: resolve lint errors in TUI code","event":"push","headBranch":"main","status":"in_progress","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699741216","workflowName":"CI"},{"conclusion":"success","databaseId":22699716792,"displayTitle":"Release","event":"release","headBranch":"v0.1.0","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699716792","workflowName":"Release"},{"conclusion":"failure","databaseId":22699711833,"displayTitle":"fix: correct golangci-lint action args","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699711833","workflowName":"CI"},{"conclusion":"success","databaseId":22699699908,"displayTitle":"github_actions in / for actions/checkout - Update #1268818413","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699908","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699789,"displayTitle":"github_actions in / for golangci/golangci-lint-action - Update #1268818411","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699789","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699295,"displayTitle":"github_actions in / for softprops/action-gh-release - Update #1268818408","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699295","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699699236,"displayTitle":"github_actions in / for actions/cache - Update #1268818405","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699699236","workflowName":"Dependabot Updates"},{"conclusion":"success","databaseId":22699698905,"displayTitle":"github_actions in / for actions/setup-go - Update #1268818404","event":"dynamic","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699698905","workflowName":"Dependabot Updates"},{"conclusion":"failure","databaseId":22699690701,"displayTitle":"chore: update install docs and stabilize actions","event":"push","headBranch":"main","status":"completed","url":"https://github.com/WaylonWalker/tgo/actions/runs/22699690701","workflowName":"CI"}]

Assistant (Build · gpt-5.3-codex · 23.3s) #

Thinking:

Planning sequential CI monitoring

Tool: bash

Input:

{
  "command": "gh run watch 22699741216 --exit-status",
  "workdir": "/home/waylon/git/tgo",
  "description": "Watches latest CI run for successful completion"
}

Output:

Refreshing run status every 3 seconds. Press Ctrl+C to quit.

* main CI · 22699741216
Triggered via push less than a minute ago

JOBS
* checks (ID 65813933132)
  ✓ Set up job
  ✓ Run actions/checkout@v6
  ✓ Set up Go
  ✓ Cache Go modules
  ✓ Format code
  * Run golangci-lint
  * Vet packages
  * Run tests
  * Post Run golangci-lint
  * Post Cache Go modules
  * Post Set up Go
  * Post Run actions/checkout@v6
Refreshing run status every 3 seconds. Press Ctrl+C to quit.

* main CI · 22699741216
Triggered via push less than a minute ago

JOBS
* checks (ID 65813933132)
  ✓ Set up job
  ✓ Run actions/checkout@v6
  ✓ Set up Go
  ✓ Cache Go modules
  ✓ Format code
  ✓ Run golangci-lint
  * Vet packages
  * Run tests
  * Post Run golangci-lint
  * Post Cache Go modules
  * Post Set up Go
  * Post Run actions/checkout@v6
Refreshing run status every 3 seconds. Press Ctrl+C to quit.

* main CI · 22699741216
Triggered via push less than a minute ago

JOBS
* checks (ID 65813933132)
  ✓ Set up job
  ✓ Run actions/checkout@v6
  ✓ Set up Go
  ✓ Cache Go modules
  ✓ Format code
  ✓ Run golangci-lint
  ✓ Vet packages
  ✓ Run tests
  ✓ Post Run golangci-lint
  * Post Cache Go modules
  * Post Set up Go
  * Post Run actions/checkout@v6
Refreshing run status every 3 seconds. Press Ctrl+C to quit.

* main CI · 22699741216
Triggered via push less than a minute ago

JOBS
* checks (ID 65813933132)
  ✓ Set up job
  ✓ Run actions/checkout@v6
  ✓ Set up Go
  ✓ Cache Go modules
  ✓ Format code
  ✓ Run golangci-lint
  ✓ Vet packages
  ✓ Run tests
  ✓ Post Run golangci-lint
  ✓ Post Cache Go modules
  * Post Set up Go
  * Post Run actions/checkout@v6
✓ main CI · 22699741216
Triggered via push less than a minute ago

JOBS
✓ checks in 30s (ID 65813933132)
  ✓ Set up job
  ✓ Run actions/checkout@v6
  ✓ Set up Go
  ✓ Cache Go modules
  ✓ Format code
  ✓ Run golangci-lint
  ✓ Vet packages
  ✓ Run tests
  ✓ Post Run golangci-lint
  ✓ Post Cache Go modules
  ✓ Post Set up Go
  ✓ Post Run actions/checkout@v6
  ✓ Complete job

Assistant (Build · gpt-5.3-codex · 2.8s) #

Thinking:

Observing release run progress

Tool: bash

Input:

{
  "command": "gh run watch 22699744966 --exit-status",
  "workdir": "/home/waylon/git/tgo",
  "description": "Watches release workflow run until completion"
}

Output:

Run Release (22699744966) has already completed with 'success'

Assistant (Build · gpt-5.3-codex · 7.7s) #

Thinking:

Verifying release assets presence

Tool: bash

Input:

{
  "command": "gh release view v0.1.0 --json url,tagName,targetCommitish,isDraft,isPrerelease,assets",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks release metadata and uploaded assets"
}

Output:

{"assets":[{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202449","contentType":"text/plain","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:9411ecce656bab45708ca38d2fa2f0fd6bcdbba791e3e38bc6f004bc0eabcecc","downloadCount":0,"id":"RA_kwDORewosc4V4xCR","label":"","name":"checksums.txt","size":582,"state":"uploaded","updatedAt":"2026-03-05T02:42:22Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/checksums.txt"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202453","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:f31d266ef4ce5aba00b678d900287982bf23fb735677941d31a2b37ff70dcd10","downloadCount":0,"id":"RA_kwDORewosc4V4xCV","label":"","name":"tgo-darwin-amd64.zip","size":1212769,"state":"uploaded","updatedAt":"2026-03-05T02:42:23Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-darwin-amd64.zip"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202451","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:9d3fb0a2d70dc8bcb97d4d91179f49e1f0e298d889131a4404c84ad4731f1821","downloadCount":0,"id":"RA_kwDORewosc4V4xCT","label":"","name":"tgo-darwin-arm64.zip","size":1149837,"state":"uploaded","updatedAt":"2026-03-05T02:42:22Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-darwin-arm64.zip"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202450","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:6497bbf5e358d3edaccbc69c114a8df4768b4ca9058fbb2b77ef1ca1d3db4a16","downloadCount":0,"id":"RA_kwDORewosc4V4xCS","label":"","name":"tgo-linux-amd64.zip","size":1211862,"state":"uploaded","updatedAt":"2026-03-05T02:42:22Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-linux-amd64.zip"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202456","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:f52b3155710ee7c86ae572d5e5616553a9512dcea0a225b67c484c2e686b24a1","downloadCount":0,"id":"RA_kwDORewosc4V4xCY","label":"","name":"tgo-linux-arm64.zip","size":1122154,"state":"uploaded","updatedAt":"2026-03-05T02:42:23Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-linux-arm64.zip"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202448","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:797793924141e6b7083142d7351bcbda99eae1ce52a4acd6140f2434d00b2bb9","downloadCount":0,"id":"RA_kwDORewosc4V4xCQ","label":"","name":"tgo-windows-amd64.zip","size":1198632,"state":"uploaded","updatedAt":"2026-03-05T02:42:22Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-windows-amd64.zip"},{"apiUrl":"https://api.github.com/repos/WaylonWalker/tgo/releases/assets/367202447","contentType":"application/zip","createdAt":"2026-03-05T02:42:22Z","digest":"sha256:a596200fa2f39a0667a7211527d52cfff04ceb378f37fc45dda87452e152beb9","downloadCount":0,"id":"RA_kwDORewosc4V4xCP","label":"","name":"tgo-windows-arm64.zip","size":1095347,"state":"uploaded","updatedAt":"2026-03-05T02:42:22Z","url":"https://github.com/WaylonWalker/tgo/releases/download/v0.1.0/tgo-windows-arm64.zip"}],"isDraft":false,"isPrerelease":false,"tagName":"v0.1.0","targetCommitish":"main","url":"https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0"}

Assistant (Build · gpt-5.3-codex · 2.0s) #

Thinking:

Checking git status cleanliness

Tool: bash

Input:

{
  "command": "git status --short --branch",
  "workdir": "/home/waylon/git/tgo",
  "description": "Checks final git status and branch sync"
}

Output:

## main...origin/main

Assistant (Build · gpt-5.3-codex · 2.8s) #

Thinking:

Updating todo statuses

Tool: todowrite

Input:

{
  "todos": [
    {
      "content": "Draft builder delegation prompt for push, retag/release move, CI fixes, and PR handling",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Run builder subagent to execute requested git/GitHub operations end-to-end",
      "status": "completed",
      "priority": "high"
    },
    {
      "content": "Review builder output and report final repository/release/CI/PR status",
      "status": "completed",
      "priority": "high"
    }
  ]
}

Output:

[
  {
    "content": "Draft builder delegation prompt for push, retag/release move, CI fixes, and PR handling",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Run builder subagent to execute requested git/GitHub operations end-to-end",
    "status": "completed",
    "priority": "high"
  },
  {
    "content": "Review builder output and report final repository/release/CI/PR status",
    "status": "completed",
    "priority": "high"
  }
]

Assistant (Build · gpt-5.3-codex · 9.1s) #

Thinking:

Summarizing release completion details

Done. I delegated to @builder first, then completed the full set of actions directly since the subagent couldn’t execute git/gh operations.

Pushed your pending README install updates and CI/release fixes to main in:
- db51a9e chore: update install docs and stabilize actions
- 29f8b3f fix: correct golangci-lint action args
- 2af8f82 fix: resolve lint errors in TUI code
Updated workflows to fix failures:
- .github/workflows/ci.yml: upgraded actions (checkout@v6, setup-go@v6, cache@v5, golangci-lint-action@v9) and fixed lint args to ./...
- .github/workflows/release.yml: upgraded actions, added permissions: contents: write, moved to softprops/action-gh-release@v2
Moved tag and release:
- Force-moved v0.1.0 to commit 2af8f82
- Recreated release v0.1.0 at https://github.com/WaylonWalker/tgo/releases/tag/v0.1.0
Verified workflows:
- CI success: https://github.com/WaylonWalker/tgo/actions/runs/22699741216
- Release success: https://github.com/WaylonWalker/tgo/actions/runs/22699744966
- Release assets and checksums are published (linux/darwin/windows amd64+arm64 + checksums.txt)
Addressed PRs:
- Open PRs now: none (gh pr list returns [])
- PRs #1-#5 were already closed; I left comments noting they were superseded by direct workflow updates on main
Repo is clean and synced: main...origin/main

If you want, I can cut v0.1.1 next so the history reflects these post-release fixes without moving v0.1.0 again.

I Built A Tmux Session Switcher

2026-03-04T00:00:00Z

I’ve been thinking about this for awhile now. For years now, fuzzy pickers and last session have been my go to. They have served me well. I can typically only keep so much in my head anyways. I’m often doing a hub and spoke pattern between main project, notes, and infra repo, maybe two projects. Don’t get me wrong, I regularly run with a dozen or more sessions running at a time, but only two to three are in my immediate context at any point anyways.

The Design #

harpoon for tmux

press a hotkey followed by one more keystroke, currently any left hand letter SIMPLE, FAST, thats of utmost importance, what I want are sessions that I can can be assigned in order of importance from middle row, top row, bottom row.

I added this binding to my tmux config. Now I can press c-a a to go to the first session, c-a s to go to the second session. c-a and pause to think j/k to navigate, space to pick up a session and move it, x to kill it.

bind-key -n c-a popup -E '~/go/bin/tgo'

Enter the agents #

Now with agents doing more and more work, and cooking for longer periods this is not cutting it, I’m often swapping through a lot more sessions, I’ve got more projects sitting in more phases between research, implementation, fully orchestrated agents, and sessions that need their hand held to get things right.

Image of the tgo tool in action, I’d show you a video, but its not really that interesting, it just flashes up and goes to the next session as fast as you can press the key.

Made with gpt-5.3-codex and gpt-5.1-codex-mini #

Idk how much it cost, it barely touched my $20/month weekly token allowance. I’ve been thinking about it for awhile and decided today was the day to pull the trigger on something and get it started, worst case I throw it away. It took the agents about 7 minutes to implement a working version with broken ci that it later fixed.

I’ve typed far more characters and put more thought into this post than the tool itself, that where we are these days I guess.

See the session that made tgo Ses_3444b09b1ffexter3elfg5qqtg

Should you use it? #

You can its there for anyone to use, go for it, there’s an easy to download binary.

It’s all vibe coded slop that you could probably do a better job doing in a cave with scraps anyways. Take inspiration and make one that works for you.

gh do I have a pr

2026-03-02T08:47:44Z

In the age of agents sometimes work gets done on so many different worktrees and branches its hard to tell if there is already a PR or any of them or not, the great gh cli has us covered.

gh pr list --head fix/markata-go-connections-graph

Vaulted Secrets Without Git Churn

2026-02-26T09:59:57Z

Ansible Vault keeps secrets out of sight, but the ciphertext changes on every encrypt. That turns Git diffs into noise and makes it hard to tell if anything actually changed. Decrypting, editing, and re-encrypting often leaves uncertainty about whether any plaintext changed. This is amplified when secret repos are tightly coupled to dependent repositories. A typical cycle includes decrypting, adding a key, updating a value, applying changes, and returning later with little clarity about what changed while secrets were in plaintext.

Today a new workflow was created with @gpt-5.2-codex to keep diffs clean and avoid re-encrypting when the plaintext is identical.

Waylon Walker

This repo has ansible vaulted secrets and an encrypt/decrypt process, but no way to compare. Please research compare options. The goal is to avoid changing files on encrypt/decrypt when plaintext is unchanged, ideally by comparing decrypted content and reusing the remote encrypted file.

@gpt-5.2-codex

The repo workflow will be reviewed, compare options identified, and a low-churn GitOps approach proposed to avoid re-encrypt noise.

The problem #

Re-encrypting a file with the same content produces different ciphertext. A simple decrypt/encrypt cycle can look like a full file change, even when the plaintext is identical. That creates uncertainty and makes GitOps workflows feel brittle.

Waylon Walker

Minimal changes needed to keep GitOps clear?

@gpt-5.2-codex

Add compare-before-encrypt, decrypted diffs, and ignore cache artifacts.

The solution at a glance #

Three pieces make it work:

Compare-before-encrypt
- just decrypt stores a plaintext hash and caches the current encrypted file.
- just encrypt compares the plaintext hash and, if unchanged, restores the cached ciphertext instead of re-encrypting.
Readable diffs for vaulted files
- .gitattributes sets private/* diff=ansible-vault.
- A small textconv script decrypts for git diff.
Ignored cache artifacts
- .vault-hashes/ and .vault-cache/ are ignored so they never hit the repo.

How it works #

Waylon Walker

How does compare-before-encrypt operate?

@gpt-5.2-codex

Hash plaintext on decrypt, reuse cached ciphertext on encrypt if the hash matches.

Compare-before-encrypt #

When a file is decrypted, a SHA-256 hash of the plaintext is created and stored in .vault-hashes/. A copy of the encrypted file is stored in .vault-cache/.

When encrypting, the current plaintext file is hashed. If the hash matches the cached hash, the cached encrypted file is restored instead of generating new ciphertext. Result: no churn when nothing actually changed.

Decrypted diffs #

Git is configured to use ansible-vault view as a text conversion step for files under private/. As a result, git diff shows decrypted content instead of ciphertext.

Enable the diff driver locally:

git config diff.ansible-vault.textconv "scripts/ansible-vault-diff"

What changes will be seen #

If a secret changes: the diff shows the plaintext change.
If decrypt and re-encrypt occurs without changes: the diff stays clean.
Large base64 blobs may still look like full-line diffs because they are single-line values.

Waylon Walker

What is the day-to-day workflow?

@gpt-5.2-codex

`just decrypt`, edit, then `just encrypt`. Clean diffs, no churn.

Recommended usage #

just decrypt
# apply edits
just encrypt

That is sufficient to keep Git history clean and reduce uncertainty about whether a secret actually changed.

Using stderr/stdout correctly - YouTube

2025-12-22T21:35:30Z

Yeah there’s some basics, you know things you might expect like using standard error and standard out correctly. One thing I’ll say on that because I think this is commonly misunderstood, standard error is not for errors, it’s for any information that isn’t part of the normal output. So you know often times that’s warnings and errors, but it might just be progress information. You know anytime that you just need to have something go to the user that’s what it’s there for." (6:15 - 6:42)

I’ve definitely done this sin in my own tooling before, and it does make things harder to use. I think I still take err/out at face value. I really like the translation Jeff gave here, one is for normal output, i.e. what the user asked for and the other is extra information. So if I wanted to list something and pipe it into something else, stdout only captures the list, thats it. if you have a bunch of information about config warnings, showing environment, are you sure questions, none of that is captured.

gh auth switch

2025-12-07T10:55:55Z

When using two GitHub accounts the gh cli gives very easy gh auth switch workflow from the cli.

from the docs

gh auth switch –help Switch the active account for a GitHub host.

This command changes the authentication configuration that will be used when running commands targeting the specified GitHub host.

If the specified host has two accounts, the active account will be switched automatically. If there are more than two accounts, disambiguation will be required either through the --user flag or an interactive prompt.

# list accounts
gh auth status
# switch accounds (interactive if more than 2, i've never seen this personally)
gh auth switch

COLUMNS env var

2025-11-26T13:24:38Z

setting COLUMNS env var to a number greater than 0 will make the terminal resize to that number of columns.

COLUMNS=80 uvx --from rich-cli rich myscript.py

Note

Not all programs respct the COLUMNS env var, but rich does, and a lot of stuff I’m building uses rich.

I discovered this when I was trying to make a low effort readme generated from the code, but did not depend on the size of terminal it was ran on.

# justfile
readme:
    echo "# Workspaces" > README.md
    echo "" >> README.md
    echo '``` bash' >> README.md
    COLUMNS=80 ./workspaces.py --help >> README.md
    echo '```' >> README.md

tea login flag

2025-11-23T21:09:36Z

The tea command for gitea (used by forgejo) has a flag for login. With gitea you can have multiple accounts logged in. When you try to run a command such as repo create it will prompt you which login to use, but I learned that you can bake it in to all of them with --login <login-name>

❯ tea repo create --name deleteme --description 'for example'
┃ NOTE: no gitea login detected, whether falling back to login 'git.waylonwalker.com'?

tea repo create --name deleteme --description 'for example' --login git.wayl.one

Ellie Huxtable on evolving Atuin (her shell history tool) for ...

2025-10-24T05:53:16Z

Atuin desktop sounds dope AF, tried to install it off the AUR and it was broken for me. Seems early and the dev team is all in on mac. They have an official .deb and .rpm. I’ll have to try again later, maybe the binary will work.

The idea of building out runbooks from my Atuin data sounds dope AF. It sounds like a mix of markdown and executable cells like a jupyter notebook, but not. Really pitching hard to those of us in the system administration, dev ops, SRE space. Having something that you walk through when a system goes down and you are feeling panicked in DR mode sounds relieving.

tar over ssh

2025-09-13T10:50:42Z

Today I learned how to use tar over ssh to save hours in file transfers. I keep all of my projects in ~/git (very creative I know, I’ve done it for years and haven’t changed). I just swapped out my main desktop from bazzite to hyprland, and wanted to get all of my projects back. Before killing my bazzite install I moved everything over (16GB of many small files), it took over 14 hours, maybe longer. I had started in the morning and just let it churn.

This was not going to happen for re-seeding all of my projects on my new system, I knew there had to be a better way, I looked at rsync, but for seeding I ran into this tar over ssh technique and it only took me 6m51s to pull all of my projects off of my remote server.

ssh user@192.168.1.100 'tar -C /tank/git -cpf - .' \
  | tar -C "$HOME/git" -xpf -

2025-07-10 Notes

2025-07-18T20:26:28Z

2025-07-09 Notes from yesterday I have temporal stuff kind of going with postiz in a windsurf session working on [[thoughts-to-nostr]] Been cleaning up my z" loading="lazy">

2025-07-10 Notes | Nic Payne

2025-07-09 Notes from yesterday I have temporal stuff kind of going with postiz in a windsurf session working on [[thoughts-to-nostr]] Been cleaning up my z

pype.dev

big fan of eza and dust, I like these aliases to have some common commands at my fingertips. I often use the tree command and yes it sometimes goes too deep to actually be useful.

    alias lt='eza -T --level=2'             # Tree view, 2 levels deep
    alias ltt='eza -T --level=3'            # Tree view, 3 levels deep

    alias du1='dust -d 1'                   # Show only 1 level deep
    alias du2='dust -d 2'                   # Show 2 levels deep

fc

2025-07-18T07:52:53Z

I am a linux user through and through. Desktop, server, vms, containers, everything except my phone is linux. With this I spend a lot of time in the terminal, and have been a long time user of !! to rerun the last command, but with the ability to tack something on at the beginning or end.

TIL about fc, which opens the last command in your shell history in your $EDITOR or pass in your editor -e nvim.

man fc

Rcap of how !! works #

!! pronounces bang bang and will run the last command in your history.

ls -l

!! | wc -l
# ls -l | wc -l

sudo !!
# sudo ls -l | wc -l

!!:s/-l/-l \/tmp
# sudo ls -l /tmp | wc -l

`fc` enters the chat #

Now making complex edits in your shell can be a bit of a chore, so fc moves this work to your $EDITOR.

fc

This pops open your $EDITOR with the last command in your history.

sudo ls -l | wc -l

Shell History #

fc shows up in shell history, but !! does not, !! gets replaced by the command that it becomes.

Up Arrow #

yaya yaya, I know you can also up-arrow c-e, but what fun is that, it’s barely a flex. fc just looks big brained and like you really know what you are doing.

unset multiple environment variables

2025-06-03T11:21:11Z

You can unset multiple environment variables at once. I did not know this was a thing, its something that ended up happening organically on a call and asking someone to run unset. They had never done it before and did not know how it works, but did exactly as I said instead of what I meant. I like this handy shortcut doing it in one line rather than each one individually, I will be using this in the future. You might need this for something like running aws cli commands with localstack.

unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_DEFAULT_REGION

m9a devlog 1

2025-05-11T09:33:44Z

It’s sad to see textualize.io close the doors, but textual is still alive and maintained as a n open source project. I tried to use it very early, and struggled, this was before docs and tutorials really existed, before a lot of the widgets and components existed. Then as we all do I got busy and moved on to other things in life and did not have the capacity to build TUIs.

I like tuis #

I like tuis, I like staying in the terminal. I use lf daily to move files around when I want something more than mv and cp. I use k9s hourly to monitor and manage my kubernetes cluster.

Are they worth the effort?? #

As awesome as tui’s are, they are more effort to build, and less automatable. I feel like the first stage into automation of a project really needs to be a good cli, and this is often good enough for the project and I move on.

m9a (em - nine - ah) #

inspired by k9s

Like I said I really like k9s and use it all the time, It really makes running kubectl commands a breeze and much less verbose. I don’t know how useful this will be, but as a learning exercise I am working on a k9s experience for my blog generator markata.

m9a-1-trimmed.webm

Learning #

So far this is just for learning and not quite the most useful thing, I am not sure if there is a way to do it, but I am interested in the idea of some sort of framework (maybe just widgets) that can more easily turn pydantic objects into this kind of tui. I don’t quite know how it would work, or if it could work, for now just exploring the idea, and I think I hit a fairly crude clone of k9s so far.

adrianlopezroche/fdupes: FDUPES is a program for identifying o...

2025-04-09T17:56:53Z

GitHub - adrianlopezroche/fdupes: FDUPES is a program for identifying or deleting duplicate files residing within specified directories.

FDUPES is a program for identifying or deleting duplicate files residing within specified directories. - adrianlopezroche/fdupes

GitHub · github.com

keeping this in my back pocket for now. I just moved a few TB’s of data in the homelab and I am expecting a lot of duplication to show up.

backup distrobox image

2025-04-09T17:35:50Z

Today I’m upgrading my distrobox, but don’t want to end up in a situation where I can’t get anything done becauase I work out of my distrobox.

distrobox ls
distrobox stop devtainer
distrobox create --clone devtainer --name devtainer-20250409
distrobox enter devtainer

Use pbpaste for clean shell history

2025-03-17T12:00:00Z

Using pbpaste for command substitution keeps sensitive or long URLs out of your shell history. Instead of typing git clone https://github.com/user/repo-with-long-name.git, copy the URL to clipboard and run git clone "$(pbpaste)". This prevents the URL from appearing in ~/.bash_history or ~/.zsh_history.

To get pbpaste working on both Xorg and Wayland, add this to your shell config:

if [[ $(command -v wl-copy) ]]; then
    alias pbcopy='wl-copy'
    pbpaste() { wl-paste; }
elif [[ $(command -v xclip) ]]; then
    alias pbcopy='xclip -selection clipboard'
    pbpaste() { xclip -selection clipboard -o; }
fi

The function approach (instead of alias) enables command substitution, while the quotes around $(pbpaste) handle spaces and special characters safely.

Now you can use it.

git clone "$(pbpaste)"

More importantly secrets can stay out of your history.

export GITHUB_TOKEN="$(pbpaste)"
export AWS_ACCESS_KEY_ID="$(pbpaste)"
export AWS_SECRET_ACCESS_KEY="$(pbpaste)"
export DATABASE_URL="$(pbpaste)"

Releases · bootandy/dust

2025-01-20T00:58:42Z

GitHub - bootandy/dust: A more intuitive version of du in rust

A more intuitive version of du in rust. Contribute to bootandy/dust development by creating an account on GitHub.

GitHub · github.com

dust is one of my favorite rust rewrite tools. Its so useful for narrowing down file system bloat and cleaning up some disk space on your nearly full disks. It runs right in your terminal and gives you a nice bar graph on the top directories in use.

bic | Static blog generator, in bash

2025-01-09T20:22:47Z

bic

Static blog generator, in bash

bic · bic.sh

Intereresting someone built a blog generator in bash. it comes with normal markdown to html, static content, robots.txt, sitemap, rss, and tags. It uses pandoc to take markdown to html and mustache for page templates.

Ellie Huxtable: "Atuin v18.4 is out now! Including `atuin wrap...

2024-12-28T12:29:12Z

Ellie Huxtable (@ellie.wtf)

Atuin v18.4 is out now!

Including atuin wrapped, your year in shell history 🐢

thanks @daveeddy.com for the suggestion!

Bluesky Social · bsky.app

Atuin v18.4 is out with an atuin wrapped command.

Here’s Ellie’s Wrapped.

This is a pretty sick command, I’ve only been using Atuin about as long as I’ve been on bazzite, so maybe 4 months, but here is my wrapped.

Comparing to Ellie, I’m surprised that I even have 126 package related commands, being on an immutable distro most of my packages come from the container, I don’t need to run packaging commands. My cd is also super low, I use tmux sessions to take me where I need to be most of the time, which is a project’s root directory, It’s pretty rare to see me outside of a project root directory.

I’d venture to guess that nvim would be higher if it didn’t auto start on every tmux session as well.

casey/just: 🤖 Just a command runner

2024-12-14T23:04:06Z

GitHub - casey/just: 🤖 Just a command runner

🤖 Just a command runner. Contribute to casey/just development by creating an account on GitHub.

GitHub · github.com

new versions of just now come with color variables already set.

[group('manage')]
version:
    #!/usr/bin/env bash
    version=$(cat version)
    echo current version {{BOLD}}{{GREEN}}$version{{NORMAL}}

pipedream/justfile at main · thechangelog/pipedream

2024-12-14T22:54:34Z

pipely/justfile at main · thechangelog/pipely

I like the idea of having like this 20-line Varnish config that we deploy around the world, and it’s like: Look at our CDN! - thechangelog/pipely

GitHub · github.com

I found this nugget in thechangelogs justfile, it lets you add color to your justfile with variables quite easily.

# https://linux.101hacks.com/ps1-examples/prompt-color-using-tput/

_BOLD := "$(tput bold)"
_RESET := "$(tput sgr0)"
_BLACK := "$(tput bold)$(tput setaf 0)"
_RED := "$(tput bold)$(tput setaf 1)"
_GREEN := "$(tput bold)$(tput setaf 2)"
_YELLOW := "$(tput bold)$(tput setaf 3)"
_BLUE := "$(tput bold)$(tput setaf 4)"
_MAGENTA := "$(tput bold)$(tput setaf 5)"
_CYAN := "$(tput bold)$(tput setaf 6)"
_WHITE := "$(tput bold)$(tput setaf 7)"
_BLACKB := "$(tput bold)$(tput setab 0)"
_REDB := "$(tput setab 1)$(tput setaf 0)"
_GREENB := "$(tput setab 2)$(tput setaf 0)"
_YELLOWB := "$(tput setab 3)$(tput setaf 0)"
_BLUEB := "$(tput setab 4)$(tput setaf 0)"
_MAGENTAB := "$(tput setab 5)$(tput setaf 0)"
_CYANB := "$(tput setab 6)$(tput setaf 0)"
_WHITEB := "$(tput setab 7)$(tput setaf 0)"

Usage

echo:
    echo {{_BOLD}}{{_GREEN}}hello there{{_RESET}}

urllink

2024-12-14T11:11:52Z

Today I discovered the Urllink function in bash from the ujust tool from ublue.it. Seems like a cool trick, but might not work everywhere.

########
### Special text formating
########
## Function to generate a clickable link, you can call this using
# url=$(Urllink "https://ublue.it" "Visit the ublue website")
# echo "${url}"
function Urllink (){
    URL=$1
    TEXT=$2

    # Generate a clickable hyperlink
    printf "\e]8;;%s\e\\%s\e]8;;\e\\" "$URL" "$TEXT${n}"
}
```j

hostnamectl to easily change hostname | Pype.dev

2024-12-06T20:30:41Z

hostnamectl to easily change hostname | Nic Payne

hostnamectl is apparently a linux utility for easily changing your hostname in a variety of ways I learned there's transient and static hostnames, so that&

pype.dev

For some reason the ublue ecosystem does not prompt you to set your hostname on install and you get a hostname like bazzite showing up. Looks like this is the fix.

hostnamectl –static hostname babyblue-aurora

Document how to provide a negative number as an argument · fas...

2024-10-30T06:28:56Z

Document how to provide a negative number as an argument · fastapi typer · Discussion #798

First Check I added a very descriptive title here. I used the GitHub search to find a similar question and didn't find it. I searched the Typer documentation, with the integrated search. I already ...

GitHub · github.com

Today I learned that you cannot pass negative integers as values to typer. in this case context_settings={"ignore_unknown_options": True} is required so that the - does not look like a flag.

# script name: main.py

import typer

app = typer.Typer()


@app.command()
def failing(value: float):
    print(f"{value=}")
    

@app.command(
    context_settings={"ignore_unknown_options": True}
)
def working_good(value: float):
    print(f"{value=}")
    
    
if __name__ == "__main__":
    app()

Will McGugan on X: "New Version of #Textual released! 😎🤓🦾 The ...

2024-10-27T07:51:07Z

@willmcgugan) on X — New Version of #Textual released! 😎🤓🦾

The demo has been updated. It's not quite finished, expect an update next release, but it is a lot of fun.

Press C at any point to see the code powering that page (makes a great learning tool).

Video 👇

https://t.co/p2ScsuL7GZ" loading=“lazy”>

Will McGugan (@willmcgugan) on X

New Version of #Textual released! 😎🤓🦾

The demo has been updated. It's not quite finished, expect an update next release, but it is a lot of fun.

Press C at any point to see the code pow…

X (formerly Twitter) · x.com

This new demo of textual is wildly awesome, so many widgets and features being added into the main library. The themes and animations are on point and far surpass my expectations of a tui.

distrobox/docs/usage/distrobox-assemble.md at main · 89luca89/...

2024-09-30T20:49:25Z

This page is gold. It lays out all of the distrobox assemble api with some good examples of how to get access to things like podman and kind from inside of containers.

Especially this example.

[tumbleweed_distrobox]
image=registry.opensuse.org/opensuse/distrobox
pull=true
additional_packages="acpi bash-completion findutils iproute iputils sensors inotify-tools unzip"
additional_packages="net-tools nmap openssl procps psmisc rsync man tig tmux tree vim htop xclip yt-dlp"
additional_packages="git git-credential-libsecret"
additional_packages="patterns-devel-base-devel_basis"
additional_packages="ShellCheck ansible-lint clang clang-tools codespell ctags desktop-file-utils gcc golang jq python3"
additional_packages="python3-bashate python3-flake8 python3-mypy python3-pipx python3-pycodestyle python3-pyflakes python3-pylint python3-python-lsp-server python3-rstcheck python3-yapf python3-yamllint rustup shfmt"
additional_packages="kubernetes-client helm"
init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest;
init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install github.com/onsi/ginkgo/v2/ginkgo@latest;
init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install golang.org/x/tools/cmd/goimports@latest;
init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install golang.org/x/tools/gopls@latest;
init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install sigs.k8s.io/kind@latest;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/conmon;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/crun;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/docker;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/docker-compose;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/flatpak;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/podman;
init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/xdg-open;
exported_apps="htop"
exported_bins="/usr/bin/htop /usr/bin/git"
exported_bins_path="~/.local/bin"

add init hooks and exported bins · WaylonWalker/devtainer@2e4c6da

2024-09-28T06:34:08Z

add init hooks and exported bins · WaylonWalker/devtainer@2e4c6da

🐳 (dotfiles) My personal development docker container base image - add init hooks and exported bins · WaylonWalker/devtainer@2e4c6da

GitHub · github.com

Today I learned that you can use init_hooks to access host machine commands from inside a distrobox container. This is super handy for things that you cannot get to from inside the container and need ran outside (docker, podman, flatpak, xdg-open).

init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/podman;

convert mp4 for twitter with ffmpeg

2024-07-25T12:51:29Z

I’ve had a couple of uploads to twitter fail recently and has been a pain. I tried some online converters for convenience, but none of them worked. I reached out to chatgpt and found succeess with this ffmpeg command.

ffmpeg -i input.mp4 \
  -vf "scale=trunc(oh*a/2)*2:min(720\,trunc(ih*a/2)*2)" \
  -c:v libx264 -profile:v high -level:v 4.1 \
  -b:v 3500k -maxrate 3500k -bufsize 7000k \
  -pix_fmt yuv420p \
  -c:a aac -b:a 128k -ar 44100 \
  -movflags +faststart \
  output.mp4

There’s a TUI for that with Nick Janetakis (Changelog & Friend...

2024-07-24T07:47:39Z

There’s a TUI for that with Nick Janetakis (Changelog & Friends #53)

Nick Janetakis is back and this time we're talking about TUIs (text-based user interfaces) — some we've tried and some we plan to try. All are collected from Justin Garrison's Awesome TUIs repo o...

Changelog · changelog.com

50 minutes into this episode they start a discussion on seo, and naming posts. They give Jerod the task of googling for tmux and see how high up the ranking they find Nick, expecting a number one post, and he cant even get to Nick.

The problem? Jerod is such a beginner he doesn’t even know what to search, he starts with a long query about getting started with tmux, but all of Nick’s videos are why you should use advanced features of tmux, but Jerod has yet to discover that these exist.

As experts we often come up wtih a post title for the exact thing that we are trying to teach someone how to do, but yet, they haven’t discussed that they need that feature yet, they just want the getting started guide, or tell me why I should start using tmux. Not why sessions are better than windows, and tabs suck all together.

Definitely an eye opening conversation listening to two experts sit in shock as the beginner just gets dropped big tech articles, and Nick Jani-freakin-takis doesn’t even hit the query page after page.

Also hats off to Nick for keeping a 2014 machine alive, I got you beat by a few years on my 2011 free give away machine, but I stopped daily driving that two years ago, and its purely a homelab now.

Command Line Interface Guidelines

2024-07-11T17:57:45Z

Command Line Interface Guidelines

An open-source guide to help you write better command-line programs, taking traditional UNIX principles and updating them for the modern day.

clig.dev

This is a pretty sick set of guidelines to help you write better cli programs, I’m definitely coming back to reading this one more in depth later.

Darren Burns 🌱 on X: "Here's an early clip of my new (work in ...

2024-06-04T07:04:35Z

External Link

x.com

This looks like a sweet tui postman clone. Darren is really rolling with these tui’s. Cant wait to see where this one goes.

Distrobox

2024-05-22T23:13:13Z

Distrobox

Use any linux distribution inside your terminal.

distrobox.it

distrobox gives you distrobox-host-exec to run commands on the host. This is handy to get access to host level clis that you probably wouldn’t want to run from the container like podman, docker, flatpak.

DESCRIPTION distrobox-host-exec lets one execute command on the host, while inside of a container.

Under the hood, distrobox-host-exec uses host-spawn a project that lets us execute commands back on the host. If the tool is not found the user will be prompted to install it.

rich.panel — Rich 13.6.0 documentation

2024-04-30T23:10:37Z

This is my go to rich response container for clis written in python. It creates a nice box around the content on the screen and provides some nice separation in the output. It can be overdone, but comes in clutch when looking for that print statement in a long output.

Creating SSH Apps with Charm Wish and Laravel Prompts | Joe Ta...

2024-04-30T23:05:21Z

Creating SSH Apps with Charm Wish and Laravel Prompts

Building PHP CLI apps with Laravel Prompts is easy, but how can we share them? Charm to the rescue! Charm Wish is an easy-to-use SSH server that allows users to securely log into your server and us...

Joe Tannenbaum · blog.joe.codes

Joe has a sick cli.labs site for deploying tui applications.

ssh cli.lab.joe.codes

cli auth

2023-12-17T20:09:03Z

Authentication from cli tools can be a bit of a bear, and I have to look it up every time. This is my reference guide for future me to remember how to easily do it.

I set up a fastapi server running on port 8000, it uses a basic auth with waylonwalker as the username and asdf as the password. The server follows along with what comes out of the docs. I have it setup to take basic auth, form username and password, or a bearer token for authentication.

curl #

The og of command line url tools.

# basic auth
curl -u 'waylonwalker:asdf' -X POST localhost:8000/token
# basic auth with password prompt
curl -u 'waylonwalker' -X POST localhost:8000/token
# token
curl -H 'Authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ3YXlsb253YWxrZXIiLCJleHAiOjE3MDI5NTI2MDJ9.GeYNt7DNal6LTiPoavJnqypaMt4vYeriXdq5lqu1ILg' -X POST localhost:8000/token

wget #

My go to if I want the result to go into a file.

# basic auth
wget -q -O - --auth-no-challenge --http-user=waylonwalker --http-password=asdf --post-data '' localhost:8000/token

# token
wget -q -O - --header="Authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ3YXlsb253YWxrZXIiLCJleHAiOjE3MDI5NTI2MDJ9.GeYNt7DNal6LTiPoavJnqypaMt4vYeriXdq5lqu1ILg" -O - --post-data '' localhost:8000/token

httpx #

An http client written in python, primarilty used with the python api, but has a nice cli.

# install
python3 -m pip install httpx

# basic auth
httpx -m POST --auth waylonwalker asdf http://localhost:8000/token

# basic auth with password prompt
httpx -m POST --auth waylonwalker - http://localhost:8000/token

# token
httpx -m POST --headers="Authorization" "bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ3YXlsb253YWxrZXIiLCJleHAiOjE3MDI5NTI2MDJ9.GeYNt7DNal6LTiPoavJnqypaMt4vYeriXdq5lqu1ILg" http://localhost:8000/token

httpie #

A modern http client written in python.

# install
python3 -m pip install httpie

# basic auth
http POST localhost:8000/token -a waylonwalker:asdf

# basic auth with password prompt
http POST localhost:8000/token -a waylonwalker

# token
http POST localhost:8000/token -A bearer -a eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ3YXlsb253YWxrZXIiLCJleHAiOjE3MDI5NTI2MDJ9.GeYNt7DNal6LTiPoavJnqypaMt4vYeriXdq5lqu1ILg

httpie with plugin #

# install
python3 -m pip install httpie-credential-store
# usage
http POST localhost:8000/token -A creds

httpie prompt #

http-prompt comes from the httpie org, and has an interactive cli interface into apis. You can even specify a spec file to autocomplete on api methods.

http-prompt localhost:8000 --auth waylonwalker:asdf --spec openapi.json

ImageMagick – Color Names

2023-12-13T23:23:32Z

Full list of imagemagick color names.

Will McGugan on X: "Just a wee thing that came up today. I thi...

2023-11-27T22:31:33Z

@willmcgugan) on X — Just a wee thing that came up today. I think this is kind of neat." loading="lazy">

Will McGugan (@willmcgugan) on X

Just a wee thing that came up today. I think this is kind of neat.

X (formerly Twitter) · twitter.com

Textual is so sick, Will just made a live markdown editor in the terminal!

kv - Command | Vault | HashiCorp Developer

2023-11-05T09:26:51Z

kv - Command | Vault | HashiCorp Developer

The "kv" command groups subcommands for interacting with Vault's key/value secret engine.

kv - Command | Vault | HashiCorp Developer · developer.hashicorp.com

hashi vault lets you manage secrets right from your cli.

# set your vault url
export VAULT_ADDR=https://myvault.mydomain
vault login

# get a secret
vault kv get secret/hvac

# put a secret
vault kv put -mount=secret creds passcode=my-long-passcode

# get it
vault kv get secret/creds

# == Secret Path ==
# secret/data/creds
# 
# ======= Metadata =======
# Key                Value
# ---                -----
# created_time       2023-11-05T02:53:40.978120001Z
# custom_metadata    <nil>
# deletion_time      n/a
# destroyed          false
# version            3
# 
# ====== Data ======
# Key         Value
# ---         -----
# bar         baz
# passcode    my-long-passcode

# get one field
vault kv get -field=passcode secret/creds

# my-long-passcode
vault kv put -mount=secret creds bar=baz

# set more keys
vault kv put -mount=secret creds passcode=my-long-passcode bar=baz

# 
# == Secret Path ==
# secret/data/creds
# 
# ======= Metadata =======
# Key                Value
# ---                -----
# created_time       2023-11-05T03:24:14.65958906Z
# custom_metadata    <nil>
# deletion_time      n/a
# destroyed          false
# version            4

vault kv get secret/creds

# == Secret Path ==
# secret/data/creds
# 
# ======= Metadata =======
# Key                Value
# ---                -----
# created_time       2023-11-05T02:53:40.978120001Z
# custom_metadata    <nil>
# deletion_time      n/a
# destroyed          false
# version            4
# 
# ====== Data ======
# Key         Value
# ---         -----
# bar         baz
# passcode    my-long-passcode

casey/just: 🤖 Just a command runner

2023-10-22T07:09:57Z

GitHub - casey/just: 🤖 Just a command runner

🤖 Just a command runner. Contribute to casey/just development by creating an account on GitHub.

GitHub · github.com

I think just, might just be the thing I have been looking for. I’ve been looking for some ci/cd that I can host myself, but everything looks pretty big, so for now I am going to use just as my task runner.

I installed with installer.

curl https://i.wayl.one/casey/just | bash

I set up my devtainer builds with just. Here is my justfile, yes you just need the cli and a file named justfile.

default: base alpine slim
base: build deploy
alpine: build-alpine deploy-alpine
slim: build-slim deploy-slim

build:
    podman build -t registry.wayl.one/devtainer:latest .
deploy:
    podman push registry.wayl.one/devtainer

build-alpine:
    podman build -f docker/Dockerfile.alpine -t registry.wayl.one/devtainer:alpine .
deploy-alpine:
    podman push registry.wayl.one/devtainer:alpine

build-slim:
    podman build -f docker/Dockerfile.slim -t registry.wayl.one/devtainer:slim .
deploy-slim:
    podman push registry.wayl.one/devtainer:slim

wincent/aspects/dotfiles/files/.zshrc at 85fc42d9e96d408a5b367...

2023-10-10T17:38:22Z

Wincent (Greg Hurrel) has a pretty solid and fast zshrc. I recently grabbed his completion section and it seems to be working better than whatever I had.

zsh completion snippet

#
# Completion
#

fpath=($HOME/.zsh/completions $fpath)

autoload -U compinit
compinit -u

# Make completion:
# - Try exact (case-sensitive) match first.
# - Then fall back to case-insensitive.
# - Accept abbreviations after . or _ or - (ie. f.b -> foo.bar).
# - Substring complete (ie. bar -> foobar).
zstyle ':completion:*' matcher-list '' '+m:{[:lower:]}={[:upper:]}' '+m:{[:upper:]}={[:lower:]}' '+m:{_-}={-_}' 'r:|[._-]=* r:|=*' 'l:|=* r:|=*'

# Colorize completions using default `ls` colors.
zstyle ':completion:*' list-colors ''

# Allow completion of ..<Tab> to ../ and beyond.
zstyle -e ':completion:*' special-dirs '[[ $PREFIX = (../)#(..) ]] && reply=(..)'

# $CDPATH is overpowered (can allow us to jump to 100s of directories) so tends
# to dominate completion; exclude path-directories from the tag-order so that
# they will only be used as a fallback if no completions are found.
zstyle ':completion:*:complete:(cd|pushd):*' tag-order 'local-directories named-directories'

# Categorize completion suggestions with headings:
zstyle ':completion:*' group-name ''
zstyle ':completion:*:descriptions' format %F{default}%B%{$__WINCENT[ITALIC_ON]%}--- %d ---%{$__WINCENT[ITALIC_OFF]%}%b%f

# Enable keyboard navigation of completions in menu
# (not just tab/shift-tab but cursor keys as well):
zstyle ':completion:*' menu select

jpillora-installer

2023-10-04T19:28:33Z

jpillora/installer is the install script generator I have been looking for. It downloads binaries for your machine from GitHub releases and unzips them for you. It grabs the latest release, so you can easily update them. I have tried scripting these installs in the past and struggled to consistently get the latest version for every package and unpack it correctly.

Also these pre-compiled binaries install rediculously fast compared to building them from source.

Check out some example links.

opening in a browser will show metadata

https://i.jpillora.com/serve

If you pass in script=true it will instead return the install script as it would by default through curl.

https://i.jpillora.com/serve?script=true

Use it to install neovim #

All you need to do to generate an install script is to pass in the GitHub repo slug with the org.

curl https://i.jpillora.com/neovim/neovim | bash

The shell script that it generates for neovim looks like this.

#!/bin/bash
if [ "$DEBUG" == "1" ]; then
    set -x
fi
TMP_DIR=$(mktemp -d -t jpillora-installer-XXXXXXXXXX)
function cleanup {
    rm -rf $TMP_DIR > /dev/null
}
function fail {
    cleanup
    msg=$1
    echo "============"
    echo "Error: $msg" 1>&2
    exit 1
}
function install {
    #settings
    USER="neovim"
    PROG="neovim"
    ASPROG=""
    MOVE="false"
    RELEASE="stable"
    INSECURE="false"
    OUT_DIR="$(pwd)"
    GH="https://github.com"
    #bash check
    [ ! "$BASH_VERSION" ] && fail "Please use bash instead"
    [ ! -d $OUT_DIR ] && fail "output directory missing: $OUT_DIR"
    #dependency check, assume we are a standard POISX machine
    which find > /dev/null || fail "find not installed"
    which xargs > /dev/null || fail "xargs not installed"
    which sort > /dev/null || fail "sort not installed"
    which tail > /dev/null || fail "tail not installed"
    which cut > /dev/null || fail "cut not installed"
    which du > /dev/null || fail "du not installed"
    #choose an HTTP client
    GET=""
    if which curl > /dev/null; then
        GET="curl"
        if [[ $INSECURE = "true" ]]; then GET="$GET --insecure"; fi
        GET="$GET --fail -# -L"
    elif which wget > /dev/null; then
        GET="wget"
        if [[ $INSECURE = "true" ]]; then GET="$GET --no-check-certificate"; fi
        GET="$GET -qO-"
    else
        fail "neither wget/curl are installed"
    fi
    #debug HTTP
    if [ "$DEBUG" == "1" ]; then
        GET="$GET -v"
    fi
    #optional auth to install from private repos
    #NOTE: this also needs to be set on your instance of installer
    AUTH="${GITHUB_TOKEN}"
    if [ ! -z "$AUTH" ]; then
        GET="$GET -H 'Authorization: $AUTH'"
    fi
    #find OS #TODO BSDs and other posixs
    case `uname -s` in
    Darwin) OS="darwin";;
    Linux) OS="linux";;
    *) fail "unknown os: $(uname -s)";;
    esac
    #find ARCH
    if uname -m | grep -E '(arm|arch)64' > /dev/null; then
        ARCH="arm64"

        # no m1 assets. if on mac arm64, rosetta allows fallback to amd64
        if [[ $OS = "darwin" ]]; then
            ARCH="amd64"
        fi

    elif uname -m | grep 64 > /dev/null; then
        ARCH="amd64"
    elif uname -m | grep arm > /dev/null; then
        ARCH="arm" #TODO armv6/v7
    elif uname -m | grep 386 > /dev/null; then
        ARCH="386"
    else
        fail "unknown arch: $(uname -m)"
    fi
    #choose from asset list
    URL=""
    FTYPE=""
    case "${OS}_${ARCH}" in
    "linux_amd64")
        URL="https://github.com/neovim/neovim/releases/download/stable/nvim-linux64.tar.gz"
        FTYPE=".tar.gz"
        ;;
    "darwin_amd64")
        URL="https://github.com/neovim/neovim/releases/download/stable/nvim-macos.tar.gz"
        FTYPE=".tar.gz"
        ;;
    *) fail "No asset for platform ${OS}-${ARCH}";;
    esac
    #got URL! download it...
    echo -n "Downloading"
    echo -n " $USER/$PROG"
    if [ ! -z "$RELEASE" ]; then
        echo -n " $RELEASE"
    fi
    if [ ! -z "$ASPROG" ]; then
        echo -n " as $ASPROG"
    fi
    echo -n " (${OS}/${ARCH})"

    echo "....."

    #enter tempdir
    mkdir -p $TMP_DIR
    cd $TMP_DIR
    if [[ $FTYPE = ".gz" ]]; then
        which gzip > /dev/null || fail "gzip is not installed"
        bash -c "$GET $URL" | gzip -d - > $PROG || fail "download failed"
    elif [[ $FTYPE = ".tar.bz" ]] || [[ $FTYPE = ".tar.bz2" ]]; then
        which tar > /dev/null || fail "tar is not installed"
        which bzip2 > /dev/null || fail "bzip2 is not installed"
        bash -c "$GET $URL" | tar jxf - || fail "download failed"
    elif [[ $FTYPE = ".tar.gz" ]] || [[ $FTYPE = ".tgz" ]]; then
        which tar > /dev/null || fail "tar is not installed"
        which gzip > /dev/null || fail "gzip is not installed"
        bash -c "$GET $URL" | tar zxf - || fail "download failed"
    elif [[ $FTYPE = ".zip" ]]; then
        which unzip > /dev/null || fail "unzip is not installed"
        bash -c "$GET $URL" > tmp.zip || fail "download failed"
        unzip -o -qq tmp.zip || fail "unzip failed"
        rm tmp.zip || fail "cleanup failed"
    elif [[ $FTYPE = ".bin" ]]; then
        bash -c "$GET $URL" > "neovim_${OS}_${ARCH}" || fail "download failed"
    else
        fail "unknown file type: $FTYPE"
    fi
    #search subtree largest file (bin)
    TMP_BIN=$(find . -type f | xargs du | sort -n | tail -n 1 | cut -f 2)
    if [ ! -f "$TMP_BIN" ]; then
        fail "could not find find binary (largest file)"
    fi
    #ensure its larger than 1MB
    #TODO linux=elf/darwin=macho file detection?
    if [[ $(du -m $TMP_BIN | cut -f1) -lt 1 ]]; then
        fail "no binary found ($TMP_BIN is not larger than 1MB)"
    fi
    #move into PATH or cwd
    chmod +x $TMP_BIN || fail "chmod +x failed"
    DEST="$OUT_DIR/$PROG"
    if [ ! -z "$ASPROG" ]; then
        DEST="$OUT_DIR/$ASPROG"
    fi
    #move without sudo
    OUT=$(mv $TMP_BIN $DEST 2>&1)
    STATUS=$?
    # failed and string contains "Permission denied"
    if [ $STATUS -ne 0 ]; then
        if [[ $OUT =~ "Permission denied" ]]; then
            echo "mv with sudo..."
            sudo mv $TMP_BIN $DEST || fail "sudo mv failed"
        else
            fail "mv failed ($OUT)"
        fi
    fi
    echo "Downloaded to $DEST"
    #done
    cleanup
}
install

self-host-your-own">Self Host Your Own #

I’d reccomend self hosting your own. This way you know that it’s consistent and unlikely to change in a way that breaks your use.

curl -s https://i.jpillora.com/installer | bash

Repos I am using installer for #

Here are the repos I am using installer for.

atuinsh/atuin
benbjohnson/litestream
bootandy/dust
BurntSushi/ripgrep
chmln/sd
cjbassi/ytop
dalance/procs
dbrgn/tealdeer
ducaale/xh
go-task/task
imsnif/bandwhich
imsnif/diskonaut
kovidgoyal/kitty
mgdm/htmlq
neovim/neovim
ogham/dog
ogham/exa
pemistahl/grex
sharkdp/bat
sharkdp/fd
sharkdp/pastel
sirwart/ripsecrets
starship/starship
topgrade-rs/topgrade
zellij-org/zellij

jpillora/installer: One-liner for installing binaries from Git...

2023-09-23T05:59:09Z

GitHub - jpillora/installer: One-liner for installing binaries from Github releases

One-liner for installing binaries from Github releases - jpillora/installer

GitHub · github.com

This is a sick looking bash script generator for installing binaries off of github releases. it reccomends curl into bash, but you could curl into install.sh and toss that in your dotfiles repo or wherever.

Install installer with installer

curl -s https://i.jpillora.com/installer | bash

Formatter

2023-09-07T05:32:00Z

Formatter

How to use the Biome formatter.

Biome · biomejs.dev

Tried out biome today and it worked better than prettier on jinja templates, I might adopt this over prettier.

cURL Command Without Using Cache | Baeldung on Linux

2023-08-21T18:39:41Z

cURL Command Without Using Cache | Baeldung on Linux

A quick and practical guide to using curl without cache.

Baeldung on Linux · baeldung.com

Busting cache with curl. I’m not sure how much gets cached by curl, but I have ran into several cases where I am looking for new content and I want to ensure the content is new and no chance of being cached.

This article suggests 3 different techniques.

curl -H 'Cache-Control: no-cache, no-store' http://www.example.com
curl -H 'Pragma: no-cache' http://www.example.com
curl http://www.example.com/?xyzzyspoon

sharkdp/bat: A cat clone with wings.

2023-08-21T18:28:06Z

GitHub - sharkdp/bat: A cat(1) clone with wings.

A cat(1) clone with wings. Contribute to sharkdp/bat development by creating an account on GitHub.

GitHub · github.com

Bat is my favorite pager, its the one for me that seems to just work more than the rest. colors, syntax highlighting, line numbers search, it just feels the most natural.

How to Format All Files in a Directory with Prettier | by Dr. ...

2023-08-19T19:58:09Z

External Link

levelup.gitconnected.com

Use prettier to format all files in a directory. By default prettier does not write, it just echos out the format that it would do. Give it the --write and it will write the changes to the files.

prettier --write .

I just used this on my thoughts repo.

prettier --write templates

Center things - Textual

2023-07-30T21:31:55Z

Textual - Center things

Textual is a TUI framework for Python, inspired by modern web development.

Textual Documentation · textual.textualize.io

How to center things in textual. Textual has a very unique way of styling text user interfaces for the terminal using css. If you know css it feels natural.

@willmcgugan, has put together a great article on how to center things in textual

here the final result

from textual.app import App, ComposeResult
from textual.widgets import Static

QUOTE = "Could not find you in Seattle and no terminal is in operation at your classified address."


class CenterApp(App):
    """How to center things."""

    CSS = """
    Screen {
        align: center middle;
    }

    #hello {
        background: blue 50%;
        border: wide white;
        width: 40;
        height: 9;
        text-align: center;
        content-align: center middle;
    }
    """

    def compose(self) -> ComposeResult:
        yield Static(QUOTE, id="hello")


if __name__ == "__main__":
    app = CenterApp()
    app.run()

Deleting Specific Lines in a File with sed or yq

2023-07-28T19:59:37Z

Deleting Specific Lines in a File with sed or yq — Nick Janetakis

Nick Janetakis · nickjanetakis.com

sed can be a tricky beast, I often stumble when trying to pipe into it. Next time I need to use sed, I should reference this article by Nick Janetakis. He makes it looks much easier than my experience has been, and it appears to behave like a vim :%s/ substitution does, or a g/ g command.

1j01/textual-paint: :art: MS Paint... in your terminal.

2023-07-28T19:59:37Z

GitHub - 1j01/textual-paint: :art: MS Paint in your terminal.

:art: MS Paint in your terminal. Contribute to 1j01/textual-paint development by creating an account on GitHub.

GitHub · github.com

1j01 created a complete working clone of ms paint in the terminal using the textual framework. It’s incredible.

Harlequin SQL IDE - DuckDB

2023-07-28T19:59:37Z

External Link

duckdb.org

Harlequin is a pretty sweet example of what textual can be used to create. Its a terminal based sql ide for DuckDB.

doyensec/wsrepl: WebSocket REPL for pentesters

2023-07-28T19:59:37Z

GitHub - doyensec/wsrepl: WebSocket REPL for pentesters

WebSocket REPL for pentesters. Contribute to doyensec/wsrepl development by creating an account on GitHub.

GitHub · github.com

Very inspiring textual project to check out how they set up the ui. Their intro video has a pretty epic dev experience.

Doyensec on Twitter: "Announcing wsrepl, the WebSocket testing...

2023-07-28T19:59:37Z

https://t.co/km5m7k6Pb0

#doyensec #appsec #websockets #burpsuite" loading=“lazy”>

Doyensec (@Doyensec) on X

Announcing wsrepl, the WebSocket testing tool from Doyensec! This intuitive tool is super easy to use and makes automation around WebSockets simple!

Check out our blog for the details and download…

X (formerly Twitter) · twitter.com

wsrepl is an epic websocket repl built in python on the textual framework.

Releasing a New Version of Your Python Package Just Got Easier

2023-01-23T10:52:19Z

Quickly and easily create new versions of your Python package with the gh release command. Get the version number, changelog, and

Releasing a new version of your Python package can be a daunting task. You need to make sure that all the necessary files are included, and that the version number is correct. But now, with the help of the gh release command, you can make the process much smoother.

The gh release command allows you to quickly and easily create a new version of your Python package. All you need to do is provide the version number, the changelog, and the distribution files. For example, if you wanted to create a new version of your package with the version number v1.2.3, you could use the following command:

gh release create v1.2.3 -F CHANGELOG.md dist/*.whl dist/*.tar.gz

This command will create a new version of your package with the specified version number, and include the changelog and the distribution files. It’s a great way to make sure that all the necessary files are included in the release, and that the version number is correct.

The gh release command is a great tool for quickly and easily creating new versions of your Python package. With just a few simple commands, you can make sure that all the necessary files are included, and that the version number is correct. So if you’re looking for an easy way to release a new version of your Python package, give the gh release command a try.

dash e your github docker actions

2022-12-07T13:09:37Z

Give github actions the -e flag in the shebang #! so they fail on any one command failure. Otherwise each line will set the exit status, but only the last one will be passed to ci.

#!/bin/bash -e

What is -e #

The -e flag to the bash command allows your script to exit immediately if any command within the script returns a non-zero exit status. This can be useful for ensuring that your script exits with an error if any of the commands it runs fail, which can help you identify and debug issues in your script. For example, if you have a script that runs several commands and one of those commands fails, the script will continue running without the -e flag, but will exit immediately if the -e flag is present. This can make it easier to troubleshoot your script and ensure that it runs correctly.

Solution for Windows #

In windows the solution is not quite as simple. You can define a function in a Windows batch script that wraps an if statement to check the exit status of a command and handle any errors that may have occurred. Here is an example of how you might define a function called “check_error” that does this:

:check_error
if errorlevel 1 (
  echo An error occurred!
  exit /b 1
)

To use this function in your script, you would simply call it after running a command, like this:

some_command
call :check_error

This would run the “some_command” and then call the “check_error” function to check the exit status and handle any errors that may have occurred. This approach allows you to reuse the error-checking logic in your script, which can make it easier to write and maintain.

tmux push/pull panes

2022-12-04T13:25:54Z

Moving panes between tmux sessions is something that makes tmux a very flexible and powerful tool. I don’t need this feature very often, but it comes in clutch when you need it.

Pull a pane from any other session #

Using choose-window I was able to come up with a way to select any pane withing any other session and join it into my current session.

# Choose a pane to join in horizontally
bind f choose-window -Z 'join-pane -h -s "%%"'

Push/Pull from scratch #

I’ve long had this one in my tmux config, I always have a “scratch” session that I’m running, I often use for looking at things like k9s accross repos within a popup.

This use case puts a pane into the scratch session, then pulls it back out. I will use this to move a pane between sessions in the rare cases I need to do this.

# push the active pane into the scratch session horizonally
bind -n M-f join-pane -ht scratch
# pull the last active pane from the scratch session horizonally into this session
bind -n M-F join-pane -hs scratch

Get better at jq interactively | ijq

2022-07-15T21:09:35Z

jq has some syntax that will sneak up on you with complexity. It looks so good, and so understandable, but everytime I go to use it myself, I don’t get it. ijq is an interactive alternative to jq that gives you and nice repl that you can iterate on queries quickly.

paru -Syu ijq

Here are some other articles, I decided to link at the time of writing this article.

JUT | Read Notebooks in the Terminal

Comprehensive guide to creating kedro nodes

Kedro - My Data Is Not A Table

Bash function to edit scripts faster

2022-05-10T14:57:35Z

I am often editing my own scripts as I develop them. I want to make a better workflow for working with scripts like this.

Currently #

Currently I am combining nvim with a which subshell to etit these files like this.

for now lets use my todo command as an example

nvim `which todo`

First pass #

On first pass I made a bash function to do exactly what I have been doing.

ewhich () {$EDITOR `which "$1"`}

The $1 will pass the first input to the which subshell. Now we can edit our todo script like this.

ewich todo

Note, I use bash functions instead of aliases for things that require input.

Final State #

This works fine for commands that are files, but not aliases or shell functions. Next I jumped to looking at the output of command -V $1.

if the command is not found, search for a file
if its a builtin, exit
if its an alias, open my ~/.alias file to that line
if its a function, open my ~/.alias file to that line

ewhich () {
case `command -V $1` in
    "$1 not found")
        FILE=`fzf --prompt "$1 not found searching ..." --query $1`
        [ -z "$FILE" ] && echo "closing" || $EDITOR $FILE;;
    *"is a shell builtin"*)
        echo "$1 is a builtin";;
    *"is an alias"*)
        $EDITOR ~/.alias +/alias\ $1;;
    *"is a shell function"*)
        $EDITOR ~/.alias +/^$1;;
    *)
        $EDITOR `which "$1"`;;
esac

a bit more ergo, and less readable #

To make it easier to type, at the sacrifice of readability for anyone watching I added a single character e alias to ewhich. So when I want to edit anything I just use e.

alias e=ewhich

Results #

Here is a quick screencast of how it works.

30e5b198-1693-4100-a722-ad0193004e9a.webm

Using Git from Python

2022-04-30T20:23:23Z

GitPython is a python api for your git repos, it can be quite handy when you need to work with git from python.

Use Case #

I recently made myself a handy tool for making screenshots in python and it need to do a git commit and push from within the script. For this I reached for GitPython.

How I Quickly Capture Screenshots directly into My Blog

Installation #

GitPython is a python library hosted on pypi that we will want to install into our virtual environments using pip.

pip install GitPython

Create a Repo Object #

Import Repo from the git library and create an instance of the Repo object by giving it a path to the directory containing your .git directory.

from git import Repo
repo = Repo('~/git/waylonwalker.com/')

Two interfaces #

from the docs

It provides abstractions of git objects for easy access of repository data, and additionally allows you to access the git repository more directly using either a pure python implementation, or the faster, but more resource intensive git command implementation.

I only needed to use the more intensive but familar to me git command implementation to get me project off the ground. There is a good tutorial to get you started with their pure python implementation in their docs.

Status #

Requesting the git status can be done as follows.

note I have prefixed my commands with »> to distinguish between the command I entered and the output.

>>> print(repo.git.status())

On branch main
Your branch is ahead of 'origin/main' by 1 commit.
  (use "git push" to publish your local commits)

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        blog/

You can even pass in flags that you would pass into the cli.

>>> print(repo.git.status("-s"))

<!--markata-attribution-->
?? blog/

log #

Example of using the log.

print(repo.git.log('--oneline', '--graph'))

* 0d28bd8 fix broken image link
* 3573928 wip screenshot-to-blog
* fed9abc wip screenshot-to-blog
* d383780 update for wsl2
* ad72b14 wip screenshot-to-blog
* 144c2f3 gratitude-180

Find Deleted Files #

We can even do things like find all files that have been deleted and the hash they were deleted.

print(repo.git.log('--diff-filter', 'D', '--name-only', '--pretty=format:"%h"'))

git find deleted files

full post on finding deleted files

My Experience #

This library seemed pretty straightforward and predicatable once I realized there were two main implementations and that I would already be familar with the more intensive git command implementation.

Mixing Colors at the Command Line

2022-04-05T17:20:37Z

From the same Author that brought us command line essentials like fd and bat written in rust comes pastel an incredible command-line tool to generate, analyze, convert and manipulate colors.

Install #

You can install from one of the releases, follow the instructions for your system from the repo. I chose to go the nix route. I have enjoyed the simplicity of the nix package manager being cross platform and have very up to date packages in it.

nix-env --install pastel

Mixing colors #

Something I often do to blend colors together is add a little alpha to something over top of a background. I can simulate this by mixing colors.

pastel color cornflowerblue | pastel mix goldenrod -f .1

Here is one from the docs that show how you can generate a color palette from random colors, mix in some red, lighten and format all in one pipe.

pastel random | pastel mix red | pastel lighten 0.2 | pastel format hex

color picker #

I am on Ubuntu 20.10 as I write this and it works flawlessly. When I call the command, a color picker gui pops up along with an rgb panel. I can pick from the panel or from anywhere on my screen.

pastel color-picker

pastel pick

Conversions #

I often will want to convert a color from rgb to hex or hsl vice versa. I open google and search. This is one part that I could really use adding to my workflow.

Check it #

Here I can mix up a dark grey with rgb, mix in 20% cornflowerblue, and grab the hex value.

pastel color 50,50,50 | pastel mix cornflowerblue -f .2

I really want to get this into my workflow. I saw it quite awhile ago but have not done much color work. Lately I have been doing a bit more front end, and have been getting into game development. This is the time to stop googling random color mixers and use this one.

Unzip minecraft mods to their directory from the command line

2022-04-02T16:20:34Z

This morning I was trying to install a modpack on my minecraft server after getting a zip file, and its quite painful when I unzip everything in the current directory rather than the directory it belongs in.

I had the files on a Windows Machine #

So I’ve been struggling to get mods installed on linux lately and the easiest way to download the entire pack rather than each mod one by one seems to be to use the overwolf application on windows. Once I have the modpack I can start myself a small mod-server by zipping it, putting it in a mod-server directory and running a python http.server

python -m http.server

Downoading on the server #

Then I go back to my server and download the modpack with wget.

wget 10.0.0.171:8000/One%2BBlock%2BServer%2BPack-1.4.zip

Unzip to the minecraft-data directory #

Now I can unzip my mods into the minecraft-data directory.

unzip One+Block+Server+Pack-1.4.zip -d minecraft-data

Running the server with docker #

I run the minecraft server with docker, which is setup to mount the minecraft-data directory.

Running a Minecraft Server in Docker

A bit more on that in the other post, but when I download the whole modpack like this I make these changes to my docker compose. (commented out lines)

version: "3.8"

services:
  mc:
    container_name: walkercraft
    image: itzg/minecraft-server:java8
    environment:
      EULA: "TRUE"
      TYPE: "FORGE"
      VERSION: 1.15.2
      # MODS_FILE: /extras/mods.txt
      # REMOVE_OLD_MODS: "true"
    tty: true
    stdin_open: true
    restart: unless-stopped
    ports:
      - 25565:25565
    volumes:
      - ./minecraft-data:/data
      # - ./mods.txt:/extras/mods.txt:ro

volumes:
  data:

Style Lookatme Slides a bit more Personal

2022-03-24T00:00:00Z

I recently gave a talk at python web conf 2022, and one of the things I did when I should have been working on my presentation was workig on how my presentation looked… classic procrastination technique.

Slide One #

Lets use this section to show what it looks like as I change my styles.

from markata import Markata
Markata()
markata.run()

☝ This is how my website is built

write markdown
build site
publish

default #

This is what the above slide looks like in lookatme.

Set focus to the most important element #

The way I write my slides I want the most prominant element to be the slides title, not the presentation title. The slides title is generally the point I am trying to make, I will leave some supporting information if I want, but sometimes, I just have a title.

styles:
    title:
        bg: default
        fg: '#e1af66'
    headings:
        '1':
            bg: default
            fg: '#ff66c4,bold,italics'
            prefix: ' ⇁ '
            suffix: ' ↽ '

by default he prefix/suffix was a full block that just went transparant into the slide. I thought the harpoons were fun and went with them on a whim

The box characters bother me #

The box characters are fine really, but it really bothers me that they are not conneted. The author is probably doing this because it looks ok on most systems, and many terminals dont have their fonts right and wont align anyways. I am not sure if I ever had a windows terminal other than their new Terminal that properly connected box characters.

    quote:
        side: '│'
        style:
            bg: default
            fg: '#aaa'
        top_corner: '╭'
        bottom_corner: '╰'

Add Author #

Adding author to the root of the frontmatter of the document will add it to the bottom left of the slides.

author: '@_waylonwalker'

Style the author #

We can style the foreground and background of this text by adding something like this to the styles section of the frontmatter.

author:
    bg: default
    fg: '#368ce2'

While we are at it, lets style the rest of the footer to my own theme. Let’s pop this into the style and see what it looks like.

date:
    bg: default
    fg: '#368ce2'
slides:
    bg: default
    fg: '#368ce2'

reduce the padding #

When I am presenting I am punched in as big as I can go, and which makes the padding massive. I want as much as the screen real estate devoted to making big readable text as I can.

padding:
    bottom: 0
    left: 0
    right: 0
    top: 0

final results #

Here is what the final frontmatter looks like to fully style my talk.

---
date: 2022-03-24
templateKey: til
title: Style Lookatme Slides a bit more Personal
tags:
  - python
  - cli
  - python
author: '@_waylonwalker'
styles:
    padding:
        bottom: 0
        left: 0
        right: 0
        top: 0
    title:
        bg: default
        fg: '#e1af66'
    date:
        bg: default
        fg: '#368ce2'
    slides:
        bg: default
        fg: '#368ce2'
    headings:
        '1':
            bg: default
            fg: '#ff66c4,bold,italics'
            prefix: ' ⇁ '
            suffix: ' ↽ '
    quote:
        side: '│'
        style:
            bg: default
            fg: '#aaa'
        top_corner: '╭'
        bottom_corner: '╰'
    author:
        bg: default
        fg: '#368ce2'
---

How I Present Markdown Slides from the Terminal

2022-03-21T16:13:39Z

I love the freedom of writing in markdown. It allows me to write content from the comfort of my editor with very little focus on page style. It turns out that markdown is also a fantastic tool for creating slides.

Present from the terminal #

I will most often just present right from the terminal using lookatme. Presenting from the terminal lets me see the results quick right from where I am editing. It also allows me to pop into other terminal applications quickly.

reveal.js #

I sometimes also use reveal.js, but that’s for another post. It is handy that it lives in the browser and is easier to share.

New Slides #

I leverage auto slides when I write my slides in markdown. The largest heading, usually an h2 for me, becomes the new slide marker. Otherwise my process is not much different, It just becomes a shorter writing style.

Installation #

lookatme is a python library that is available on pypi, you can install it with the pip command.

python -m pip install lookatme

Since it’s a command line application it works great with pipx. This prevents the need to manage virtual environments yourself or ending up with packages clashing in your system python environment.

pipx install lookatme

From my terminal #

lookatme {filepath}

I just run it with pipx.

pipx run \
 --spec git+https://github.com/waylonwalker/lookatme \
 lookatme {filepath} \
 --live-reload \
 --style gruvbox-dark

Note, I use a custom fork of lookatme. It’s schema validation did not like the date format of my blog posts, so I have a one line fix built into my fork that is pretty specific to me.

From Neovim #

most often what I do

From Neovim I use a plugin I created for sending out commands to tmux called telegraph. This sends the above command to a new session that I can bounce between quickly.

nnoremap <leader><leader>s <cmd>lua require'telegraph'.telegraph({cmd='pipx run --spec git+https://github.com/waylonwalker/lookatme lookatme {filepath} --live-reload --style gruvbox-dark', how='tmux'})<CR>

Set Your Git Pager Config

2022-03-16T14:03:18Z

Setting up your git pager to your liking can help you navigate diffs and logs much more efficiently. You can set it to whatever pager you like so that your keys feel nice and smooth and your fingers know exactly what to do. You might even gain a few extra features.

You can set the pager right from your command line with the following command.

git config --global core.pager 'more'

You can also set your pager by editing your global .gitconfig file which by default is set to ~/.gitconfig.

[core]
    pager = more

Color #

In my experience you need to turn colors off with nvim. bat handles them and looks good either way, but nvim will be plain white and display the color codes as plain text if color is on.

git config --global color.pager no

Pagers I have tried #

Here are some various configs that I tried. For some reason line numbers in bat really bothered me, but when in nvim they felt ok. I am going to try running both of them for a few days and see which I like better. I think having some of my nvim config could be really handy for things like yanking a commit hash to the system clipboard without touching the mouse.

# bat
git config --global core.pager 'bat'

# nvim in read only mode
git config --global core.pager 'nvim -R'

# turn colors off
git config --global color.pager no

# bat with no line numbers
git config --global core.pager 'bat --style=plain'

# nvim with no line numbers and a specific rc file
git config --global core.pager "nvim -R +'set nonumber norelativenumber' -u ~/.config/nvim/init-git.vim"

reset back to the default #

If you are afraid to try one of these settings, don’t be you can always change it back. If you tried one and dont like it just --unset the config that you just tried.

git config --global --unset core.pager
git config --global --unset color.pager

The other option you have is to open your .gitconfig file and delete the lines of config that set your pager.

Configure Git to Autocorrect Your Fat Fingers

2022-03-15T00:43:25Z

If you have ever mistyped a git command very close to an existing one you have likely seen this message.

❯ git chekout dev
git: 'chekout' is not a git command. See 'git --help'.

The most similar command is
        checkout

Automatically run the right one #

What you might not have known is that you can configure git to just run this command for you.

# Gives you 0.1 seconds to respond
git config --global help.autocorrect 1

# Gives you 1 seconds to respond
git config --global help.autocorrect 10

# Gives you 5 seconds to respond
git config --global help.autocorrect 50

Fat Fingers Gone #

Now when you typo a git command it will autmatically run after the configured number of tenths of a second.

❯ git chkout get-error
WARNING: You called a Git command named 'chkout', which does not exist.
Continuing in 1.0 seconds, assuming that you meant 'checkout'.
M       pages/blog/how-i-deploy-2021.md
M       pages/hot_tips/001.md
M       pages/templates/gratitude_card.html
M       plugins/index.py
M       plugins/publish_amp.py
M       plugins/render_template_variables.py
M       plugins/youtube.py
M       requirements.txt
M       static/index.html
Switched to branch 'get-error'

My config #

I’m rocking 10 for now just to see how I feel about it, but honestly I cannot think of a time that I have seen the original warning that was not what I wanted. This at least gives me some time to respond if I am unsure.

git config --global help.autocorrect 10

Install yq | A light weight yaml parser cli

2022-03-14T18:30:12Z

yq is a command line utility for parsing and querying yaml, like jq does for json.

This is for me #

I love that all of these modern tools built in go and rust, just give you a zipped up executable right from GitHub releases, but it’s not necessarily straight forward how to install them. yq does one of the best jobs I have seen, giving you instructions on how to get a specific version and install it.

I use a bunch of these tools, and for what its worth I trust the devs behind them to make sure they don’t break. This so far has worked out well for me, but if it ever doesn’t I can always pick an older version.

Just give me the latest #

Since I am all trusting of them I just want the latest version. I do not want to update a shell script with new versions, or even care about what then next version is, I just want it. Luckily you can script the release page for the latest version on all that I have came accross.

What is the latest #

I wrote or stole, I think I wrote it, this line of bash quite awhile ago, and it has served me well for finding the latest release for any GitHub project using releases. Just update it with the name of the tool, org, and repo and it works.

YQ_VERSION=$(curl --silent https://github.com/mikefarah/yq/releases/latest | tr -d '"' | sed 's/^.*tag\///g' | sed 's/>.*$//g' | sed 's/^v//')

Install with your shell #

Now that we know how to consistently get the right version, I generally right click the release in the releases page, replace the version with ${TOOL_VERSION} and put it in this wget call, then move the binary over to ~/.local/bin

local tmp=`mktemp -dt install-XXXXXX`
pushd $tmp
YQ_VERSION=$(curl --silent https://github.com/mikefarah/yq/releases/latest | tr -d '"' | sed 's/^.*tag\///g' | sed 's/>.*$//g' | sed 's/^v//')
wget https://github.com/mikefarah/yq/releases/download/v${YQ_VERSION}/yq_linux_amd64.tar.gz -O- -q | tar -zxf - -C /tmp
cp yq_linux_amd64 ~/.local/bin/yq
popd

Install with ansible #

Now I don’t want to worry about missing yq again, so I am added it to my ansible install script. This way it’s installed everyt time I setup a new system with all of my favorite cli’s.

- name: check is yq installed
  shell: command -v yq
  register: yq_exists
  ignore_errors: yes
  tags:
    - yq

- name: Install yq
  when: yq_exists is failed
  shell: |
    local tmp=`mktemp -dt install-XXXXXX`
    pushd $tmp
    YQ_VERSION=$(curl --silent https://github.com/mikefarah/yq/releases/latest | tr -d '"' | sed 's/^.*tag\///g' | sed 's/>.*$//g' | sed 's/^v//')
    wget https://github.com/mikefarah/yq/releases/download/v${YQ_VERSION}/yq_linux_amd64.tar.gz -O- -q | tar -zxf - -C /tmp
    cp yq_linux_amd64 {{ lookup('env', 'HOME') }}/.local/bin/yq
    popd
  tags:
    - yq

Links #

This is how I installed it, of course you can always follow Mike’s instructions from the repo.

Make Kedro Runs Beautiful

2022-03-11T13:14:51Z

Kedro rich is a very new and unstable (it’s good, just not ready) plugin for kedro to make the command line prettier.

Install kedro rich #

There is no pypi package yet, but it’s on github. You can pip install it with the git url.

pip install git+https://github.com/datajoely/kedro-rich

Kedro run #

You can run your pipeline just as you normally would, except you get progress bars and pretty prints.

kedro run

Kedro catalog #

Listing out catalog entries from the command line now print out a nice pretty table.

kedro catalog list

Give it a star #

Go to the GitHub repo and give it a star, Joel deserves it.

Git Worktrees are not so Scary

2022-03-10T19:19:34Z

So worktrees, I always thought they were a big scary things. Turns out they are much simpler than I thought.

Myth #1 #

no special setup

I thought you had to be all in or worktrees or normal git, but not both. When I see folks go all in on worktrees they start with a bare repo, while its true this is the way you go all in, its not true that this is required.

Lets make a worktree #

Making a worktree is as easy as making a branch. It’s actually just a branch that lives in another place in your filesystem.

# checkout a new worktree called compare based on main in /tmp/project
git worktree add -b compare /tmp/project main

# checkout a new worktree called compare based on HEAD in /tmp/project
git worktree add -b compare /tmp/project

# checkout a worktree from an existing feature branch in /tmp/project
git worktree add /tmp/project my-existing-feature-branch

The worktree that you create is considered a linked worktree, while the original worktree is called the main worktree

Note that I put this in my tmp directory because I don’t expect it to live very long, my recent use case was to compare two files after a big formatting change. You put these where you want, but dont come at me when your /tmp gets wiped and you loose work.

Myth #2 #

they are hidden mysterious creatures

Just like branches git has some nice commands to help us understand what worktrees we have on our system. Firstly we have something very specific to worktrees to list them out.

git worktree list

gives the output

/home/u_walkews/git/git-work-play  b202442 [main]
/tmp/another                       d9b2cf1 [another]

Even the branch command gives a bit different output for a worktree.

git branch

gives this output, notice the + denotes an actively linked worktree, and the * gives the active branch. If you cd over to the worktree directory, these will switch roles.

+ another
  just-a-branch
* main

You can only checkout a branch in one place #

If you try to checkout a branch that is checked out in a linked worktree, you will be presented with an error, and it will not let you check out a second copy of that branch.

❯ git checkout another
fatal: 'another' is already checked out at '/tmp/another'

Myth #3 #

once you go worktree, you worktree

Once you have worktrees on your system, you have a few ways to get rid of them. Using git’s way feels much superior, but if your a doof like me and didn’t read the manual before you rm /tmp/another -rf you will notice that the worktree is still active. If you run git worktree prune it will clean that right up.

git worktree remove another

rm /tmp/another
git worktree prune

It won’t let you remove if you have changes #

This makes me think that remove is a much safer option. If you have uncommitted changes, git worktree remove will throw an error, and make you commit or use --force to remove the worktree.

❯ git worktree remove another
fatal: 'another' contains modified or untracked files, use --force to delete it

RTFM #

read the friendly manual

There is a ton more information in the man page for worktrees, these are just the parts that seemed really useful to me out of the gate.

man git worktree

Open Files with Nvim Remote

2022-03-06T16:22:49Z

I recently found a really great plugin by mhinz to open files in neovim from a different tmux split, without touching neovim at all.

Installation #

neovim-remote is not a neovim plugin at all, it’s a python cli that you can install with pip. Unlike the repo suggests, I use pipx to install nvr.

pipx install neovim-remote

How I use it #

I have this added to my .envrc that is in every one of my projects. This will tie a neovim session to that directory, and all directories under it.

export NVIM_LISTEN_ADDRESS=/tmp/nvim-$(basename $PWD)

In my workflow I open a tmux session for each project, so this essentially ties a neovim session to a tmux session.

Open neovim #

First open neovim, but with the nvr command. This will open neovim, and look pretty much the same as always.

nvr

If you try to run nvr again in another shell nothing will happen as its already runnin under that address, but if you give it a filename it will open the file in the first instance of neovim that you opened.

nvr readme.md

Links #

GitHub

Dedupe your shell paths

2022-03-04T19:08:49Z

If you have ever ran which <command> and see duplicate entries it’s likely that you have duplicate entries in your $PATH. You can clean this up with a one liner at the end of your bashrc or zshrc.

eval "typeset -U path"

Bash mktemp

2022-03-02T14:52:08Z

There is GNU coreutils command called mktemp that is super handy in shell scripts to make temporary landing spots for files so that they never clash with another instance, and will automatically get cleaned up when you restart, or whenever /tmp gets wiped. I’m not sure when that is, but I don’t expect it to be long.

Making temp directories #

Here are some examples of making temp directories in different places, my favorite is mktemp -dt mytemp-XXXXXX.

# makes a temporary directory in /tmp/ with the defaul template tmp.XXXXXXXXXX
mktemp

# makes a temporary directory in your current directory
mktemp --directory mytemp-XXXXXX
# shorter version
mktemp -d mytemp-XXXXXX

# same thing, but makes a file
mktemp mytemp-XXXXXX

# makes a temporary directory in your /tmp/ directory (or what ever you have configured as your TMPDIR)
mktemp --directory --tmpdir mytemp-XXXXXX
# shorter version
mktemp -dt mytemp-XXXXXX

# same thing, but makes a file
mktemp --tmpdir mytemp-XXXXXX
# shorter version
mktemp -t mytemp-XXXXXX

Use Case #

Here is a sample script that shows how to capture the tempdir as a variable and reuse it. Here is an example of curling my bootstrap file into a temp directory and running it from that directory.

local tmp=`mktemp -dt bootstrap-XXXXXX`
pushd $tmp
curl https://raw.githubusercontent.com/WaylonWalker/devtainer/main/bootstrap > bootstrap
bash bootstrap
popd

Templates #

You must have at least 3 trailing X’s that mktemp will replace with random characters. I played with it for a bit, it kinda allows for some trailing characters, and will not fill groups of X’s earlier in your template, only the last consecutive string.

My randomm samples I played with.

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com) took 2m24s
❯ mktemp myXtemp-XaXbXXXX -dt
/tmp/myXtemp-XaXbx9hn

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XaXbXXXXs -dt
/tmp/myXtemp-XaXb2tpGs

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XaXbXXcXXs -dt
mktemp: too few X's in template ‘myXtemp-XaXbXXcXXs’

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XaXbXXcXXs -dt

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XaXbXXXXt -dt
/tmp/myXtemp-XaXbe8PWt

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XXX-you-XXX -dt
/tmp/myXtemp-XXX-you-48l

waylonwalker.com on  main [!?]  v3.9.7 (waylonwalker.com)
❯ mktemp myXtemp-XXX-you-XX -dt
mktemp: too few X's in template ‘myXtemp-XXX-you-XX’

RTFM #

The man page has good stuff on all the flags that you might need.

man mktemp

Recover a lost git branch with checkout

2022-03-01T14:34:01Z

Once you give a branch the big D (git branch -D mybranch) its gone, its lost from your history. It’s completely removed from your log. There will be no reference to these commits, or will there?

TLDR #

Checkout is your savior, all you need is the commit hash.

Immediate Regret #

your terminal is still open

We have all done this, you give branch the big D only to realize it was the wrong one. Don’t worry, not all is lost, this is the easiest to recover from. When you run the delete command you will see something like this.

❯ git branch -D new
Deleted branch new (was bc02a64).

Notice the hash is right there is the hash of your commit. You can use that to get your content back.

git checkout -b bc02a64
git branch new

# or in one swoop checkout your new branch at the `start-point` you want
git checkout -b new bc02a64

Delayed reaction #

you have closed your terminal

If you have closed your terminal, or have deleted with a gui or something that does not tell you the hash as you run it, don’t fret, all your work is still there (as long as you have commited). You just have to dig it out. The reflog contains a list of all git operations that have occurred on your git repo, and can be incredibly helpful with this.

Kinda Recent #

If your botched delete operation was recent just diving right into the reflog will show it.

❯ git reflog
03a3338 (main) HEAD@{0}: checkout: moving from new to main
bc02a64 (HEAD -> another, new) HEAD@{4}: commit: newfile
03a3338 (main) HEAD@{2}: checkout: moving from main to new

In this example, I checked out a branch called new, commited a new file, then switched back to main and deleted new.

Now That I have the commit hash I can use the same solution to get my branch back.

git checkout -b bc02a64
git branch new

# or in one swoop checkout your new branch at the `start-point` you want
git checkout -b new bc02a64

A lot has happened since then #

If a lot has happened since then, you are going to need to pull out some more tool to sift through that reflog, especially if its a big one. The first suggestion that I have is to pipe into grep and look for commit messages, or the name of the branch.

❯ git reflog | grep "moving from"
03a3338 HEAD@{1}: checkout: moving from main to branch/oops
03a3338 HEAD@{2}: checkout: moving from oops to main
03a3338 HEAD@{4}: checkout: moving from main to oops
03a3338 HEAD@{5}: checkout: moving from another to main
bc02a64 HEAD@{6}: checkout: moving from main to another
03a3338 HEAD@{7}: checkout: moving from another to main
bc02a64 HEAD@{8}: checkout: moving from new to another
bc02a64 HEAD@{9}: checkout: moving from bc02a64bbe5683d905e333e8dfcbbb91a5e77549 to new
bc02a64 HEAD@{10}: checkout: moving from main to bc02a64bbe56
03a3338 HEAD@{11}: checkout: moving from new to main
03a3338 HEAD@{13}: checkout: moving from main to new
03a3338 HEAD@{14}: checkout: moving from other to main
03a3338 HEAD@{18}: checkout: moving from main to other

git has a built in --grep flag, but I don’t think there is a way to filter by branch name, regardless it still is helpful.

❯ git reflog --grep new
bc02a64 (HEAD -> another, new) HEAD@{4}: commit: newfile

Maybe if you can remember a filename you can pass in -- <filename>.

git reflog -- readme.md

RTFM #

There are many other ways to slice up a git log, and reflog alike. check out man git log for some more flags.

Textual Popup Hack

2022-02-26T15:41:12Z

As I am toying around with textual, I am wanting some popup user input to take over. Textual is still pretty new and likely to change quite significantly, so I don’t want to overdo the work I put into it, So for now on my personal tuis I am going to shell out to tmux.

The Problem #

The main issue is that when you are in a textual app, it kinda owns the input. So if you try to run another python function that calls for input it just cant get there. There is a textual-inputs library that covers this, and it might work really well for some use cases, but many of my use cases have been for things that are pre-built like copier, and I am trying to throw something together quick.

textual is still very beta

Part of this comes down to the fact that textual is still very beta and likely to change a lot, so all of the work I have done with it is for quick and dirty, or fun side projects.

The Solution #

So the solution that was easiest for me… shell out to a tmux popup. The application I am working on wants to create new documents using copier templates. copier has a fantastic cli that walks throught he template variables and asks the user to fill them in, so I just shell out to that with Popen. Make sure that you wait for this process to finish otherwise there will be bit of jank in your textual app.

async def action_new_post(self) -> None:
    proc = subprocess.Popen(
        'tmux popup "copier copy plugins/todo-template tasks"', shell=True
    )
    proc.wait()

example #

Here is what the running todo application looks like with the copier popup over it.

tmux popups

a bit more on tmux-popus [here] https://waylonwalker.com/tmux-popups/)

Links #

Git rebase to the beginning of time

2022-02-23T15:57:37Z

Git has a built in way to rebase all the way back to the beginning of time. There is no need to scroll through the log to find the first hash, or find the total number of commits. Just use --root.

git rebase --root

Revive files from the dead with git

2022-02-21T15:44:02Z

Git reflog can perform some serious magic in reviving your hard work from the dead if you happen to loose it.

caveat #

You must git commit! If you never commit the file, git cannot help you. You might look into your trashcan, filesystem versions, onedrive, box, dropbox. If you have none of this, then you are probably hosed.

practice #

I really like to practice these techniques before I need to use them so that I understand how they work in a low stakes fashion. This helps me understand what I can and cannot do, and how to do it in a place that does not matter in any way at all.

This is what I did to revive a dropped docker-compose.yml file. The idea is that if I can find the commit hash, I can cherry-pick it.

git init
touch readme.md
git add readme.md
git commit -m "add readme"
touch docker-compose.yml
git add docker-compose.yml
git commit -m "add docker-compose"
git reset 3cfc --hard
git reflog
# copy the hash of the commit with my docker-compose commit
git cherry-pick fd74df3

reflog #

Here was the final reflog that shows all of my git actions. note I did reset twice.

❯ git reflog --name-only
0404b6a (HEAD -> main) HEAD@{0}: cherry-pick: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{1}: reset: moving to 3cfc
readme.md
9175695 HEAD@{2}: cherry-pick: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{3}: reset: moving to 3cfc
readme.md
fd74df3 HEAD@{4}: commit: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{5}: reset: moving to HEAD
readme.md
3cfcab9 HEAD@{6}: commit (initial): add readme
readme.md

Git reflog is an alias for git log -g

2022-02-19T15:02:52Z

Right inside the git docs, is states that the git reflog command runs git reflog show by default which is an alias for git log -g --abbrev-commit --pretty=oneline

This epiphany deepens my understanding of git, and lets me understand that most git log flags might also work with git log -g.

full or short format #

Here are some git commands for you to try out on your own that are all pretty similar, but vary in how much information they show.

# These show only first line of the commit message subject, the hash, and index
git reflog
git log -g --abbrev-commit --pretty=oneline

# similar to git log, this is a fully featured log with author, date, and full
# commit message
git log -g

add files #

If I am looking for a missing file, I might want to leverage --name-only or --stat, to see where I might have hard reset that file, or deleted it.

git reflog --stat
git log -g --stat --abbrev-commit --pretty=oneline

git reflog --name-only
git log -g --name-only --abbrev-commit --pretty=oneline

example #

Here is an example where I lost my docker-compose.yml file in a git reset, and got it back by finding the commit hash with git reflog and cherry picked it back.

❯ git reflog --name-only
0404b6a (HEAD -> main) HEAD@{0}: cherry-pick: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{1}: reset: moving to 3cfc
readme.md
9175695 HEAD@{2}: cherry-pick: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{3}: reset: moving to 3cfc
readme.md
fd74df3 HEAD@{4}: commit: add docker-compose
docker-compose.yml
3cfcab9 HEAD@{5}: reset: moving to HEAD
readme.md
3cfcab9 HEAD@{6}: commit (initial): add readme
readme.md

This just proves that its harder to remove something from git, than it is to get it back. It can feel impossible to get something back, but once its in, it feels even more impossible to get it out.

View AWS event bridge rules with visidata

2022-02-15T03:04:26Z

Reading eventbridge rules from the command line can be a total drag, pipe it into visidata to make it a breeze.

I just love when I start thinking through how to parse a bunch of json at the command line, maybe building out my own custom cli, then the solution is as simple as piping it into visidata. Which is a fantastic tui application that had a ton of vim-like keybindings and data features.

alias awsevents = aws events list-rules | visidata -f json

Vim remaps use cmd in place of :

2022-02-14T14:53:17Z

Anyone just starting out their vim customization journey is bound to run into this error.

E5520: <Cmd> mapping must end with <CR>

I did not get it #

I’ll admit, in hindsight it’s very clear what this is trying to tell me, but for whatever reason I still did not understand it and I just used a : everywhere.

From the docs #

If you run :h <cmd> you will see a lot of reasons why you should do it, from performance, to hygene, to ergonomics. You will also see another clear statement about how to use <cmd>.

                                                          E5520
  <Cmd> commands must terminate, that is, they must be followed by <CR> in the
  {rhs} of the mapping definition.  Command-line mode is never entered.

When to map with a : #

You still need to map your remaps with a : if you do not close it with a <cr>. This might be something like prefilling a command with a search term.

nnoremap <leader><leader>f :s/search/

Otherwise use #

If you can close the <cmd> with a <cr> the command do so. Your map will automatically be silent, more ergonomic, performant, and all that good stuff.

nnoremap <leader><leader>f <cmd>s/search/Search/g<cr>

A better copy-mode bind for Tmux

2022-02-13T17:05:23Z

The default keybinding for copy-mode <prefix>-[ is one that is just so awkward for me to hit that I end up not using it at all. I was on a call with my buddy Nic this week and saw him just fluidly jump into copy-mode in an effortless fashion, so I had to ask him for his keybinding and it just made sense. Enter, that’s it. So I have addedt his to my ~/.tmux.conf along with one for alt-enter and have found myself using it way more so far.

Setting copy-mode to enter #

To do this I just popped open my ~/.tmux.conf and added the following. Now I can get to copy-mode with <prefix>-Enter which is control-b Enter, or alt-enter.

bind Enter copy-mode
bind -n M-Enter copy-mode

More on copy-mode #

I have a full video on copy-mode you can find here.

tmux copy-mode

ag silver searcher look ahead and look behind

2022-02-08T13:54:08Z

A super useful tool when doing PR’s or checking your own work during a big refactor is the silver searcher. Its a super fast command line based searching tool. You just run ag "<search term>" to search for your search term. This will list out every line of every file in any directory under your current working directory that contains a match.

Ahead/Behind #

It’s often useful to need some extra context around the change. I recently reviewed a bunch of PR’s that moved schema from save_args to the root of the dataset in all yaml configs. To ensure they all made it to the top level DataSet configuraion, and not underneath save_args. I can do a search for all the schemas, and ensure that none of them are under save_args anymore.

ag "schema: " -A 12 -B 12

Neovim Config for Git

2022-02-04T14:23:57Z

Creating a minimal config specifically for git commits has made running git commit much more pleasant. It starts up Much faster, and has all of the parts of my config that I use while making a git commit. The one thing that I often use is autocomplete, for things coming from elsewhere in the tmux session. For this cmpe-tmux specifically is super helpful.

The other thing that is engrained into my muscle memory is jj for escape. For that I went agead and added my settings and keymap with no noticable performance hit.

Here is the config that has taken

~/.config/nvim/init-git.vim

source ~/.config/nvim/settings.vim
source ~/.config/nvim/keymap.vim
source ~/.config/nvim/git-plugins.vim
lua require'waylonwalker.cmp'

~/.config/nvim/git-plugins.vim

call plug#begin('~/.local/share/nvim/plugged')

" cmp
Plug 'hrsh7th/nvim-cmp'
Plug 'hrsh7th/cmp-nvim-lsp'
Plug 'hrsh7th/cmp-buffer'
Plug 'hrsh7th/cmp-path'
Plug 'hrsh7th/cmp-calc'
Plug 'andersevenrud/compe-tmux', { 'branch': 'cmp' }


call plug#end()

~/.gitconfig

[core]
    editor = nvim -u ~/.config/nvim/init-git.vim

How to Properly Simulate Stow

2022-01-30T20:28:17Z

stow -R --simulate -vvv git

Squoosh cli

2022-01-29T04:54:50Z

Today I discovered a sweet new cli for compressing images. squoosh cli is a wasm powered cli that supports a bunch of formats that I would want to convert my website images to.

from the future

  > Unfortunately, due to a few people leaving the team, and staffing issues

resulting from the current economic climate (ugh), I’m deprecating the CLI and libsquoosh parts of Squoosh. The web app will continue to be supported and improved. I know that sucks, but there simply isn’t the time & people to work on this. If anyone from the community wants to fork it, you have my blessing.

https://github.com/GoogleChromeLabs/squoosh/pull/1321

Web App #

First the main feature of squoosh is a web app that makes your images smaller right in the browser, using the same wasm. It’s sweet! There is a really cool swiper to compare the output image with the original, and graphical dials to change your settings.

CLI #

What is even cooler is that once you have settings you are happy with and are really cutting down those kb’s on your images, there is a copy cli command button! If you have npx (which you should if you have nodejs and npm) already installed it just works without installing anything more.

Converting all of my png’s to webp #

I copied the command that it gave me for converting to webp, and set it up to run on all of my pngs.

npx @squoosh/cli --webp \
  '{"quality":75 \
    "target_size":0 \
    "target_PSNR":0 \
    "method":4 \
    "sns_strength":50 \
    "filter_strength":60 \
    "filter_sharpness":0 \
    "filter_type":1 \
    "partitions":0 \
    "segments":4 \
    "pass":1 \
    "show_compressed":0 \
    "preprocessing":0 \
    "autofilter":0 \
    "partition_limit":0 \
    "alpha_compression":1 \
    "alpha_filtering":1 \
    "alpha_quality":100 \
    "lossless":0 \
    "exact":0 \
    "image_hint":0 \
    "emulate_jpeg_size":0 \
    "thread_level":0 \
    "low_memory":0 \
    "near_lossless":100 \
    "use_delta_palette":0 \
    "use_sharp_yuv":0 \
    }' \
    static/*.png -d squoosh-webp

I opened my images repo and converted all pngs to webp using the command above. I got 94% compression on my existing pngs without resizing anything. This is dang impressive, and not too hard to do. I do want to refactor my images site at some point and include this as part of the ci system.

I also converted to avif, but it sent all my cpus to 100 for quite awhile, for only another 2MB total. Not sure if its worth it or not.

Tmux and Vim Clipboard for Ubuntu

2022-01-26T02:50:56Z

One of the first things I noticed broken in my terminal based workflow moving from Windows wsl to ubuntu was that my clipboard was all messed up and not working with my terminal apps. Luckily setting tmux and neovim to work with the system clipboard was much easier than it was on windows.

First off you need to get xclip if you don’t already have it provided by your distro. I found it in the apt repositories. I have used it between Ubuntu 18.04 and 21.10 and they all work flawlessly for me.

I have tmux setup to automatically copy any selection I make to the clipboard by setting the following in my ~/.tmux.conf. While I have neovim open I need to be in insert mode for this to pick up.

# ~/tmux.conf
bind -T copy-mode-vi Enter send-keys -X copy-pipe-and-cancel "xclip -i -f -selection primary | xclip -i -selection clipboard"
bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "xclip -selection clipboard -i"

To get my yanks to go to the system clipboard in neovim, I just added unnamedplus to my existing clipboard variable.

# ~/.config/nvim/init.vim
set clipboard+=unnamedplus

If you need to copy something right from the terminal you can use xclip directly. I do this semi-often to send someone a message in chat.

cat file.txt | clip -sel copy

I set up some alias’s for doing this a bit more efficiently, but don’t find myself using them very often. This helps me grab commands from history and copy them.

alias hclip="history | tail -n1 | cut -c 8- | xclip -sel clip"
alias fclip="history -n 1000 | fzf | cut -c 8- | xclip -sel clip"
alias fclip="history -n 1000 | fzf | xclip -sel clip"

nix rescues modded minecraft night

2022-01-25T03:07:39Z

With the latest version of minecraft it requires a very new, possibly the latest, version of java. Lately we have been getting into modded minecraft and I maintain the server for us. It’s been tricky to say the least. One hurdle I recently hit involves having the wrong version of java.

I was getting this error trying to get a 1.12.2 forge server running.

Caused by: java.lang.ClassCastException: class jdk.internal.loader.ClassLoaders$AppClassLoader cannot be cast to class java.net.URLClassLoader (jdk.internal.loader.ClassLoaders$AppClassLoader and java.net.URLClassLoader are in module java.base of loader ‘bootstrap’)

In researching our errors, I found this on a forum.

Pre-1.13 Forge only works with Java 8.

I don’t write java, or really know how to manage different versions of java, but I have nixpkgs installed and it has a ton of odd stuff like this readily available, so searching nixpkgs landed me with this.

nix-env -iA nixpkgs.jdk8

once I had this installed I then just changed out java for the full path to my new nixpkgs.jdk8 java and it worked.

/home/walkers/.nix-profile/bin/java -server -Xms${MIN_RAM} -Xmx${MAX_RAM} ${JAVA_PARAMETERS} -jar ${SERVER_JAR} nogui

I don’t write java or do anything other than host minecraft servers wtih it. There is probably a better way of maintaining java versions than this, but this worked for me.

Tmux hotkey for copier templates

2022-01-24T02:22:53Z

I have added a hotkey to my copier template setup to quickly access all my templates at any time from tmux. At any point I can hit <c-b><c-b>, thats holding control and hitting bb, and I will get a popup list of all of my templates directory names. Its an fzf list, which means that I can fuzzy search through it for the template I want, or arrow key to the one I want if I am feeling insane. I even setup it up so that the preview is a list of the files that come with the template in tree view.

bind-key c-b popup -E -w 80% -d '#{pane_current_path}' "\
    pipx run copier copy ~/.copier-templates/`ls ~/.copier-templates |\
    fzf --header $(pwd) --preview='tree ~/.copier-templates/{} |\
    lolcat'` . \
    "

I’ve had this on my systems for a few weeks now and I am constantly using it for my tils, blogs, and my .envrc file that goes into all of my projects to make sure that I have a virtual environment installed and running any time I open it.

Markata Filters as Telescope Pickers in Neovim

2022-01-23T04:52:20Z

I often pop into my blog from neovim with the intent to look at just a single series of posts, til, gratitude, or just see todays posts. Markata has a great way of mapping over posts and returning their path that is designe exactly for this use case.

To tie these into a Telescope picker you add the command as the find_command, and comma separate the words of the command, with no spaces. I did also --sort,date,--reverse in there so that the newest posts are closest to the cursor.

nnoremap geit <cmd>Telescope find_files find_command=markata,list,--map,path,--filter,date==today<cr>
nnoremap geil <cmd>Telescope find_files find_command=markata,list,--map,path,--filter,templateKey=='til',--sort,date,--reverse<cr>
nnoremap geig <cmd>Telescope find_files find_command=markata,list,--map,path,--filter,templateKey=='gratitude',--sort,date,--reverse<cr>

NOTE telescope treates each word as a string, do not wrap an extra layer of quotes around your words, it gets messy.

Copier Tasks | Python templating post run task

2022-01-22T04:49:12Z

Copier allows you to run post render tasks, just like cookiecutter. These are defined as a list of tasks in your copier.yml. They are simply shell commands to run.

The example I have below runs an update-gratitude bash script after the copier template has been rendered.

# copier.yml
num: 128
_answers_file: .gratitude-copier-answers.yml
_tasks:
  - "update-gratitude"

I have put the script in ~/.local/bin so that I know it’s always on my $PATH. It will reach back into the copier.yml and update the default number.

#!/bin/bash
# ~/.local/bin/update-gratitude
current=`awk '{print $2}' ~/.copier-templates/gratitude/copier.yml | head -n 1`
new=`expr $current + 1`
echo $current
echo $new
sed -i "s/$current/$new/g" ~/.copier-templates/gratitude/copier.yml

fuzzy wallpaper with fzf

2022-01-19T01:17:26Z

I really appreciate that in linux anything can be scripted, including setting the wallpaper. So everytime I disconnect a monitor I can just rerun my script and fix my wallpaper without digging deep into the ui and fussing through a bunch of settings.

feh --bg-scale ~/.config/awesome/wallpaper/my_wallpaper.png

I set my default wallpaper with feh using the command above.

Leaning in on feh, we can use fzf to pick a wallpaper from a directory full of wallpapers with very few keystrokes.

alias wallpaper='ls ~/.config/awesome/wallpaper | fzf --preview="feh --bg-scale ~/.config/awesome/wallpaper/{}" | xargs -I {} feh --bg-scale ~/.config/awesome/wallpaper/{}'

I have mine alias’d to wallpaper so that I can quickly run it from my terminal.

Converting markdown to pdf with pandoc on linux

2022-01-12T03:25:36Z

Converting markdown posts to pdf on ubuntu takes a few packages from the standard repos. I had to go through a few stack overflow posts, and nothing seemed to have all the fonts and packages that I needed to convert markdown, but this is what ended up working for me.

Installing all the packages #

sudo apt install \
  pandoc \
  texlive-latex-base \
  texlive-fonts-recommended \
  texlive-extra-utils \
  texlive-latex-extra \
  texlive-xetex

Using pandoc to convert markdown to a pdf #

# older versions of pandoc, I needed this one on ubuntu 18.04
pandoc pages/til/convert-markdown-pdf-linux.md -o convert-markdown-pdf.pdf --latex-engine=xelatex
# newer versions of pandoc, I needed this one on ubuntu 21.04
pandoc pages/til/convert-markdown-pdf-linux.md -o convert-markdown-pdf.pdf --pdf-engine=xelatex

Here is an image of what converting this article over to a pdf looks like. The raw markdown is here.

Installing Pipx on Ubuntu

2022-01-10T23:14:05Z

I recently paired up with another dev running windows with Ubuntu running in wsl, and we had a bit of a stuggle to get our project off the ground because they were missing com system dependencies to get going.

Straight in the terminal #

Open up a terminal and get your required system dependencies using the apt package manager and the standard ubuntu repos.

sudo apt update
sudo apt upgrade
sudo apt install \
      python3-dev \
      python3-pip \
      python3-venv \
      python3-virtualenv
pip install pipx

Using an Ansible-Playbook #

I like running things like this through an ansible-playbook as it give me some extra control and repeatability next time I have a new machine to setup.

- hosts: localhost
  gather_facts: true
  become: true
  become_user: "{{ lookup('env', 'USER') }}"

  pre_tasks:
    - name: update repositories
      apt: update_cache=yes
      become_user: root
      changed_when: False
  vars:
    user: "{{ ansible_user_id }}"
  tasks:
    - name: Install System Packages 1 (terminal)
      become_user: root
      apt:
        name:
          - build-essential
          - python3-dev
          - python3-pip
          - python3-venv
          - python3-virtualenv
    - name: check is pipx installed
      shell: command -v pipx
      register: pipx_exists
      ignore_errors: yes

    - name: pipx
      when: pipx_exists is failed
      pip:
        name: pipx
      tags:
        - pipx

video clip #

Here is a clip of me getting pipx running on ubuntu 21.10, and running a few of my favorite pipx commands.

installation video

2 minutes to stow

2022-01-09T00:33:58Z

Stow is an incredible way to manage your dotfiles. It works by managing symlinks between your dotfiles directory and the rest of the system. You can then make your dotfiles directory a git repo and have it version controlled. In my honest opinion, when I was trying to get started the docs straight into deep detail of things I frankly don’t really care about and jumped right over how to use it.

When using stow its easiest to keep your dotfiles directory (you may name it what you want) in your home directory, with application directories inside of it.

Then each application directory should reflet the same diretory structure as you want in your home directory.

zsh #

Here is a simple example with my zshrc.

mkdir ~/dotfiles
cd ~/dotfiles
mkdir zsh
mv ~/.zshrc zsh
stow --simulate zsh

You can pass in the –simulate if you wish, it will tell you if there are going to be any more errors or not, but it wont give much more than that.

WARNING: in simulation mode so not modifying filesystem.

Once your ready you can stow your zsh application.

stow zsh

nvim #

A slightly more complicated example is neovim since its diretory structure does not put configuration files directly in your home directory, but rather at a deeper level.

mkdir ~/dotfiles/nvim/.config/nvim/ -p
cd ~/dotfiles
mv ~/.config/nvim/ ~/dotfiles/nvim/.config/nvim/
stow zsh

!notice how the nvim directory inside of dotfiles is structured like it would be in your $HOME directory.

Using Copier Answers to rerun templates quickly

2022-01-08T01:16:52Z

The copier answers file is a key component to making your templates re-runnable. Let’s look at the example for my setup.py.

❯ tree ~/.copier-templates/setup.py
/home/walkers/.copier-templates/setup.py
├── [[ _copier_conf.answers_file ]].tmpl
├── copier.yml
├── setup.cfg
└── setup.py.tmpl

0 directories, 4 files

Inside of my [[ _copier_conf.answers_file ]].tmpl file is this, a message not to muck around with it, and the ansers in yaml form. The first line is just a helper for the blog post.

# ~/.copier-templates/setup.py/\[\[\ _copier_conf.answers_file\ \]\].tmpl
# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
[[_copier_answers|to_nice_yaml]]

Inside my copier.yml I have setup my _answers_file to point to a special file. This is because this is not a whole projet template, but one just for a single file.

# copier.yml
# ...
_answers_file: .setup-py-copier-answers.yml

Once I change the _answers_file I was incredibly stuck

Run it #

I’m making a library of personal copier templates in my ~/.copier-templates directory and I am going to run it from there.

copier copy ~/.copier-templates/setup.py

Results #

After rendering the template we have the following content in our .setup.setup-py-copier-answers.yml file. This will allow us to update quick if we ever change our template.

# .setup-py-copier-answers.yml
# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
_src_path: /home/walkers/.copier-templates/setup.py
author_github: waylonwalker
author_name: Waylon Walker
description: awesomeness
framework: null
keywords: null
package_name: my-package

Update it #

This is where I was most stuck, primarily becuase -a <answers_file> must come exactly after the base command copier. This felt a bit odd to and not where I expected it so it.

copier -a .setup-py-copier-answers.yml update

Stop asking all these damn questions #

So the defaults are now changed to our previous results, but it keeps asking for them. To stop asking we can simply add a -f flag.

copier -fa .setup-py-copier-answers.yml update

Making a Textual Widget from a Rich Renderable

2022-01-07T03:25:36Z

Once you have made your sick looking cli apps with rich, eventually you are going to want to add some keybindings to them. Currently Textual, also written by @willmcgugan, does this extremely well. Fair Warning it is in super beta mode and expected to change a bunch. So take it easy with hopping on the train so fast.

Get the things #

Install them from the command line.

pip install textual
pip install rich

Import make a .py file and import them in it.

from textual.app import App
from textual.widget import Widget
from rich.panel import Panel

If you return your rich renderable out of class that inherits from textual.widget.Widget, you can then dock this inside of an app class inheriting from textual.app.App.

class MyWidget(Widget):
    def render(self):
        my_renderable = Panel("press q to quit")
        return my_renderable

class MyApp(App):
    async def on_mount(self) -> None:
        await self.view.dock(MyWidget(), edge="top")
        await self.bind("q", "quit")

run it #

You’ve made a TUI (text user interface). Run the classmethod run to display the it in its full screen glory.

MyApp.run(log="textual.log")

Final result #

At this point It probably does not look much different, but it can be interactive by binding keys to any method on your app that starts with the word action_, this includes the built-in actions such as action_quit.

from textual.app import App
from textual.widget import Widget
from rich.panel import Panel


class MyWidget(Widget):
    def render(self):
        my_renderable = Panel("press q to quit")
        return my_renderable


class MyApp(App):
    async def on_mount(self) -> None:
        await self.view.dock(MyWidget(), edge="top")
        await self.bind("q", "quit")


if __name__ == "__main__":
    MyApp.run(log="textual.log")

pipx examples

2022-01-07T03:04:57Z

count lines of code #

pipx run pygount markata
pipx run pygount markata --format=summary
pipx run pygount markata --suffix=cfg,py,yml

Tmux Pop size

2022-01-05T17:37:26Z

tmux popups can be sized how you like based on the % width of the terminal on creation by using the flags (h, w, x, y) for height, width, and position.

# normal popup
tmux popup figlet "Hello"
# fullscreen popup
tmux popup -h 100% -w 100% figlet "Hello"
# 75% centered popup
tmux popup -h 100% -w 75% figlet "Hello"
# 75% popup on left side
tmux popup -h 100% -w 75% -x 0% figlet "Hello"

Sorry, your browser doesn't support embedded videos.

example running these commands

Copier Templates

2022-01-05T01:54:07Z

%%include til/copier_endops

%%include til/copier-template-variables

%%include til/copier-answers

Changing copier template strings (_endops)

2022-01-04T10:55:12Z

I was completely stuck for awhile. copier was not replacing my template variables. I found out that adding all these _endops fixed it. Now It will support all of these types of variable wrappers

# copier.yml
_templates_suffix: .jinja
_envops:
  block_end_string: "%}"
  block_start_string: "{%"
  comment_end_string: "#}"
  comment_start_string: "{#"
  keep_trailing_newline: true
  variable_end_string: "}}"
  variable_start_string: "{{"

!RTFM: Later I read the docs and realized that copier defaults to using [[ and ]] for its templates unlike other tools like cookiecutter.

copier template variables

2022-01-03T12:37:32Z

I’ve been looking for a templating tool for awhile that works well with single files. My go to templating tool cookiecutter does not work for single files, it needs to put files into a directory underneath of it.

template variables #

By default copier uses double square brackets for its variables. variables in files, directory_names, or file_names will be substituted for their value once you render them.

# hello-py/hello.py.tmpl
print('hello-[[name]]')

note! by default copier will not inject variables into your template-strings unless you use a .tmpl suffix.

Before running copier we need to tell copier what variables to ask for, we do this with a copier.yml file.

# copier.yml
name:
  default: my_name
  type: str
  help: What is your name

installing copier #

I prefer to install cli tools that I need globally with pipx, this always gives me access to the tool without worrying about dependency conflicts, bloating my system site-packages, or managing a separate virtual environment for it myself.

pipx install copier

running copier #

When running copier copy we pass in the directory of the template, and the directory that we want to render the template into.

copier copy hello-py .

note! the directory ‘.’ is often referred to in cli programs to represent the current working directory that we are calling the command from.

results #

The resulting files will have your variables injected into them if you have setup your template and copier.yml up correctly.

print('hello-you')

List all the files containing a phrase

2021-12-31T20:24:48Z

One of the most useful skills you can acquire to make you faster at almost any job that uses a computer is getting good at finding text in your current working diretory and identifying the files that its in. I often use the silver searcher ag or ripgrep rg to find files in large directories quickly. Both have a sane set of defaults that ignore hidden and gitignored files, but getting them to list only the filenames and not the matched was not trivial to me.

I’ve searched throught he help/man pages many times looking for these flags and they always seem to evade me.

ag #

Passing the flag -l to ag will get it to list only the filepath, and not the match. Here I gave it a --md as well to only return markdown filetypes. ag supports a number of filetypes in a very similar way.

ag nvim --md -l

rg #

Giving rg the --files-with-matches flag will yield you a similar set of results, giving only the filepaths themselves and not the match statement. Also passing in the -g "*.md" will similarly yield only results from markdown files.

rg --files-with-matches you -g "*.md"

My first impressions with pyenv

2021-12-30T15:26:01Z

pyenv provides an easy way to install almost any version of python from a large list of distributions. I have simply been using the version of python from the os package manager for awhile, but recently I bumped my home system to Ubuntu 21.10 impish, and it is only 3.9+ while the libraries I needed were only compatable with up to 3.8.

I needed to install an older version of python on ubuntu

I’ve been wanting to check out pyenv for awhile now, but without a burning need to do so.

installing #

Based on the Readme it looked like I needed to install using homebrew,so this is what I did, but I later realized that there is a pyenv-installer repo that may have saved me this need.

Installing Homebrew on Linux

List out install candidates #

You can list all of the available versions to install with pyenv install --list. It does reccomend updating pyenv if you suspect that it is missing one. At the time of writing this comes out to 532 different versions!

pyenv install --list

Let’s install the latest 3.8 patch #

Installing a version is as easy as pyenv install 3.8.12. This will install it, but not make it active anywhere.

pyenv install 3.8.12

let’s use python 3.8.12 while in this directory #

Running pyenv local will set the version of python that we wish to use while in this directory and any directory underneath of it while using the pyenv command.

pyenv local python3.8.12

.python-version file #

This creates a .python-version files in the directory I ran it in, that contains simply the version number.

3.8.12

using with pipx #

I immediately ran into the same issue I was having before when trying to run pipx, as pipx was running my system python. I had to install pipx in the python3.8 environment to get it to use it.

pyenv exec pip install pipx
pyenv exec pipx run kedro new

python is still the system python #

When I open a terminal and call python its still my system python that I installed and set with update-alternatives. I am not sure if this is expected or based on how I had installed the system python previously, but it’s what happened on my system.

update-alternatives --query python

Name: python
Link: /home/walkers/.local/bin/python
Status: auto
Best: /usr/bin/python3
Value: /usr/bin/python3

making a virtual environment #

To make a virtual environment, I simply ran pyenv exec python in place of where I would normally run python and it worked for me. There is a whole package to get pyenv and venv to play nicely together, so I suspect that there is more to it, but this worked well for me and I was happy.

pyenv exec python -m venv .venv --prompt $(basename $PWD)

Now when my virtual environment is active it points to the python in that virtual environment, and is the version of python that was used to create the environment.

Links #

https://github.com/pyenv/pyenv#installation

Installing Homebrew on Linux

2021-12-29T20:24:48Z

Installing brew on linux proved quite easy and got pyenv running for me within 4 commands.

I had never used homebrew before, honestly I thought it was a mac only thing for years. Today I wanted to try out pyenv, and the reccommended way to install was using homebrew. I am not yet sure if I want either in my normal workflow, so for now I am just going to pop open a new terminal and install homebrew and see how it goes.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> /home/walkers/.zprofile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

That was it, now homebrew is working. Starting a new shell and running the command to install pyenv worked.

brew install pyenv

Links #

homebrew

Serve html from your command line

2021-12-28T20:24:48Z

When I first moved to vim from and ide like vscode or sublime text one of my very first issues was trying to preview my website at localhost:8000. There had always just been a button there to do it in all of my other editors, not vim. There are not many buttons for anything in vim. While there is probably a plugin that can run a webserver for me in vim, it’s not necessary, we just need the command line we are already in.

running a separate process #

You will need a way to run another process alongside vim, here are a couple ideas to get you going that are not the focus here.style

use background jobs
- c-z to send a job to the background
- fg to bring it back
use a second terminal
use a second tab
use tmux and run it in a separate split/window
use an embeded nvim terminal

running a development webserver from the command line #

Python already exists on most linux systems by default, and most are now on python3. If you are on windows typing python will take you directly to the windows store to install it, or you can also use wsl.

# python3
python -m http.server

# running on port 5000
python -m http.server --directory markout 5000

# for the low chance you are on python2
python -m SimpleHTTPServer

# running on port 5000
python -m SimpleHTTPServer 5000
python -m SimpleHTTPServer --directory markout 5000

using nodejs #

If you are a web developer it’s likely that you need nodejs and npm on your system anyways and may want to use one of the servers from npm. I’ll admit with these not being tied to the long term support of a language they are much more feature rich with things like compression out of the box. In my opinion they are nice things that you would want out of a production server, but may not be necessary for development.

installing npx #

# if you don't alredy have npx
npm i -g npx

npx is a handy tool that lets you run command line applications straight from npm without installing them. It pulls the latest version every time you want to run, then executes it without it being installed.

running the http-server with npx #

npx http-server

# running on port 5000
npx http-server -p 5000
npx http-server markout -p 5000

Code Review from the comfort of vim | Diffurcate

2021-12-04T11:34:47Z

I often review Pull requests from the browser as it just makes it so easy to see the diffs and navigate through them, but there comes a time when the diffs get really big and hard to follow. That’s when its time to bring in the comforts of vim.

https://youtu.be/5NKaZFavM0E

Plugins needed #

This all stems from the great plugin by AndrewRadev. It breaks a down into a project. So rather than poping into a pager from git diff, you can pipe to diffurcate and it will setup a project in a tmp directory for you and you can browse this project just like any other except it’s just a diff.

Plug 'AndrewRadev/diffurcate.vim'

My aliases #

First to quickly checkout PR’s from azure devops I have setup an alias to fuzzy select a pr and let the az command do the checkout.

alias azcheckout='az repos pr checkout --id $(az repos pr list --output table | tail -n -2 | fzf | cut -d " " -f1)'

Next I have a few aliases setup for checking diffs. The first one checks what is staged vs the current branch, the others check the current branch vs main or master.

alias diffstaged="git diff --staged | nvim - +Diffurcate '+Telescope find_files'"
alias diffmain="git diff main.. | nvim - +Diffurcate '+Telescope find_files'"
alias diffmaster="git diff master.. | nvim - +Diffurcate '+Telescope find_files'"

diffcommit() {
    git diff $1 | nvim - +Diffurcate '+Telescope find_files'
}

Links #

diffurcte.vim

Open files FAST from zsh | or bash if thats your thing

2021-12-02T11:34:47Z

https://youtu.be/PQw_is7rQSw

I am often in a set of tmux splits flying back and forth, accidentally close my editor, so when I come back to that split and hit my keybinds to edit files I enter them into zsh rather than into nvim like I intended. Today I am going to sand off that rough edge and get as similar behavior to nvim as I can with a couple of aliases.

Make sure you check out the YouTube video to see all of my improvements.

what’s an alias #

If you have never heard of an alias before it’s essentially a shortcut to a given command. You can pass additional flags to the underlying command and they will get passed in. Most of the time they are just shorter versions of commands that you run often or even like in this case a common muscle memory typo that occurs for you.

My new alias’s for fuzzy editing files from zsh #

Here are the new aliases that I came up with to smooth out my workflow. These give me a similar feel to how these keys work in neovim but from zsh.

# fuzzy select file to edit
alias p='nvim `fzf --preview="bat --color always {}"`'

# give me the same syntax as edit while in neovim
alias :e='nvim '

Follow the YouTube channel or the rss feed to stay up to date.

playlist for my dotfiles challenge

30 days dotfile ricing

2021-11-29T11:34:47Z

https://youtu.be/Jq1Y48F_rOU

I am challenging myself to 30 days of dotfile ricing. I have been on linux desktop for a few months now and have a pretty good workflow going, I have the coarse edits done to my workflow, but it has some rough edges that need sanded down. It’s time to squash some of those little annoyances that still exist in my setup.

This is primarily going to be focused on productivity, but may have a few things to just look better. This will comprise heavily of aliases, zsh, and nvim config.

Follow the YouTube channel or the rss feed to stay up to date.

Uses

2021-11-20T10:38:00Z

This is a listing of all the things that I use on a daily basis to build data pipelines, lead my team, and build this website.

older editions #

[[ uses-2021 ]]

Installation #

Everything installed on my machines is done through ansible-playbooks. It’s been a long transformation to get here, but its so satisfying to boot a brand new system, run a single command a have every single thing cofigured exactly to my liking.

# GET is available by default on Ubuntu
GET waylonwalker.com/bootstrap | bash

# For debian based systems without GET by default
sudo apt install curl
curl -F https://waylonwalker.com/bootstrap | bash

OS #

I run Ubuntu, it works well for me without too much fuss. For me the distribution does not really matter too much, I’m more interested in what’s inside.

Window Manager #

I use awesome wm. Awesome is a tiling window manager that alows me to navigate through 9 workspaces (technically called tags in awesomewm). I can script out certain applications to open in a certain tag, move it to different tags, and join tags super easy. I really dont see myself going back to a floating window manager where you have to place all your windows with the mouse by hand. This is probably one of the biggest selling points for me to move to a Linux desktop.

Terminal #

gnome-terminal #

For the longest time I just used gnome-terminal. It works, for the most part it gets out of the way and lets me do what I want. I just want a terminal that runs tmux properly, runs without titltbars or scrollbars, and lets me theme it without much effort.

kitty #

Kitty is my main terminal, these days, it’s nice, its easy to configure how I want it, but most of its fancier features do not work inside of tmux. It does render incredibly fast, If I accidently cat out a massive file, it typically just handles it, compared to other terminals that will be printing for 30s or so.

Windows Terminal #

When I am on a windows terminal I use the new Terminal. It’s a massive improvement over any other terminal that I have ever tired on windows. Text looks good, the built in themese look good, I use the One-Half-Dark Theme, and the built in Cascadia Code font. Also things like system clipboards, copy, and paste just seem to work better, and integrate well with wsl.

Shell #

The shell is the interpreter that interprets the commands that you send to it from the command line, unlike the terminal that displays the text.

zsh #

I use zsh as my shell of choice. I don’t run oh-my-zsh, I just need a few plugins for things like autosuggestions syntax-highlighting history-substring-search.

Tmux #

Text Editor #

Presentation / Slides #

Video Recording / Streaming #

Video Editing #

Image Editor #

Virtual Environments #

node #

Desk #

Monitor #

Keyboard #

Desktop PC #

Keyboard #

Microphone #

Audio Interface #

Headphones #

Chair #

Update Alternatives in Linux

2021-11-20T10:38:00Z

update-alternatives --query python

update-alternatives: error: no alternatives for python

sudo update-alternatives --install /usr/local/bin/python python `which python3.8` 2
# update-alternatives: using /usr/bin/python3.8 to provide /usr/local/bin/python (python) in auto mode

sudo update-alternatives --install /usr/local/bin/python python `which python2.7` 5
# update-alternatives: using /usr/bin/python2.7 to provide /usr/local/bin/python (python) in auto mode

update-alternatives --query python
# Name: python
# Link: /usr/local/bin/python
# Status: auto
# Best: /usr/bin/python2.7
# Value: /usr/bin/python2.7
#
# Alternative: /usr/bin/python2.7
# Priority: 5
#
# Alternative: /usr/bin/python3.8
# Priority: 2

sudo update-alternatives --install /usr/local/bin/python python `which python3.8` 20
# update-alternatives: using /usr/bin/python3.8 to provide /usr/local/bin/python (python) in auto mode

JUT | Read Notebooks in the Terminal

2021-11-20T10:38:00Z

Trying to read a .ipynb file without starting a jupyter server? jut has you covered.

https://youtu.be/t8AvImnwor0

watch the video version of this post on YouTube

57676ca9-23dd-4b3d-a084-293a0525eba5.mkv

Or watch the full thing here

install #

jut is packaged and available on pypi so installing is as easy as pip installing it.

pip install jut

installing jut with pip

! This is my first time including snippets of the video in the article like this, let me know what you think!

examples #

jut https://cantera.org/examples/jupyter/thermo/flame_temperature.ipynb
jut https://cantera.org/examples/jupyter/thermo/flame_temperature.ipynb --head 3
jut https://cantera.org/examples/jupyter/thermo/flame_temperature.ipynb --tail 2

running jut examples

what are all the commands available for jut? #

Take a look at the help of the jut cli to explore all the options that it offers.

jut --help

There is some good information on the projects readme as well.

getting help with jut

without installing #

using pipx

Don’t want jut cluttering up your venv, or want to save yourself from making a new one, pipx can manage a separate virual environment for you. This is one of the biggest selling points for me.

pipx run jut https://cantera.org/examples/jupyter/thermo/flame_temperature.ipynb --head 3

running jut with pipx

nbconvert #

jut is the lightweight option that I think will fit the bill often for me, but it just doesn’t always cut it. Mostly if there are images in the notebook or large output that is hard to read, its time to pull out the medium guns that sit between fulling running jupyter and jut.

pip install nbconvert

nbconvert does not have its own cli, instead it sits under the jupyter command.

html">converting to html #

Need to see images, go here!

wget https://cantera.org/examples/jupyter/thermo/flame_temperature.ipynb
jupyter nbconvert flame_temperature.ipynb --to html
python -m http.server

Note, nb convert does not work with a url, you will need to have the notebook locally.

nbconvert to html to see images

what other options does nbconvert offer? #

nbconvert also offers a standard help flag that you can access by passing in the --help flag

jupyter nbconvert --help

converting to markdown #

nbconvert also supports converting to many other formats, one option that is quite interesting for use in the terminal is markdown. We could simply convert the notebook to markdown and cat it out.

jupyter nbconvert flame_temperature.ipynb --to maarkdown
cat flameflame_temperature.md

nbconvert to markdown and displaying in bat

viewing markdown with glow #

Glow is a terminal markdown viewer that looks really good. These days I use bat as cat so I don’t get quite as much benefit from glow, but it still looks pretty good.

glow flameflame_temperature.md

nbconvert to markdown and displaying in glow

viewing markdown as slides with lookatme #

lookatme

Lookatme is my slideshow tool of choice. Creating slides in markdown is such a fantasic user experience, It realy lets you go from outline to finished slide deck fluidly. Refactoring the whole thing is also so much easier than with gui tools. Once you have your idea fleshed out it does make the process of making slides in powerpoint much easier if thats what you need.

On to nbconvert, without even changing the notebook we can look at the notebook as a slideshow in the terminal. The only thing that it needs is some markdown headers to start new slides from.

lookatme flameflame_temperature.md

nbconvert to markdown and displaying as slides with lookatme

viewing markdown with rich #

Bringing this full circle, lets take a look at the converted markdown with rich. Here you will notice a surprising similarity to what we saw with jut.

pip install rich
python -m rich.markdown flame_temperature.md

Rich still cannot pull directly from a url or display markdown with out being installed and managed by yourself. Unlike how jut can leverage pipx to manage the installation sandbox for you.

Links #

jut - View notebooks in the terminal
nbconvert - convert notebooks to other formats
flame-temperature notebook - The sample notebook I used
glow - Terminal Markdown viewer
lookatme - Terminal Markdown slideshow tool
pipx - Run python cli’s without maintianing a virtual environment
rich - Beautiful python terminal formatter

tmux targeted session

2021-08-02T23:51:21Z

https://youtu.be/5KE7Il7SOEk

This is something that I made up but use every single day, this is what keeps much of what is on my blog or my teams private work wiki going. I have a few very important directories that I have assigned directly to a hotkey for fast session switching.

bind -n M-i new-session -A -s waylonwalker_com "cd ~/git/waylonwalker.com/ && nvim"
bind i popup -E -h 95% -w 95% -x 100% "tmux new-session -A -s waylonwalker_com 'cd ~/git/waylonwalker.com/ && nvim'"
bind -n M-I popup -E "tmux new-session -A -s waylonwalker_com 'cd ~/git/waylonwalker.com/ && nvim'"

tmux new-session

This one is building off of yeserday’s new-session post, make sure you check that one out as well.

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux detach

2021-08-01T23:51:21Z

https://youtu.be/A1qx3tNKDdA

tmux detach is a handy tmux command that will quit your current session while keeping it running. The full name of the comamnd is detach-client, detach is a shorthand.

default keybinding

bind-key          d detach-client

I have mine bound to mod+d where mod is alt.

bind -n M-d detach-client

https://waylonwalker.com/tmux-nav-2021/

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

notify-send

2021-08-01T10:33:17Z

xinput float $(xinput list --id-only "AT Translated Set 2 keyboard") | notify-send "laptop keeb floated" -i ~/Pictures/8bitcc.png

tmux attach

2021-07-31T23:51:21Z

https://youtu.be/JQ0yDCVu44E

attach is one of the most useful features of tmux. If you have no interest in tmux for pane and window management, you should use tmux for this. It can be a life saver if you ever get disconnected from the host machine or accidently close your terminal you can connect right back into the session you were just in using attach.

attach #

tmux attach

this command will simply attach back to tmux if you are ever disconnected

If you ever run long running tasks on a remote machine by sshing into this you should be doing it inside tmux, or something like tmux so that you do not loose your work.

attach to a specific session #

If you have multiple sessions running you can select the session that you want to attach to by passing -t <name-of-session>.

tmux attach -t scratch

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux ls

2021-07-30T23:51:21Z

https://youtu.be/LY41GLn_DGg

tmux ls will list the sessions that you have running within the tmux server if tmux is currently running. This is handy to combine with commands such as attach.

tmux ls

tmux attach

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux command line

2021-07-29T23:51:21Z

https://youtu.be/SNu-4IrkjAs

So far we have covered a lot of tmux commands and how they map to keybindings but these same commands can be executed at the command line.

From the command line #

Let’s make a popup that displays our git status for 5s or until we close it manually. We can run the following command at the command line, in a split.

tmux display-popup -E -d '#{pane_current_path}' 'git status && sleep 5'

From the tmux command line #

Or we can open the tmux command line and run it from tmux’s built in command line, which is very similar to bim EX mode. By default the tmux command line can be opened with prefix+[.

display-popup -E -d '#{pane_current_path}' 'git status && sleep 5'

🗒️ note that the tmux command is called by default when inside of tmux.

Make it a keybinding #

Finally we can make it a keybinding by adding a bind command ahead of our tmux command, then we can execute this in the tmux command line or add it to our ~/.tmux.conf.

bind s display-popup -E -d '#{pane_current_path}' 'git status && sleep 5'

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux copy-mode

2021-07-28T23:51:21Z

https://youtu.be/-ypY_-VmBKk

tmux copy-mode is a tmux mode that lets you scroll, search, copy, and jump your way through a pane. There are a ton of keybindings for copy-mode, the main ones you will need to know are / for searching down ? for searching up, n for next item, space for starting a selection, and enter to copy the selection. Arrow keys will be used for navigation unless you have specified vi mode, then it will be hjkl.

Default keybinding to get into copy mode is prefix+[.

bind-key          [ copy-mode

If you are a vim user you will likely want to use vi style keys, add this to your ~/.tmux.conf file to enable vi mode.

setw -g mode-keys vi

full list of copy-mode keybindings from the man page.

  Command                                      vi              emacs
           append-selection
           append-selection-and-cancel                  A
           back-to-indentation                          ^               M-m
           begin-selection                              Space           C-Space
           bottom-line                                  L
           cancel                                       q               Escape
           clear-selection                              Escape          C-g
           copy-end-of-line [<prefix>]                  D               C-k
           copy-line [<prefix>]
           copy-pipe [<command>] [<prefix>]
           copy-pipe-no-clear [<command>] [<prefix>]
           copy-pipe-and-cancel [<command>] [<prefix>]
           copy-selection [<prefix>]
           copy-selection-no-clear [<prefix>]
           copy-selection-and-cancel [<prefix>]         Enter           M-w
           cursor-down                                  j               Down
           cursor-down-and-cancel
           cursor-left                                  h               Left
           cursor-right                                 l               Right
           cursor-up                                    k               Up
           end-of-line                                  $               C-e
           goto-line <line>                             :               g
           halfpage-down                                C-d             M-Down
           halfpage-down-and-cancel
           halfpage-up                                  C-u             M-Up
           history-bottom                               G               M->
           history-top                                  g               M-<
           jump-again                                   ;               ;
           jump-backward <to>                           F               F
           jump-forward <to>                            f               f
           jump-reverse                                 ,               ,
           jump-to-backward <to>                        T
           jump-to-forward <to>                         t
           jump-to-mark                                 M-x             M-x
           middle-line                                  M               M-r
           next-matching-bracket                        %               M-C-f
           next-paragraph                               }               M-}
           next-space                                   W
           next-space-end                               E
           next-word                                    w
           next-word-end                                e               M-f
           other-end                                    o
           page-down                                    C-f             PageDown
           page-down-and-cancel
           page-up                                      C-b             PageUp
           pipe [<command>] [<prefix>]
           pipe-no-clear [<command>] [<prefix>]
           pipe-and-cancel [<command>] [<prefix>]
           previous-matching-bracket                                    M-C-b
           previous-paragraph                           {               M-{
           previous-space                               B
           previous-word                                b               M-b
           rectangle-on
           rectangle-off
           rectangle-toggle                             v               R
           refresh-from-pane                            r               r
           scroll-down                                  C-e             C-Down
           scroll-down-and-cancel
           scroll-up                                    C-y             C-Up
           search-again                                 n               n
           search-backward <for>                        ?
           search-backward-incremental <for>                            C-r
           search-backward-text <for>
           search-forward <for>                         /
           search-forward-incremental <for>                             C-s
           search-forward-text <for>
           search-reverse                               N               N
           select-line                                  V
           select-word
           set-mark                                     X               X
           start-of-line                                0               C-a
           stop-selection
           top-line                                     H               M-R

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux join-pane

2021-07-27T23:51:21Z

https://youtu.be/Vm5rRtcVXLw

Join-pane allows you to join panes that you have broken away from your window, or created in a different window to the window you want it in. As far as I know there is not a default keybinding for it.

Before you can join a pane you must first have a pane marked to join. Once you mark a pane, go back to the window you want to join it to and join-pane.

My keybindings, you must add this to your ~/.tmux.conf file to use them.

# Mark and swap panes
#――――――――――――――――――――――――――――――――――――――――――――
bind -n M-m select-pane -m # mark
bind -n M-M select-pane -M # unmark

bind -n M-< join-pane

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

Also check out the full YouTube tmux-playlist to see all of the videos in this series.

tmux break-pane

2021-07-26T23:51:21Z

https://youtu.be/ICL609F2xnc

Break-pane is a handy tmux command when your layout gets too cramped and you want to just move a split into its own window. Calling break-pane does exactly that, it creates a new-window for you and moves your currently selected split into that window

Default key binding for break-pane

bind-key          ! break-pane

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux zoom

2021-07-25T23:51:21Z

https://youtu.be/Rn6mOarCQ-Y

Zooming into the current split in tmux is a valuable tool to give yourself some screen real estate. These days I am almost always presenting, streaming, or pairing up with a co-worker over a video call. Since I am always sharing my screen I am generally zoomed in to a level that is just a bit uncomfortable, so anytime I make a split it is really uncomfortable, being able to zoom into the split I am focused on is a big help, and also help anyone watching follow where I am currently working.

Default key bindings for zooming the current split

bind-key          z resize-pane -Z

I have rebound this to match the default binding with mod+z rather so that I get that single keystroke experience.

bind -n M-z resize-pane -Z

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux new-window

2021-07-24T23:51:21Z

https://youtu.be/YRPZBv-iYyE

New window as it sounds makes new windows in tmux. Windows are kind of like tabs. They are another screen within your sessions that you can name and make new panes in.

Default key bindings for creating and navigating windows in tmux.

bind-key          c new-window
bind-key          p previous-window
bind-key          n next-window

As always I have rebound these keys because I generally prefer a single keystroke over the prefix plus keybinding approach that tmux gives by default.

#――windows――――――――――――――――――――――――――――――――――――――
bind -n M-c new-window -c '#{pane_current_path}'
bind -n M-p previous-window
bind -n M-n next-window

When I started using tmux I did almost everything in one giant session with many panes and windows. It became a nightmare to manage and quickly get between two sets work efficiently. This year I leaned in on sessions quite heavily. Checkout this 👇 post to see that workflow in depth.

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux slect-pane

2021-07-23T23:51:21Z

https://youtu.be/CPZJZjN9YTY

These are my MOST often used keybindings that I use in tmux. They allow me to jump between splits with ease with a vim style layout. I can hold mod and jump between panes with a familiar arrow key.

bind -n M-h select-pane -L
bind -n M-l select-pane -R
bind -n M-k select-pane -U
bind -n M-j select-pane -D

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux rotate-window

2021-07-22T23:51:21Z

https://youtu.be/06z5qf81ofo

Rotate window is the main way that I navigated tmux before I learned select-pane. It allows you to change your focused pane, or rotate the position of the panes easily.

Default keybindings

bind-key        C-o rotate-window
bind-key          o select-pane -t :.+

My keybindings look just a bit different than the default ones, I do not like needing to hit prefix for every command, especially for repeated commands. I set a similar keybinding to the default one that uses mod instead of prefix.

bind -n M-o select-pane -t :.+
bind -n M-O rotate-window

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux select-layout

2021-07-21T23:51:21Z

https://youtu.be/F0mHnwTrNNc

When you get many splits going in tmux sometimes its time for a new layout. There are four layout strategies that I use, main-vertical, main-horizontal, even-vertical, even-horizontal. Almost always I am useing the main ones with mod plus a or mod plus shift a keybindings.

# Select Layouts
#―――――――――――――――――
bind -n M-a select-layout main-vertical
bind -n M-A select-layout main-horizontal
bind -n M-E select-layout even-vertical
bind -n M-V select-layout even-horizontal

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux resize-panes

2021-07-20T23:51:21Z

https://youtu.be/hpFYE2LU7xc

Resizing panes in tmux can be quite difficult in default tmux, I use a set of keybingings to help resize panes in the rare occasions that I do need just a bit more space. I set the keybinding to the same as my split navigation bindings but shifted. They are very vim like (h,j,k,l).

# resize panes
#―――――――――――――――――――――――――――――
bind -n M-H resize-pane -L 2
bind -n M-L resize-pane -R 2
bind -n M-K resize-pane -U 2
bind -n M-J resize-pane -D 2

Most often when I need to resize panes I just grab the edge of the pane with my mouse. Yes the mouse, its not that often that I actually need to change the size of a pane.

# Enable mouse control (clickable windows, panes, resizable panes)
set -g mouse on

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux choose-tree

2021-07-19T23:51:21Z

https://youtu.be/79Y-kqAiMpw

Choose tree is a powerful tmux utility that provides a graphical interface to preview all sessions, windows, and panes, move between them kill them, move them and much more.

The default keybinding

bind-key -T prefix s choose-tree -s

my preferred keybinding to open sessions and windows collapsed and Zoomed in.

bind-key j choose-tree -swZ

From the man page.

choose-tree [-GNrswZ] [-F format] [-f filter] [-K key-format] [-O sort-order] [-t target-pane] [template]
        Put a pane into tree mode, where a session, window or pane may be chosen interactively from a tree.  Each session, window or pane is shown on
        one line.  A shortcut key is shown on the left in brackets allowing for immediate choice, or the tree may be navigated and an item chosen or
        otherwise manipulated using the keys below.  -s starts with sessions collapsed and -w with windows collapsed.  -Z zooms the pane.  The follow‐
        ing keys may be used in tree mode:

            Key    Function
            Enter  Choose selected item
            Up     Select previous item
            Down   Select next item
            +      Expand selected item
            -      Collapse selected item
            M-+    Expand all items
            M--    Collapse all items
            x      Kill selected item
            X      Kill tagged items
            <      Scroll list of previews left
            >      Scroll list of previews right

<!--markata-attribution-->
            C-s    Search by name

<!--markata-attribution-->
            m      Set the marked pane

<!--markata-attribution-->
            M      Clear the marked pane

<!--markata-attribution-->
            n      Repeat last search

<!--markata-attribution-->
            t      Toggle if item is tagged

<!--markata-attribution-->
            T      Tag no items

<!--markata-attribution-->
            C-t    Tag all items

<!--markata-attribution-->
            :      Run a command for each tagged item

<!--markata-attribution-->
            f      Enter a format to filter items

<!--markata-attribution-->
            H      Jump to the starting pane

<!--markata-attribution-->
            O      Change sort field

<!--markata-attribution-->
            r      Reverse sort order

<!--markata-attribution-->
            v      Toggle preview

<!--markata-attribution-->
            q      Exit mode

        After a session, window or pane is chosen, ‘%%’ is replaced by the target in template and the result executed as a command.  If template is
        not given, "switch-client -t '%%'" is used.

        -O specifies the initial sort field: one of ‘index’, ‘name’, or ‘time’.  -r reverses the sort order.  -f specifies an initial filter: the fil‐
        ter is a format - if it evaluates to zero, the item in the list is not shown, otherwise it is shown.  If a filter would lead to an empty list,
        it is ignored.  -F specifies the format for each item in the tree and -K a format for each shortcut key; both are evaluated once for each
        line.  -N starts without the preview.  -G includes all sessions in any session groups in the tree rather than only the first.  This command
        works only if at least one client is attached.

https://waylonwalker.com/tmux-nav-2021/

for more information on how I navigate tmux, check out this full post

tmux prefix

2021-07-18T23:51:21Z

https://youtu.be/BMkpbfhbkKM

The prefix key is an essential part of tmux, by default all of tmux’s key-bindings sit behind a prefix. This prefix is very similar to vim’s leader key. It is common for folks to change the default C-b (control b) to C-a or if they are a vim user something to match their vim leader key.

set -g prefix C-Space
bind Space send-prefix

A few of the essential default key-bindings.

%      vertical split
"      horizontal split
d      detach

up     select up one pane
down   select down one pane
right  select right one pane
left   select left one pane

t      clock
o      swap panes
c      create window
n      next window
p      previous window

A more complete list of key-bindings can be found in this gist https://gist.github.com/mzmonsour/8791835.

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux splitting panes

2021-07-17T23:51:21Z

https://youtu.be/kzgyiHap1nQ

splitting panes is a core feature of tmux. It allows us to split the terminal vertically or horizontally into new panes.

bind -n M-s split-window -c '#{pane_current_path}'
bind -n M-v split-window -h -c '#{pane_current_path}'
bind -n M-X kill-pane

🗒️ note that ‘#{pane_current_path}‘will keep the split in the same directory as it’s parent, without this it will default to your home directory.

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux last session

2021-07-16T23:51:21Z

https://youtu.be/RB87EEnnMnU

An ultimate productivity key-binding in tmux is one to switch to the last session. I use this to quickly get between sessions really quick. Often I am working and need to lookup a quick note, or copy something into my notes, then get back to where I was quickly.

bind -n M-b switch-client -l

I think of this hub and spoke model, and use last-session to quickly drive it.

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux floating popups

2021-07-15T23:51:21Z

https://youtu.be/2ZqFDsJywt8

Tmux popups are actually floating windows that you can drag around the screen. They always open in the middle (by default) when you open them, no matter where you leave them.

Here are a couple of keybindings I use to open up popup windows.

bind C-g display-popup -E "ta ~/git"
bind -n M-g display-popup -E "tmux new-session -A -s scratch"

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

tmux popups

2021-07-14T23:51:21Z

https://youtu.be/2I8fB28zfB4

Tmux-popups are a great feature that is relatively new to tmux, many repos such as the standard ubuntu repos do not have it. Popups came in 3.2a, if your package manager does not have it, you can follow the tmux’s install instructions to build from source.

# open a popup scratchpad
bind -n M-g display-popup -E "tmux new-session -A -s scratch"

How I navigate tmux in 2021

for more information on how I navigate tmux, check out this full post

I use popups quite a bit in my workflow to ssh into another machine for a short period, or make a new project with a template.

Copy and Paste on Linux

2021-06-25T20:50:45Z

These are the notes that I used as I set up my first ever ubuntu desktop.

gnome-tweaks #

sudo apt install gnome-tweaks

nordix gtk theme #

I ran this, but have no idea if it had any effect as the theme did not show up until I relogged.

gsettings set org.gnome.desktop.wm.preferences theme Nordic

What I think actuagnome terminal showing scrollbar in tmuxlly worked was

emoji support #

One thing that I really missed quite early from windows was the emoji virtual keyboard. I like being able to quickly toss in those emoji that give just a bit of a visual cue 🔥, ⚠️,, 🎉, 🦄, 💜.

installation #

I found an application called emote. that seems to do everything I need it to in the snap store. Installation is a typicall snap install.

sudo snap install emote

default keybinding #

The application came with a default keybinding ctrl+alt+e, but I could never remember it.

ctrl+alt+e

Windows keybinding #

Old habits are hard to break, I opened up the gnome settings and set a hotkey to super+; to run the command emote.

Super+;

How it works #

Get that dock outta here #

I tried to disable the dock and it didn’t immediately work for me, likely because I needed to relog. I really have no use for the dock though as I will always open applications with a hotkey or super + search.

sudo apt remove gnome-shell-extension-ubuntu-dock

Terminal One Dark Theme #

I don’t stress too hard on themes, I just want something halfway consistent and just works. I typically have just used a semi-popular theme “one-dark” everywhere. This was the default theme in GitHub’s Atom text editor that I never used. I only care that it looks good and is popular enought that it just exists everywhere.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/denysdovhan/gnome-terminal-one/master/one-dark.sh)"

I found these to be ugly ans unnecessary so I turned them off. You can access all the menu items by right clicking on the terminal anyways, so there is no reason to let it take up any screen real estate.

Hiding the scrollbar #

Hiding the menubar #

vim clipboard #

sudo apt install xsel

set clipboard+=unnamedplus

tmux clipboard #

# Copy and Paste on Linux
bind -T copy-mode-vi Enter send-keys -X copy-pipe-and-cancel "xclip -i -f -selection primary | xclip -i -selection clipboard"
set-option -s set-clipboard off
bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "xclip -selection clipboard -i"

Hotkeys #

Key	Desc
super+j	move to workspace below
super+k	move to workspace above
super+shift+j	move window one workspace down
super+shift+k	move window one workspace up

Key	Command	Desc
Super+e	nautilus	File Browser
Super+Shift+p	Area Screenshot	gnome-screenshot -a
Super+Alt+p	Area Screenshot to clipboard	gnome-screenshot -ac
Super+e	nautilus	File Browser

screenshots #

I am constantly taking screenshots for my daily workflow, on Windows I had it setup to both send to the clipboard and store in a screenshots directory.

# take a screenshot and Store it as a file.
gnome-screenshot -a

# take a screenshot and send it to the clipboard
gnome-screenshot -ac

obs #

As od Jun 2021 the version of obs-studio installed using the instructions in their wiki is out of date. I had success getting the latest version, which supports virtual webcams, using snap.

sudo snap install obs-studio

virtual webcam #

After getting the latest version of obs-studio whixh supports virtual webcam it still did not start. After some searching I found that updating v4l2loopback resolved the issue.

sudo apt purge v4l2loopback-dkms
git clone https://github.com/umlaeute/v4l2loopback.git ~/git/v4l2loopback/
cd ~/git/v4l2loopback/
make
sudo make install

sudo modprobe v4l2loopback devices=1 exclusive_caps=1

sudo depmod -a
sudo modprobe v4l2loopback video_nr=10 card_label="OBS Video Source" exclusive_caps=1

i3 #

I decided to give i3 a try, simply apt install it, then it shows up under the gear icon at the login screen after a reboot. At this point I don’t think I am ready for i3. I have just changed a bunch of stuff in my workflow and honestly I got a decent gnome config setup in like 10 minutes.

sudo apt install i3

How to use git cherry pick

2021-05-13T08:51:45Z

~/git via 🐍 v3.8.5
❯ mkdir git-cherry-pick-learn

~/git via 🐍 v3.8.5
❯ cd git-cherry-pick-learn

~/git/git-cherry-pick-learn
❯ git init
Initialized empty Git repository in /home/walkews/git/git-cherry-pick-learn/.git/

git-cherry-pick-learn on  main
❯ touch readme.md

git-cherry-pick-learn on  main [?]
❯ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        readme.md

nothing added to commit but untracked files present (use "git add" to track)

git-cherry-pick-learn on  main [?]
❯ git add .

git-cherry-pick-learn on  main [+]
❯ git commit -m "init readme"
[main (root-commit) ebd1ff2] init readme
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 readme.md

git-cherry-pick-learn on  main
❯ echo "Learn Cherry Pick"
Learn Cherry Pick

git-cherry-pick-learn on  main
❯ git add .

git-cherry-pick-learn on  main
❯ git commit -m "add title

git-cherry-pick-learn on  main
❯ echo "# Learn Cherry Pick" > readme.md

git-cherry-pick-learn on  main [!]
❯ git add .

git-cherry-pick-learn on  main [+]
❯ git diff

git-cherry-pick-learn on  main [+]
❯ git diff --staged
diff --git a/readme.md b/readme.md
index e69de29..3490cef 100644
--- a/readme.md
+++ b/readme.md
@@ -0,0 +1 @@
+# Learn Cherry Pick

git-cherry-pick-learn on  main [+]
❯ git commit -m "add title"
[main 148264d] add title
 1 file changed, 1 insertion(+)

git-cherry-pick-learn on  main
❯ git checkout -b trash-branch
Switched to a new branch 'trash-branch'

git-cherry-pick-learn on  trash-branch
❯ echo >> readme.md

git-cherry-pick-learn on  trash-branch [!]
❯ echo >> readme.md

git-cherry-pick-learn on  trash-branch [!]
❯ echo >> "Cherry Pick is amazing"

git-cherry-pick-learn on  trash-branch [!?]
❯ cat readme.md
───────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
       │ File: readme.md
───────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
   1   │ # Learn Cherry Pick
   2 + │
   3 + │
───────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

git-cherry-pick-learn on  trash-branch [!?]
❯ echo  "Cherry Pick is amazing" >>

git-cherry-pick-learn on  trash-branch [!?]
❯ git commit -m "add whitespace"
On branch trash-branch
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   readme.md

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        Cherry Pick is amazing

no changes added to commit (use "git add" and/or "git commit -a")

git-cherry-pick-learn on  trash-branch [!?]
❯ git add .

git-cherry-pick-learn on  trash-branch [+]
❯ git commit -m "add whitespace"
[trash-branch 94f734b] add whitespace
 2 files changed, 3 insertions(+)
 create mode 100644 Cherry Pick is amazing

git-cherry-pick-learn on  trash-branch
❯ echo "TRASH" >> readme.md

git-cherry-pick-learn on  trash-branch [!]
❯ git add .

git-cherry-pick-learn on  trash-branch [+]
❯ git commit -m "add trash"
[trash-branch ec43879] add trash
 1 file changed, 1 insertion(+)

git-cherry-pick-learn on  trash-branch
❯ echo "Cherry Pick is Amazing" >> readme.md

git-cherry-pick-learn on  trash-branch [!]
❯ git commit -m "add cherry pick is amazing"
On branch trash-branch
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   readme.md

no changes added to commit (use "git add" and/or "git commit -a")

git-cherry-pick-learn on  trash-branch [!]
❯ git add .

git-cherry-pick-learn on  trash-branch [+]
❯ git commit -m "add cherry pick is amazing"
[trash-branch 6691a34] add cherry pick is amazing
 1 file changed, 1 insertion(+)

git-cherry-pick-learn on  trash-branch
❯ cat readme.md
───────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
       │ File: readme.md
───────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
   1   │ # Learn Cherry Pick
   2   │
   3   │
   4   │ TRASH
   5   │ Cherry Pick is Amazing
───────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

git-cherry-pick-learn on  trash-branch
❯ git log
commit 6691a343e0ba35d0700c49ec09a99fa8f1f385b9 (HEAD -> trash-branch)
Author: Waylon Walker <walker_waylon_s@cat.com>
Date:   Thu May 13 08:54:58 2021 -0500

    add cherry pick is amazing

commit ec438790af36c23aef8eee2122f0dda95313496b
Author: Waylon Walker <walker_waylon_s@cat.com>
Date:   Thu May 13 08:54:07 2021 -0500

    add trash

commit 94f734b1adcee0f503c818c0f6bc9da97a0066e2
Author: Waylon Walker <walker_waylon_s@cat.com>
Date:   Thu May 13 08:50:35 2021 -0500

    add whitespace

commit 148264da5641033caa537727c6d5199068d58a4d (main)
Author: Waylon Walker <walker_waylon_s@cat.com>
Date:   Thu May 13 08:48:58 2021 -0500

    add title

commit ebd1ff22493d860e001f2b96ec948684d496355b
Author: Waylon Walker <walker_waylon_s@cat.com>
Date:   Thu May 13 08:47:10 2021 -0500

    init readme

git-cherry-pick-learn on  trash-branch
❯ git checkout main
Switched to branch 'main'

git-cherry-pick-learn on  main
❯ cat readme.md
───────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
       │ File: readme.md
───────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
   1   │ # Learn Cherry Pick
───────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

How I navigate tmux in 2021

2021-05-11T09:14:07Z

In 2021 I changed the way I navigate between tmux sessions big time. Now I can create, kill, switch with ease, and generally keep work separated into logical groups.

Update #

Since making this post, I have made ~20 other posts in short form that all have a YouTube video to go along with them you can find them all on my tmux-playlist.

Chris Toomey’s Tmux Course #

I took Chris’s tmux course in December 2020 and it was fantastic. Even as a seasoned tmux user, I learned quite a bit. Before the course, I was proficient in navigating within each of my tmux sessions but rarely started more than one session. A few months later, I have adopted a lot of what I learned from Chris and made it my own.

I am now keeping projects to their own session and can move between them fluidly with just a few keystrokes. For high-traffic projects, I have them bound to a single keystroke for instant switching. This change has been a game-changer from the mess of windows I used to have and the nightmare it was to find work I was doing and end up duplicating project work in two separate windows.

📝 NOTE: Some of my config comes straight from the course, and some of it has been extended to my liking.

Let’s take a quick look at how I am navigating through tmux on a day-to-day basis.

overview of how I switch and manage tmux sessions

👆 Overview of how I navigate tmux

tmux ls #

Throughout this article, I have several recordings showing how I use manage sessions with my keybindings. I will often run a tmux ls command to highlight running sessions at various points to help guide the viewer.

ta #

my attach/session switch script

At the heart of my tmux navigation is a highly customized version of Chris’s tat script that I renamed ta. Many folks add this to their bashrc alias ta=tmux attach. Simply calling ta will do the same thing as shown below. If you’re in a tmux session, it does nothing, and if you’re not in one, it will attach you to the first one.

get the full script from GitHub.

In my ~/.bashrc or ~/.zshrc I add the ta command to keep myself in a tmux session at all times. Whenever I open my terminal, I am automatically dropped into a tmux session, but if I am opening a split while in tmux it’s smart enough to know not to nest tmux sessions.

ta

Another article can dive into my ta command. This one is more about the methodology, workflow, and keybindings to get me there. It’s available in my script.

but there’s more #

gettin fuzzy

Give it a directory, and a fzy dropdown will let you choose a subdirectory to start your session in, and name the session after that directory.

ta ~/git

🔥 Bonus, use direnv to automatically set settings, echo your git status, activate your environment or whatever else you need.

overview of how I switch and manage tmux sessions

👆 give it a directory, it will ask for input to which project and start a new named session in that directory.

Note that starting from outside currently does not start in a split layout like it does when starting from within tmux. I am still playing with this, but generally, I want my terminal session to be plain when I first start my terminal. I usually am starting work after the first default session.

🤔 I still use both fzy and fzf. It probably doesn’t make sense to use both, but I am currently giving fzy a try.

prefix+w #

tmux choose-tree

By default, tmux comes with a tmux choose-tree command bound to prefix+w, which opens in full screen. The upper section of the screen will show every window opened. While selected, you can show the splits in each window by hitting l, or fold it with h. You can search for a session name by hitting /.

jump to existing sessions with prefix+w

using prefix+w

# ~/.tmux.conf

# expanded to show all splits
bind s choose-tree
# simpler window to show only sessions
bind S choose-session

Keybindings in choose-tree/choose-session #

The default keybindings of the tmux choose-tree and choose-session that I use are listed below. J/K are very intuitive, but I just learned about h,l,/. When I do use one of these, the / (search) can be super helpful to find sessions/windows faster.

action	key
fold	h
unfold	l
up	k
down	j
search	/

prefix+c-w prefix+c-g #

open a project

I have set up to make it easy to open my non-work projects (in my ~/git directory) and my work projects (in my ~/work directory). I bound prefix+c-g and prefix+c-w to open a new session in their respective directories. I like mapping common prefix commands with control to keep my pinky mashed on that control key.

# ~/.tmux.conf

bind C-w new-window -n "work-session-picker" "ta ~/work"
bind C-g new-window -n "git-session-picker" "ta ~/git"

create a new session from my ~/git directory

using prefix+c-g

prefix+c-j #

jump to session

Now that I have ta rocking with a good create or attach setup, I am rarely toggling through a list of running sessions, but I am doing it with prefix+c-j when I do it. Keeping my finger on control and pressing <space>+j. This keybinding uses fzf to fuzzy match to an existing session and attach.

bind C-j new-window -n "session-switcher" "tmux list-sessions | sed -E 's/:.*$//' | grep -v \"^$(tmux display-message -p '#S')\$\" | fzf --reverse | xargs tmux switch-client -t"

jump to existing sessions with prefix+c-j

using prefix+c-j

M-N M-P #

next/prev

Next and Previous sessions. This is super handy when working with under 3 sessions to be able to cycle through sessions holding shift+alt and pressing n or p.

jump to next or previous sessions with m-N or m-P

using m-N and m-P

tkill #

time to clean up

It’s easy to get a long crufty list of sessions running throughout the day. Typically this is not too bad on system resources compared to running vscode in every working project, but it does make it more challenging to manage and wade through the sessions list. I use a handy shell alias that’s been in my zshrc for quite some time.

alias tkill="for s in \$(tmux list-sessions | awk '{print \$1}' | rg ':' -r '' | fzy); do tmux kill-session -t \$s; done;"

I don’t have this one set up with a nice hotkey, but it works for my fingers. I often pop open a lower split(M-s), run tkill, and close (M-x).

create a new session git-diff switch back to original session with prefix+c-g then use tkill to kill the git-diff session

tkill example

Last Session #

back

While M-n and M-p work well with a small, focused number of sessions, I often end up with too many sessions open, and it’s not efficient to remember a double M-N followed by a triple M-P to get back and forth. Most often, I want to get between two sessions quickly, no matter what the order is.

bind -n M-B switch-client -l
bind -n M-b switch-client -l

jump to the last session with M-B

Once I get two sessions back to back, I can switch between them with insane speed and precision.

More Precision #

one keystroke

The final layer of precision is for my most current project. I need to get to these with a single keystroke. These are bound to a set of keybindings that were readily available, just above the home row.

bind C-t new-session -A -s todo "cd ~/work/todo && nvim -O backlog.md doing.md done.md"
bind -n M-i new-session -A -s ww3 "cd ~/git/ww3/ && nvim"
bind -n M-o new-session -A -s images_waylonwalker_com "cd ~/git/images.waylonwalker.com/ && nvim"

jump to my todo list with m-i

These few directories are always at my fingertips, encouraging me to keep better notes

And yes, I did steal this last one from Harpoon-man By The Way.

Hub and Spoke #

M-i M-b

I have really been digging this hub and spoke workflow where I am rocking away on a project hit M-I, take some notes then hit M-b to get back to where I was.

quickly get between projects

Model of my current workflow

Example #

Here is an example of how I use the hub and spoke model to get to notes on my blog and back to my project quickly.

quickly access notes

quickly access notes with a dedicated hotkey

Example workflow #

open tmux session with ta
prefix+c-g start work in a project using a fuzzy matcher
M-t over to my todo list
M-b back to my project
M-i to my blog to look up notes/make notes
M-b back to my project
prefix+c-g start work in another project using a fuzzy matcher
M-t over to my todo list
M-b back to my project
prefix+c-j fuzzy back to the first project
M-b back to the second project

Please let me know your thoughts. @waylonwalker, this one took me a bit longer to put together with all of the animated gif’s, but I think it helps visually show how I navigate tmux every day.

If you liked it, give it a share and tag me on twitter. I don’t often ask but this article took a bit more to put together than my normal post.

Trim unused git branches

2021-05-07T09:47:24Z

Trim branches no longer on origin #

git remote prune origin --dry-run
git remote prune origin

Find branches already merged #

git checkout main
# list remote branches that have already been merged into main
git branch -r --merged
# list local branches that have already been merged into main
git branch --merged

Create a Virtual File Gallery with Symlinks

2021-05-05T08:23:33Z

Creating a directory that is a union of several directories can be achieved with a few symlinks at the command line.

Creating a Virtual File Gallery #

Here is how I am creating a virtual directory of all my projects that is a combination of both work and not-work projects. I am creating symlinks for every directory under ~/work and ~/git.

rm -rf ~/projects
mkdir ~/projects
ln -sf ~/work/* ~/projects
ln -sf ~/git/* ~/projects

⚠ Notice that first I am recreating the directory each time. This will ensure that any project that is deleted from their actual directory is removed from the virtual gallery.

Updating the gallery #

Since links are always kept up to date without any extra work, all the data is still in the same place it started. But as new directories are added to any project directory they will not be automatically added to the virtual gallery.

cron
bashrc/zshrc

If you’re concerned about system resources, you can add it to a cron job to run at a regular schedule that makes sense to you. For me, I just popped those 4 lines right in my ~/.zshrc. It’s a bit overkill, maybe bloat, but it runs in an impercieveable amount of time.

Automatically CD to the real directory #

When you cd into a ~/projects/my-proj directory, your $PWD will still be ~/projects/my-proj. I did not want this for my use case. I wanted to follow the symlink to the real directory. I found two options that worked for me.

alias cd='cd -P'
set -o physical

Add either of these to your .bashrc/.zshrc to follow symlinks to the actual directory.

How to Install micromamba on linux (from the comamnd line only)

2021-04-21T13:32:27Z

I really like using conda (miniconda) as my python virtual environment manager of choice. It’s simple and it includes its own python interpreter using the version that I specify at creation.

Mamba #

from their readme

Mamba is a reimplementation of the conda package manager in C++.

parallel downloading of repository data and package files using multi-threading
libsolv for much faster dependency solving, a state of the art library used in the RPM package manager of Red Hat, Fedora and OpenSUSE
core parts of mamba are implemented in C++ for maximum efficiency

At the same time, mamba utilize the same command line parser, package installation and deinstallation code and transaction verification routines as conda to stay as compatible as possible.

Installing Micromamba #

Similar to miniconda micromamba can be installed with a few lines of bash

wget -qO- https://micromamba.snakepit.net/api/micromamba/linux-64/latest | tar -xvj bin/micromamba
./bin/micromamba shell init -s bash -p ~/micromamba
source ~/.bashrc

Creating Environments with Micromamba #

Creating new environments with micromamba is pretty similar to using conda.

micromamba create -n mamba-new python=3.9 -y -c conda-forge

-c is required #

I was unable to figure out how to configure channels to micromamba, so I needed to add -c conda-forge to my commands.

                                           __
          __  ______ ___  ____ _____ ___  / /_  ____ _
         / / / / __ `__ \/ __ `/ __ `__ \/ __ \/ __ `/
        / /_/ / / / / / / /_/ / / / / / / /_/ / /_/ /
       / .___/_/ /_/ /_/\__,_/_/ /_/ /_/_.___/\__,_/
      /_/

WARNING No 'channels' specified
Encountered problems while solving:
  - nothing provides requested python 3.9**

ERROR   Could not solve for environment specs

⚠ micromamba thows this error when -c conda-forge is missing from the create command.

Speed #

micromamba is built for speed. I tried it out in a replit.com session, while it felt quite snappy creating a new environment was still within a few seconds of conda on subsequent environment creations. Their marketing says it should be faster, but for what I use conda for I didn’t see it.

pip #

I used conda install years ago while on windows machines struggling to compile c-extensions and install certain troublesome packages, but I haven’t used a conda install in years, pip works just fine for my use.

Useful Links #

GitHub: https://github.com/mamba-org/mamba
Gitter: https://gitter.im/QuantStack/Lobby
Documentation: https://mamba.readthedocs.io/en/latest/

Vim Wsl Clipboard

2021-04-17T00:00:00Z

I’ve long used neovim from within windows wsl, and for far too long, I went without a proper way to get text out of it and into windows.

wsl has access to cmd applications #

wsl can access clip.exe. You can do some cool things with it, such as cat a file into the clipboard, sending output from a command to the clipboard, or set an autocmd group in vim to send yank to the windows clipboard.

using clip.exe #

Let’s say you want to send a teammate the tail of a log file over chat. You can tail the file into clip.exe.

tail -n 1 info.log | clip.exe

pipe streams of text into clip.exe

make it a bit more natural #

I recently made mine feel a bit more natural by aliasing it to clip.

alias clip=clip.exe

pop this in your ~/.bashrc or ~/.zshrc

yanking to windows clipboard from vim #

I use neovim as my daily text editor and its a pain to share code with a teammate over chat, stack overflow, into a gist, or whatever you need. The following snippet has been quite useful and flawless for me.

if system('uname -r') =~ "Microsoft"
    augroup Yank
        autocmd!
        autocmd TextYankPost * :call system('/mnt/c/windows/system32/clip.exe ',@")
        augroup END
endif

add this to your ~/.vimrc or your ~/.config/nvim/init.vim

Wsl2 #

Based on some feedback from l-sannin the ‘uname -r’ command now returns uname -r command returns '5.10.16.3-microsoft-standard-WSL2' So you will need an all lowercase microsoft.

if system('uname -r') =~ "microsoft"
  augroup Yank
  autocmd!
  autocmd TextYankPost * :call system('/mnt/c/windows/system32/clip.exe ',@")
  augroup END
endif

Quickly Edit Posts

2021-01-18T00:00:00Z

Recently I automated starting new posts with a python script. Today I want to work on the next part that is editing those posts quickly.

Automating my Post Starter

Check out this post about setting up my posts with python 🐍

Enter Bash #

For the process of editing a post I just need to open the file in vim quickly. I dont need much in the way of parsing and setting up the frontmatter. I think this is a simple job for a bash script and fzf.

change to the root of my blog
fuzzy find the post
open it with vim
change back to the directory I was in

bash function #

For this I am going to go with a bash function. This is partly due to being able to track where I was and get back. Also the line with nvim will run fzf everytime you source your ~/.alias file which is not what we want.

Lets setup the boilerplate. Its going to create a function called ep "edit post", track our current directory, create a sub function _ep. Then call that function and cd back to where we were no matter if _ep fails or succeeds.

boilerplate

ep () {
    _dir=$(pwd)
    _ep () {
        # open file here
    }
    _ep && cd $_dir || cd $_dir
}

Creating Reusable Bash Scripts

check out this post for more information about writing reusable bash scripts.

FZF #

Let’s focus in on that _ep function here that is going to do the bulk of the work to edit the post.

cd to where I want to edit from

cd ~/git/waylonwalkerv2/

Next I need to find all markdown pages within my posts directory. There is probably a better way to filter with the find command directly, but I am not worried about perf here and I knew how to do it without google.

find all markdown

find ~/git/waylonwalkerv2/src/pages/ | grep .md$

Now that we can list all potential posts, sending the selected post back to neovim is as easy as piping those files into fzf inside of a command substitution that is called with neovim.

putting together the edit command

$EDITOR $(find ~/git/waylonwalkerv2/src/pages/ | grep .md$ | fzf)

Final Script #

final ep function

ep () {
    _dir=$(pwd)
    _ep () {
        cd ~/git/waylonwalkerv2/
        $EDITOR $(find ~/git/waylonwalkerv2/src/pages/ | grep .md$ | fzf)
    }
    _ep && cd $_dir || cd $_dir
}

If Tmux

2021-01-09T00:00:00Z

I do much of my work from tmux, I love it so much that I want to setup some functionality that puts me in tmux even if I didn’t ask for it.

Bash Function #

Bash function to check if the shell is in a tmux session.

in_tmux () {
  if [ -n "$TMUX" ]; then
    return 0
  else
    return 1
  fi
  }

Using the bash function #

I often open up vim to do some quite edits, but before I know it I have several splits open and I need access to another shell utility, but I forgot to start in tmux. This function makes sure tht I start in tmux everytime.

Using if_tmux to ensure vim is opened in tmux.

vim () {
  in_tmux \
    && nvim \
    || bash -c "\
    tmux new-session -d;\
    tmux send-keys nvim Space +GFiles C-m;\
    tmux -2 attach-session -d;
    "
  }

I am not quite sure if this is proper use of the && and ||, let me know if you have a better way to do one thing if in_tmux returns true and another if it returns faslse.

Newsboat

2021-01-02T00:00:00Z

Web browsers are a black hole of productivity. I try to use them as little as possible when it is time to focus. I try to use help, ?, or ?? with ipython, or –help at the command line as much as possible. What about that time I am trying to see what my online friends are posting on their sites? I used to used google reader quite heavily before that was taken down.

Newsboat #

I am going to give a terminal rss reader a try for a bit and see how that goes for me. I have really struggled to get into an rss reader since google reader died.

installation #

I installed with the reccomended snap for Ubuntu.

sudo snap install newsboat

Adding feeds #

super simple

Running help for newsboat directed me towards their config files at the bottom.

❯ newsboat --help
newsboat r2.22
usage: /snap/newsboat/3849/usr/local/bin/newsboat [-i <file>|-e] [-u <urlfile>] [-c <cachefile>] [-x <command> ...] [-h]
    -e, --export-to-opml        export OPML feed to stdout
    -r, --refresh-on-start      refresh feeds on start
    -i, --import-from-opml=<file>   import OPML file
    -u, --url-file=<urlfile>    read RSS feed URLs from <urlfile>
    -c, --cache-file=<cachefile>    use <cachefile> as cache file
    -C, --config-file=<configfile>  read configuration from <configfile>
    -X, --vacuum            compact the cache
    -x, --execute=<command>...  execute list of commands
    -q, --quiet         quiet startup
    -v, --version           get version information
    -l, --log-level=<loglevel>  write a log with a certain loglevel (valid values: 1 to 6)
    -d, --log-file=<logfile>    use <logfile> as output log file
    -E, --export-to-file=<file> export list of read articles to <file>
    -I, --import-from-file=<file>   import list of read articles from <file>
    -h, --help          this help
        --cleanup           remove unreferenced items from cache

Files:
    - configuration:  /home/nic/snap/newsboat/3849/.newsboat/config
    - feed URLs:      /home/nic/snap/newsboat/3849/.newsboat/urls
    - cache:          /home/nic/snap/newsboat/3849/.newsboat/cache.db

Support at #newsboat at https://freenode.net or on our mailing list https://groups.google.com/g/newsboat
For more information, check out https://newsboat.org/

I just need to edit its urls file.

nvim ~/snap/newsboat/3849/.newsboat/urls

The Urls file is just a list of urls to rss feeds. Adding mine in allowed me to see all of my posts.

https://waylonwalker.com/rss.xml

Config #

I took most of my config from a blog post that I found by Evan Travers. It set some sane defaults to the reading width and vim keys.

# https://evantravers.com/articles/2020/04/15/reworking-my-rss-reading/
# Hide feeds where all the items are read.
show-read-feeds no

# Make the text width readable
text-width 50

# Use multiple threads to download all the news faster.
reload-threads 11

# browser ~/bin/newsboat-browser.sh
# browser "/usr/bin/brave-browser %u"

# unbind keys
unbind-key ENTER
unbind-key j
unbind-key k
unbind-key J
unbind-key K
unbind-key ^D
unbind-key ^U
unbind-key o
unbind-key g
unbind-key G

# bind keys - vim style
bind-key j down
bind-key k up
bind-key l open
bind-key h quit
bind-key ^D pagedown
bind-key ^U pageup
bind-key b toggle-source-view
bind-key U toggle-show-read-feeds
bind-key u show-urls
bind-key g home
bind-key G end
bind-key b open-in-browser-and-mark-read
bind-key B open-in-browser
bind-key i sort
bind-key I rev-sort

GUI Browser #

No matter how many different guides I tried I keedp getting error code 127 when trying to open-in-browser. Please let me know if you know how to fix this. For now I am just going to roll with it.

Here’s how it looks #

browsing a feed in newsboat

reading an article in newsboat

Ipython Ninjitsu

2020-12-14T00:00:00Z

?docstring
??sourcecode
%run
%debug
%autoreload
%history
autoformat
%reset
!shell commands

?docstring #

Stop going to google everytime your stuck and stay in your workflow. The ipython ? is a superhero for productivity and staying on task.

from kedro.pipeline import Pipeline
Pipeline?

Init signature:
Pipeline(
    nodes: Iterable[Union[kedro.pipeline.node.Node, ForwardRef('Pipeline')]],
    *,
    tags: Union[str, Iterable[str]] = None,
)
Docstring:
A ``Pipeline`` defined as a collection of ``Node`` objects. This class
treats nodes as part of a graph representation and provides inputs,
outputs and execution order.
Init docstring:
Initialise ``Pipeline`` with a list of ``Node`` instances.

Args:
    nodes: The iterable of nodes the ``Pipeline`` will be made of. If you
        provide pipelines among the list of nodes, those pipelines will
        be expanded and all their nodes will become part of this
        new pipeline.
    tags: Optional set of tags to be applied to all the pipeline nodes.

Raises:
    ValueError:
        When an empty list of nodes is provided, or when not all
        nodes have unique names.
    CircularDependencyError:
        When visiting all the nodes is not
        possible due to the existence of a circular dependency.
:

Note This does jump you into a pager, a j,k or up, down to navigate, q to quit.

??sourcecode #

Docstring not enough for you use case. I often run into cases where the docstring is not clear enough and I need to see the implementation for myself to see what a function does.

%run #

I turned my nose up at this one, prior to seeing the famous I don’t like notebooks by Joel Grus. My first snobby reaction was that developing modules and using autoreload was superior. I have since realized there is a place for %run, and it can cut down on some keystrokes to import, setup, and run even when developing in modules.

%debug #

ipython comes with a post-mortem debugger, and it can be a lifesaver. If we have a long running function that runs into an error it can be a complete buzzkill.

def long_func():
   import time
   time.sleep(12)
   n = 12
   df = pd.Data({'a': range(n)})
   return df

long_func()

%reset #

Reclaim memory usage in Jupyter

%autoreload #

Autoreload in Ipython

c.InteractiveShellApp.extensions = ["autoreload"]
c.InteractiveShellApp.exec_lines = ["%autoreload 2"]
c.InteractiveShellApp.exec_lines.append(
    'print("Warning: disable autoreload in ipython_config.py to improve performance.")'
)

place this in your ~/.ipython/profile_default/ipython_config.py to auto reload without needing to run the magic every time

autoformat #

This is a relatively new feature to ipython. I really enjoy it, as the time that I need the most help autoformatting my code is riffing on an ad hoc analysis at the command line.

c.TerminalInteractiveShell.autoformatter = "black"

place this in your ~/.ipython/profile_default/ipython_config.py to autoformat with black by default

new prompt #

reverse history search #

Control R

Want automatic imports?? #

Smoother Python with automatic imports | pyflyby

This article covers how I setup automatic imports in ipython

Scripting Tmux Layouts

2020-12-13T00:00:00Z

This is how I script a tmux layout

 bash -c "tmux new-session -t 'editor' -d;\
    tmux split-window -v 'zsh';
    tmux send-keys nvim Space /src/ Space +GFiles C-m; \
    tmux rotate-window; \
    tmux select-pane -U; \
    tmux -2 attach-session -d
    "

Compare Directories In Bash

2020-12-11T00:00:00Z

Today I needed to check for articles that used the same slug from two directories, bash made it super simple.

diff -rq src/pages/blog src/pages/notes

Find and Replace in the Terminal.

2020-11-12T05:00:00Z

grepr #

grepr() {grep -iRl "$1" | xargs sed -i "s/$1/$2/g"}

```bash
grepr() {grep -iRl "$1" | xargs sed -i "s/$1/$2/g"}

grepd #

grepd() {grep -iRl "$1" | xargs sed -i "/^$1/d"}

CocSearch #

:CocSearch published: false -g *.md

Creating Reusable Bash Scripts

2020-08-13T05:00:00Z

Bash is a language that is quite useful for automation no matter what language you write in. Bash can do so many powerful system-level tasks. Even if you are on windows these days you are likely to come across bash inside a cloud VM, Continuous Integration, or even inside of docker.

I have three techniques that help me write more composable bash scripts.

functions

Functions #

Break scripts down into reusable components

Functions in bash are quite simple. They are something that I wish I would have started using long ago. They make your code much more reusable. I often use them in my aliases as well since they can simplify the process and allow more flexibility.

syntax

#!/bin/sh
# hello_world
hello_world () {
    echo "hello world"
}

Source the file to load the function and run it from the terminal.

run it

source hello_world
hello_world

outputs

hello world

Arguments #

Make functions a little more flexible

Arguments and options are quite a bit more complex in bash. For now, we will focus on the basics which are not all that bad.

positional arguments #

easiest and most common to use

Positional arguments can be pulled out quite easily using $1 for the first one, $2 for the second, and so on.

note $0 is the command that was called. You will see this often used to find the command called to open up your current shell.

syntax

#!/bin/sh
# hello
hello () {
    echo "hello $1"

run it

source hello
hello Waylon

Now we have a function that accepts positional arguments and we can call it by passing things into it.

outputs

hello Waylon

More than one argument would be ignored since we are only looking at $1.

run it

source hello
hello Waylon Walker

outputs

hello Waylon

Just the same as before since we do not use the second argument.

All Arguments #

Bash has another special variable $@ that stores all arguments in one.

syntax

#!/bin/sh
# hello
hello () {
    echo "hello $@"
}

Just the same as before.

run it

source hello
hello Waylon Walker

Now the function will output all arguments that are passed into it since we are using the $@ variable.

outputs

hello Waylon Walker

Error Handling #

Super powers in a single line

The easiest and most common way to handle an error in bash is through the use of the logical operators && (and) and || (or).

Here I have a concrete example from earlier today. I was creating a bash script to run a python script from cron. The bash script is there to make sure that we have the python environment, activate it, and run. If it doesn’t have it, it should create it.

# creates the conda environment
create_env() {
    conda create -n "$1" python=3.8
    conda activate "$1"
    pip install -r requirements.txt
}


# checks if the conda environment exists
env_exists() {
conda info --envs | awk '{print $1}' | tail -n +3 | grep -w "$1" > /dev/null
}


# creates the conda environment if it doesn't exist
create_if () {
env_exists "$1" && echo "environment exists" || create_env "$1"
}

create_if my_env

If we look at the create_if function, it will check if the environment exists if there is a passing status code 0, then it will run echo "environment exists" otherwise it will run create_env $1.

note Inside of env_exists grep will look for whole words if there is a match it will give a status code 0 if it finds a match and not 0 if there is no match.

main script #

_if __name__ == " __main__"_

The last thing I want to discuss is making a bash script both runnable and sourceable. This makes it so that you can source filename.sh and run each function individually, or bash filename.sh to run the script. This is a similar concept to if __name__ == " __main__" from python.

I did try this from bash and zsh with success. The following is an example that would pass all arguments into a main function.

syntax

if [["${BASH_SOURCE[0]}" == "${0}" ]]; then
    main "$@"
fi

Extending the example above that created a python example if necessary we can create the env if necessary, activate the environment, and run the script.

syntax

if [["${BASH_SOURCE[0]}" == "${0}" ]]; then
create_if my_env
conda activate my_env
python script.py
fi

Using this syntax to run our “main” functions will allow us to both runs the script or source the script to utilize the functions that we created.

How to Install miniconda on linux (from the command line only)

2020-08-10T05:00:00Z

miniconda is a python distribution from continuum. It’s a slimmed-down version of their very popular anaconda distribution. It comes with its own environment manager and has eased the install process for many that do not have a way to compile c-extensions. It made it much easier to install the data science stack on windows a few years ago. These days windows are much better than it was back then at compiling c-extensions. I still like its environment manager, which installs to a global directory rather than a local directory for your project.

Installing miniconda on Linux #

Installing miniconda on Linux can be a bit tricky the first time you do it completely from the terminal. The following snippet will create a directory to install miniconda into, download the latest python 3 based install script for Linux 64 bit, run the install script, delete the install script, then add a conda initialize to your bash or zsh shell. After doing this you can restart your shell and conda will be ready to go.

mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh
~/miniconda3/bin/conda init bash
~/miniconda3/bin/conda init zsh

Options #

The miniconda.sh script comes with a few basic options. Most notably we used -b to be able to run unattended, which means that all of the agreements are automatically accepted without user prompt. -u updates any existing installation in the directory of install if there is one. -p is the directory to install into.

usage: /root/miniconda3/miniconda.sh [options]

Installs Miniconda3 4.6.14

-b           run install in batch mode (without manual intervention),
             it is expected the license terms are agreed upon
-f           no error if install prefix already exists
-h           print this help message and exit
-p PREFIX    install prefix, defaults to /root/miniconda3, must not contain spaces.
-s           skip running pre/post-link/install scripts
-u           update an existing installation
-t           run package tests after installation (may install conda-build)

Silent/Logged #

A quick and easy way to silence everything or to log it to a file during an automated install is to wrap the script into a bash function, or save it to its own file, and call the file. I like the function method since I can still copy it right into a terminal, or keep my install script as one single file.

install_miniconda () {
mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh
~/miniconda3/bin/conda init bash
~/miniconda3/bin/conda init zsh
}

normal

install_miniconda

silent

install_miniconda > /dev/null 2>&1

logged

install_miniconda > miniconda_install.log 2>&1

Creating Reusable Bash Scripts

This posts covers more ways to write reuable bash scripts

Cross posted to DEV #

Check out this post and many more on dev.to/waylonwalker

025.md

2020-07-29T02:16:24Z

Convert Markdown to reveal.js slides

setup

wget https://github.com/hakimel/reveal.js/archive/master.tar.gz
tar -xzvf master.tar.gz
mv reveal.js-master reveal.js

convert

pandoc -t revealjs -s -o myslides.html myslides.md -V revealjs-url=https://unpkg.com/reveal.js@3.9.2/

026.md

2020-07-28T05:00:00Z

Convert Markdown to reveal.js slides

setup

wget https://github.com/hakimel/reveal.js/archive/master.tar.gz
tar -xzvf master.tar.gz
mv reveal.js-master reveal.js

convert

pandoc -t revealjs -s\
   -o myslides.html myslides.md \
   -V revealjs-url=https://unpkg.com/reveal.js@3.9.2/

inline YAML or path to separate file (e.g.: .github/filters.yaml)

2020-06-21T02:16:24Z

Conditionally run GitHub Actions Steps

- uses: dorny/paths-filter@v2.2.0
  id: filter
  with:
      # inline YAML or path to separate file (e.g.: .github/filters.yaml)
      filters: |
      backend:
          - 'backend/**/*'
      frontend:
          - 'frontend/**/*'

# run only if 'backend' files were changed
- name: backend unit tests
  if: steps.filter.outputs.backend == 'true'
  run: ...

023

2020-06-21T02:16:24Z

Find and replace Groups in VSCode $1 referrs to the second group

(filepath: top)(.*)
filepath: s3://bucket/top$1.parquet

- filepath: top/raw/scooters
+ filepath: s3://bucket/top/raw/scooters.parquet

022

2020-06-21T02:16:24Z

File System Full 🤔 #

Move files then symlink them

with Bash #

mkdir /mnt/mounted_drive
mv ~/bigdir /mnt/mounted_drive
ln -s /mnt/mounted_drive/bigdir ~/bigdir

021

2020-06-21T02:16:24Z

File System Full 🤔 #

show largest files in current directory

with Bash #

du . -h --max-depth=1

020

2020-06-21T02:16:24Z

File System Full 🤔 #

Show Remaining Space on Drives

with Bash #

df -h

019

2020-06-21T02:16:24Z

batch rename files #

with bash #

for f in *.jpeg; do
    mv -- "$f" "${f%.jpeg}.jpg"
done

006

2020-06-06T18:14:14Z

Setup pre-commit for isort

  - repo: https://github.com/asottile/seed-isort-config
    rev: v2.1.1
    hooks:
      - id: seed-isort-config
  - repo: https://github.com/pre-commit/mirrors-isort
    rev: v4.3.21
    hooks:
      - id: isort

includes automatic .isort-config

git push without setting upstream

2020-02-04T12:18:00Z

Finally after years of hand typing out a full git push --upstream my_really_long_and_descriptive_branch_name I found there is a setting to automatcally push to the current branch. More realisitically I just did a git push let git yell at me, and copying the suggestion.

git config #

git config --global push.default current

This one setting will now git push to the current branch without yelling at you that your upstream does not match your current branch. This helps me ship chnages faster as I am constantly chnaging projects and branches.

simple click

2020-01-29T06:00:00Z

cli tools are super handy and easy to add to your python libraries to supercharge them. Even if your library is not a cli tool there are a number of things that a cli can do to your library.

Example Ideas #

Things a cli can do to enhance your library.

🆚 print version 🕶 print readme 📝 print changelog 📃 print config ✏ change config 👩‍🎓 run a tutorial 🏗 scaffold a project with cookiecutter

🖱 Click #

Click is the most popular python cli tool framework for python. There are others, some old, some new comers that make take the crown. For now Click is the gold standard if you want to make a powerful cli quickly. If you are dependency conscious and dont need a lot of tooling, use argparse.

Project Structure #

.
├── setup.py
└── simple_click
    ├── cli.py
    └── __init__.py

❯ cli.py #

    # simple_click/cli.py
    import click

    __version__ = "1.0.0"

    @click.group()
    def cli():
       pass

    @cli.command()
    def version():
        """prints project version"""
        click.echo(__version__)


    if __name__ == '__main__':
        cli()

✨ init.py #

For our simple_click library __init__.py__ can be left empty. It is here purely to signify that simple_click is a library. It is likely that you will import other modules here that need to reside at the top level of your library api, your cli does not need to be at the top of of your api.

    # __init__.py

🚪 Entry Points #

Entry points are the magic that make python cli tools available as their own command without having python before it or the file extension.

    # setup.py

    from setuptools import setup, find_packages

    # this is the 🥩 meat of this snippet
    # simple_click is the command name
    # = simple_click is the library name
    # .cli is the cli.py file
    # :cli is the cli function
    #
    # the second item is a shorthand alias to the main command

    entry_points = [
       "simple_click = simple_click.cli:cli",
       "scli         = simple_click.cli:cli",
    ]


    setup(
        name='simple_click',
        version='1.0.0',
        url='https://github.com/mypackage.git',
        packages=find_packages(),
        entry_points={"console_scripts": entry_points},

    )

🕶 See it in action #

Simple-click-in-action

📢 Discuss #

What do You wish more python libraries included in their cli? Tweet it @_waylonwalker

cmd.exe tips

2020-01-23T15:18:45Z

I spend a lot of my time at the terminal for my daily work, mostly in Linux or wsl. One big reason for using wsl over cmd.exe is the ease of walking through history that fzf provides. This week we had a windows bug in a cli and I was stuck in vanilla cmd.exe 😭

> Cmder #

First off if you are stuck using cmd.exe, do yourself a favor and get cmder. It makes life just a bit easier. It is super confugurable and comes with several power ups that make it a bit more enjoyable than cmd.exe.

History #

F7 - Scroll through history

F8 - Search history based

Example #

image

.bat #

The next simple technique is to save your commands into a .bat file. Any valid command ran with cmd.exe can be saved into a bat file and called again later by running it in the terminal.

save your command

use f7/f8 to get your command back add > filename.bat at the end, hit the home key and add echo to the front. Do not wrap with quotes. This is not bash.

echo python cmd_example.py > cmd_example.bat

» append

echo python cmd_example2.py >> cmd_example.bat

type not cat #

To ensure that you got the command right… and didn’t forget that you were in cmd.exe instead of bash and add quotes. you will want to see the file contents. For this reach for type not cat.

type cmd_example.bat

results

python cmd_example.py
python cmd_example2.py

Your quick tips #

let me know what quick cmd.exe tips you have.

Supercharge Zsh Startup

2020-01-03T06:00:00Z

I have been using oh-my-zsh successfully for about 2 years now. But lately my startup time has been really bothersome. It has grown to the point where it was taking about 5.5s to startup a shell! This is ok if I am going to spend some time in here for awhile and do some work that benefits from all of the autocompletions, plugins, and shortcuts that oh-my-zsh brings. But to only jump in to run a handful of commands is infuriating.

📑 My Setup #

I believe the real issue is io speed on wsl. I have some remote servers with similar configs that are 10x faster or more, loading in 100s of milliseconds rather than seconds. Sourcing all of the individual plugin files are just too much for it.

💨 How Fast can it be #

Quick side note: your zsh config is controled by your ~/.zshrc file. This file can source other files, load plugins, or run literally anything.

Time the initial time

time zsh -c exit

Move your ~/.zshrc config file.

mv ~/.zshrc ~/.zshrc-back

Time the fastest startup possible with nothing in your ~/.zshrc config file.

time zsh -c exit

Move your ~/.zshrc back

mv ~/.zshrc-back ~/.zshrc

🕵️‍♂️Profile your startup time #

It is possible to profile your zsh startup time by adding zmodload zsh/zprof to the start of your ~/.zshrc file and zprof at the end. This was unsuccessfull for me. I ended up just backing up ~/.zshrc file, then deleting half of it to see where the hot spots were. I found that two places that were really hot for me. One I was inadvertantly setting git and npm settings everytime that didn’t need to be set everytime. That was an easy 2s gain. Another easy 3s gain was removing oh-my-zsh.

# ~/.zshrc
zmodload zsh/zprof
...
..
.
zprof

😭But I really like oh-my-zsh #

without all the bells and whistle that oh-my-zsh provided zsh became lightning fast to load, but incredibly boring. It was also very painful to manually type out everything that it autocompleted or aliased all the time. Next I headed down a path to get all of that functionality back without sacrificing load time.

Without oh-my-zsh, zsh became incredibly boring.

🔌 Plugin Managers #

Photo by Steve Johnson on Unsplash

oh-my-zsh
zplugin
zgen

There are a number of plugin managers for zsh, I tried each of the ones listed above, but found that as I approached a nice setup that I liked the load time would creep up above the 2s mark each time. I would turn certain plugins on and off, try different plugin managers, before realizing that I had spent enough time on this problem and it was going to be time to settle on fast startup or functionality.

⚖ Finding Balance #

Semi-lazy loading

Photo by Jeppe Hove Jensen on Unsplash

After struggling to get all of the features I wanted with a fast load time, I decided to only load what I needed upon startup. Next I created a simple alias that loads in zgen and all of the plugins I want. By doing this I get two main benefits. Obviously I get a faster starup time by loading less. I got my startup time down to about 0.25s.

# ~/.zshrc
p () {
zgen load zsh-users/zsh-autosuggestions
....
..
.
}

⚡ Fast Loading #

I really like the fast startup time, because sometimes I am only loading up zsh to run a handful of commands that dont need much in the way of plugins

simple commands that need 💨 blazing start speed

any single easy to type command, these are my common commands that I will open a terminal in my editor and just need to run quick.

vim
git add . && git commit && git push
sh my_script.sh
make build
bake build
pytest
gatsby develop
npm i
npm update
pip install
ipython

The second benefit was that I can continue typing while plugins are loading.

>Prompt #

After removing oh-my-zsh the first thing that I missed was the themes that it provided. I went through a number of them and the one that seemed to have the smallest effect on performance and everything I needed was starship. It’s a really fast prompt written in rust. The biggest thing that I needed to have that other prompts were misssing was conda environments. I live much of my work life running python from various conda environments and it is crutial that I can see what environment I am in at all times.

💰 Bonus #

I applied the same logic to neovim and achieved similar results. Again it just had too many plugins loading on startup for simple tasks. I ended up taking a shortcut and load any heavy plugins upon NerdTreeToggle. I dont really use NERDTree that much, but when I do its for more than just a quick edit.

# ~/.config/nvim/init.vim
Plug 'valloric/youcompleteme', {'do': './install.py', 'on': 'NERDTreeToggle'}

Amazon Web Services

2019-09-22T05:00:00Z

I started using aws in March 2019. Here are some of my notes.

aws-cli #

ec-2 #

SageMaker #

S3 #

📝 Bash Notes

2019-09-08T05:00:00Z

Bash is super powerful.

File System Full #

Show Remaining Space on Drives

df -h

show largest files in current directory

du . -h --max-depth=1

Move files then symlink them

mkdir /mnt/mounted_drive
mv ~/bigdir /mnt/mounted_drive
ln -s /mnt/mounted_drive/bigdir ~/bigdir

Fuzzy One Liners #

a() {source activate "$(conda info --envs | fzf | awk '{print $

edit in vim

vf() { fzf | xargs -r -I % $EDITOR % ;}

cat a file

vf() { fzf | xargs -r -I % $EDITOR % ;}

bash execute

bf() { bash "$(fzf)" }

git add

gadd() { git status -s | fzf -m | awk '{print $2}' | xargs git add && git status -s}

git reset

greset() { git status -s |  fzf -m | awk '{print $2}' |xargs git reset && git status -s}

Kill a process

fkill() {kill $(ps aux | fzf | awk '{print($2)}')}

Finding things #

Files #

fd-find is amazing for finding files, it even respects your .gitignore file 😲. Install with apt install fd-find.

fd md

ag -g python

find . -n "*.md"

++Vanilla Bonus

Content #

** show matching text **

ag python

grep -iR Python

++Vanilla Bonus

** show file names only **

ag -l python

grep -iRl python

++Vanilla Bonus

Recursively Replace text #

agr() {ag -l "$1" | xargs sed -i "s/$1/$2/g"}

++Vanilla Bonus

grepr() {grep -iRl "$1" | xargs sed -i "s/$1/$2/g"}

Extending **agr** or **grepr**

There are so many options inside of grep, ag, and sed that you could many an enormous amount of these if you really wanted to, but I like to keep it simple. These cover 90% of my usage. If I wanted to change something in the second half I would just paste in this command and edit it. More often though I want to limit the input, say only replace word1 to word2 inside of markdown files.

Limited Scope

fd md | xargs argr python python3

find . -n "*.md" | xargs grepr python python3

++Vanilla Bonus

Large Refactor At The Command Line

I use these replace commands heavily when doing large refactorings.

conditionally configure #

I like this one when there is not a good cli into config files and I need to replace something like a true to false if the value is in the config and append to the config if its not.

grepr() {
    # replaces first string with second string inside file from third argument
    # example:
    #   grepr "allow_conda_downgrades:.*" "allow_conda_downgrades: true" ~/.condarc
    if grep -xq $1 $3
    then
        sed -i "s|$1|$2|g" $3
    else
        echo "$2" >> $3
    fi
}

Watch the time #

watch -n 1 date

++Vanilla Bonus

with figlet

watch -n 1 bash -c "date | figlet"

watch a function #

run () {
date
aws s3 sync $BUCKET .
}
export -f run
watch -n 10 run

if conda environment does not exist create it #

conda info --envs | grep my_env && echo "my_env environment is installed" || conda create -n my_env python=3.8 -y
source activate my_env

Rename multiple files

more info from linuxize

for f in *.png; do
   mv ${f} prefix-${f}
done

using the rename command #

sudo apt install rename

rename "s/.GIF/.gif/" *.GIF

convert all files in a directory to unix #

dos2unix **/*

recursively remove all whitespace from .py files #

find **/*.py -type f -exec sed -i 's/ *$//' '{}' ';'

recursively autopep8 #

find . -name '*.py' -exec autopep8 --in-place '{}' \;

make bash script a runnable command #

include a shebang

#! /bin/bash

chmod

chmod +x /usr/local/bin/my_script

accept positional input

#! /bin/bash
input=$1
echo input

Using pyp #

pipx install pyp

replacement for cut #

❯ python -m http.server 5000 &
[1] 8574

✦ ❯ Serving HTTP on 0.0.0.0 port 5000 (http://0.0.0.0:5000/) ...

✦ ❯ ps aux | grep "python -m http.server" | grep -v grep | pyp 'line.split()[1]' | xargs kill
[1]  + terminated  python -m http.server 5000

replacement for wc #

conda info --envs | pyp 'len(lines) - 3 # account for header and base'

print contents of shell function #

declare -f <function-name>

batch rename files #

for f in *.jpeg; do
    mv -- "$f" "${f%.jpeg}.jpg"
done

convert markdown files to reveal.js #

https://github.com/jgm/pandoc/wiki/Using-pandoc-to-produce-reveal.js-slides{.hoverlink} install pandoc

apt install pandoc

setup

wget https://github.com/hakimel/reveal.js/archive/master.tar.gz
tar -xzvf master.tar.gz
mv reveal.js-master reveal.js

convert

pandoc -t revealjs -s -o myslides.html myslides.md -V revealjs-url=https://unpkg.com/reveal.js@3.9.2/

Render Markdown at the command line #

Glow is a terminal markdown renderer written in go. There iis a prebuilt binary that can simply be unzipped and executed to render markdow.

wget https://github.com/charmbracelet/glow/releases/download/v0.2.0/glow_0.2.0_linux_x86_64.tar.gz
tar -xzf glow_0.2.0_linux_x86_64.tar.gz
chmod +x glow
sudo mv glow /usr/bin

glow <filename>

Autocomplete for click applications #

see the docs for more details

Autocomplete for non click python cli’s #

shtab https://github.com/iterative/shtab

Ensure functions reset context #

project_log() {
   _dir=$(pwd)
   _project_log() {
      cd ~/projects/project
      git log
   }
   _project_log $@ && cd $_dir || cd $_dir
}

Finding Files #

rg --files . | grep bash
rg --files . | rg bash
rg --files . | ag bash
rg --files . | fzf
rg -e 'hook' -g '*.md'
rg -e 'hook' -g '*.py'

rg --files-with-matches
rg --files-without-match

mu-repo #

# installation
pip install mu-repo

## register repos
mu register --recursive
mu list

# run git commands
mu status --short
mu diff -U0 --color | bat

# run shell commands
mu sh $(grep -iRl "KEDRO_GID=0" | xargs sed -i "s/KEDRO_GID=0/KEDRO_GID=5/g")

Maintianing multiple git repos with mu-repo

See the full post for mu-repo for more

mu unregister all #

I ran into some issues with mu unregister * before, but this seems to work everywhere.

mu list | tail -n +3 | xargs -I {} mu unregister {}

mu register all repos that have an rg match #

Add all repos that have a versionspec of 3.7 in them.

rg --hidden=true 'versionSpec:.*.3.7' -l | xargs -I {} mu register {}

xrandr #

xrandr -s 1920x1080

Keyboard Driven VSCode

2019-07-07T05:00:00Z

Throw that mouse Away its time to setup some keyboard shortcuts.

These sortcuts were the baseline for switching from tmux/vim to vscode. Most folks posts I was able to find gave great tips on replacing vim, but very few have focused on the hackability of tmux. tmux allows me to rapidly fire up a workspace, create new windows and splits. Then When I switch tasks I can leave that workspace open and and jump right back in later exactly where I left off. There is nothing quite like it. The shortcuts listed here make the transition a bit better. The worst thing I found when using vscode at first was no way to switch between the terminal and editor without the mouse. This first set of keybindings solve that issue.

The worst thing I found when using vscode at first was no way to switch between the terminal and editor without the mouse.

!!! see-also I have an updated article in my tmux workflow How I navigate tmux in 2021

Alt+[hjkl] #

navigation

⬅ jump to left split alt+h

⬇ jump to terminal from editor alt+j

⬆ jump to editor from terminal alt+k

➡ jump to right split alt+l

This is by var the most useful set of keybindings that I use in vscode and is directly replicated from my tmux configuration. It allows me to quickly jump up, down, left, right. Do note that if you use vertical splits it does not work as well as tmux 😢.

navigating vscode with keyboard shortcuts

[
        {
            "key": "alt+j",
            "command": "workbench.action.terminal.focus",
            "when": "editorFocus"
        },

        {
            "key": "alt+k",
            "command": "workbench.action.focusFirstEditorGroup",
            "when": "terminalFocus"
        },
        {
            "key": "alt+k",
            "command": "workbench.action.focusAboveGroup",
            "when": "editorFocus"
        },
        {
            "key": "alt+l",
            "command": "-toggleFindInSelection",
            "when": "editorFocus"
        },
        {
            "key": "alt+l",
            "command": "workbench.action.focusNextGroup",
            "when": "editorFocus"
        },
        {
            "key": "alt+h",
            "command": "workbench.action.focusPreviousGroup",
            "when": "editorFocus"
        },

        {
            "key": "alt+l",
            "command": "workbench.action.terminal.focusNextPane",
            "when": "terminalFocus"
        },
        {
            "key": "alt+h",
            "command": "workbench.action.terminal.focusPreviousPane",
            "when": "terminalFocus"
        },
]

Alt+b #

toggle bloat

Since closing the sidebar is assigned to ctrl+b I thought that it made most sense to simulate the activity bar with alt+b. There are many times when I just want to get as much out of the way as possible and this little bit does help.

hiding the activity bar

[
    {
        "key": "alt+b",
        "command": "workbench.action.toggleActivityBarVisibility",
        "when": "editorFocus"
    },
]

Alt+[svx] #

Split it up

🙌 Split hoizontally alt+s

🍌 Vertically alt+v

💥 Close alt+x

This is another one replicated from tmux for quickly creatiting horizontal (s) and vertical (v) splits. Once I am done with them I can close them with alt+x.

Make and destroy splits with ease in vscode.

[
    {
        "key": "alt+s",
        "command": "workbench.action.terminal.split",
        "when": "terminalFocus"
    },
    {
        "key": "alt+s",
        "command": "workbench.action.splitEditor",
        "when": "editorFocus"
    },
    {
        "key": "alt+v",
        "command": "workbench.action.splitEditorOrthogonal",
        "when": "editorFocus"
    },
    {
        "key": "alt+x",
        "command": "workbench.action.terminal.kill",
        "when": "terminalFocus"
    },
    {
        "key": "alt+x",
        "command": "workbench.action.closeActiveEditor",
        "when": "editorFocus"
    }
]

Alt+[cnp] #

🤲 Create new workspace alt+c

⏭ jump to next workspace alt+n

⏮ jump to previous workspace alt+p

Sometimes the terminal window gets a bit cramped inside of splits and you need to use different panes. I replicated the cnp pattern from tmux here as well. I can create (c) new panes, then go to the next (n), or previous (p) without leaving the comfort of my keyboard.

I am often using this one when I have a process running that I watch like gatsby, and I need to quickly pop into a new pane to run a git command and back in to gatsby before jumping up to my editor.

image

[
    {
        "key": "alt+c",
        "command": "workbench.action.terminal.new",
        "when": "terminalFocus"
    },
    {
        "key": "alt+n",
        "command": "workbench.action.terminal.focusNext",
        "when": "terminalFocus"
    },

    {
        "key": "alt+p",
        "command": "workbench.action.terminal.focusPrevious",
        "when": "terminalFocus"
    },
]

Alt+z #

🗻 Zoom into terminal alt+z

This last one doesnt work as well as I would like but it sure does get the job done. It Zooms (z) into the terminal from anywhere in vscode. I can be in my editor and zoom out of the terminal to make more room, or zoom in to see what happened from my last edit.

image

[
    {
        "key": "alt+z",
        "command": "workbench.action.toggleMaximizedPanel",
    },
]

Bonus #

Alt+r #

🖱 right click in place

I recently found this one, and find it quite useful to quickly do things like revert selected range, or extract variable without leaving the keyboard.

[
  {
    "key": "alt+r",
    "command": "editor.action.showContextMenu",
  },
]