How joshmedeski/sesh works
Sesh is a CLI for discovering, creating, and switching tmux sessions. Its main user path is command invocation, session discovery, optional interactive selection, then connection to a tmux session; README-described workflows also include project configuration, previews, and worktree sessions. The graph includes those documented capabilities, while some links remain unverified because their command wiring or implementation was not sampled.
Main entry points: session.go Connection Resolution · seshcli CLI Commands · worktree.go Worktree Manager · list.go Session Listing
Components 21
CLI and Interaction
- CLI Entry
main.go - CLI Commands
seshcli - Interactive Picker
picker/tui.go
Session Discovery
- Project Configuration
configurator/configurator.go - Session Listing
lister/list.go - Listing Cache
lister/caching_lister.go - Session Formatting
formatter/formatter.go - Session Preview
previewer/previewer.go
Session Connection
- Connection Resolution
connector/session.go - Session Startup
startup/startup.go
Worktree Workflows
- Worktree Commands
seshcli/worktree.go - Worktree Manager
worktree/worktree.go
Runtime Services
- tmux Operations
tmux/client.go - zoxide Search
zoxide/query.go - Shell Execution
shell/shell.go - Git Operations
git/git.go - GitHub Integration
github/github.go - Browser Context
browser/browser.go
Other components
- User
- tmux Server
- zoxide Database
Connections 23
- User → CLI Entry: invokes
README.md - CLI Entry → CLI Commands: executes
main.go - CLI Commands → Interactive Picker: opens
- CLI Commands → Session Listing: requests sessions
- Session Listing → Listing Cache: delegates listing
lister/caching_lister.go - Listing Cache → Session Listing: refreshes
lister/caching_lister.go - Session Listing → Session Formatting: formats results
- Interactive Picker → Connection Resolution: selects session
- CLI Commands → Project Configuration: loads settings
- CLI Commands → Session Preview: requests preview
- Connection Resolution → Session Listing: resolves session
connector/session.go - Connection Resolution → zoxide Search: adds path
connector/session.go - Connection Resolution → Session Startup: starts session setup
connector/session.go - Connection Resolution → tmux Operations: creates or focuses
connector/session.go - Session Startup → tmux Operations: creates windows
startup/startup.go - Worktree Commands → Worktree Manager: dispatches
seshcli/worktree.go - Worktree Manager → Browser Context: resolves browser tab
worktree/worktree.go - Worktree Manager → Git Operations: fetches repository
worktree/worktree.go - Worktree Manager → GitHub Integration: looks up pull request
worktree/worktree.go - Worktree Manager → Connection Resolution: connects worktree
worktree/worktree.go - tmux Operations → tmux Server: queries clients
- zoxide Search → Shell Execution: runs query
- zoxide Search → zoxide Database: searches paths