sesh
Smart tmux session manager
Sesh is a smart tmux session manager that ships with an agent skill for AI coding assistants. The skill teaches agents like Claude Code and Cursor to manage terminal sessions intelligently through sesh instead of raw tmux commands, automatically selecting or creating sessions based on project context. It integrates with zoxide for directory navigation and supports git worktree workflows, configuration files, and interactive session picking. Agents using the skill can resolve session names across tmux, zoxide, and custom configs, reuse existing sessions instead of duplicating them, and perform background work without disrupting the current session.
Key Features
Use Cases
- 01Enable AI coding assistants to start development sessions in the correct project context automatically
- 02Jump between frequently-used projects using zoxide frecency scoring and fuzzy matching
- 03Create git worktrees for GitHub issues or PRs and connect to them as tmux sessions in one step
- 04Configure project-specific startup commands and window layouts that activate on session creation
- 05Manage multiple tmux sessions and windows through an interactive picker with preview pane
- 06Switch between work and personal project configurations using session aliases and wildcards
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
sesh — FAQ
What is the sesh agent skill?+
The sesh agent skill teaches AI coding assistants like Claude Code and Cursor to manage tmux sessions intelligently using sesh, instead of shelling out to raw tmux commands. It enables agents to resolve session names, reuse existing sessions, and perform background work without disrupting your current context.
How do I install the sesh agent skill?+
Install it globally with 'npx skills add joshmedeski/sesh -g' or into a specific project with 'npx skills add joshmedeski/sesh'. The skills CLI will ask which agents to install to, or use '-a claude-code' to specify. Alternatively, copy skills/sesh/SKILL.md to ~/.claude/skills/sesh/SKILL.md manually.
Which AI coding assistants work with the sesh skill?+
The skill works with Claude Code, Codex, Cursor, OpenCode, and dozens of other agents supported by the skills CLI. Any agent that reads skills from the standard skills directory can use it.
What are the prerequisites for using sesh?+
You need tmux installed for session management and zoxide installed and configured for directory navigation. The agent skill itself has no additional API keys or authentication requirements.
Is sesh free to use?+
Yes, sesh is open-source software released under the MIT license and available for free. It can be installed via Homebrew, Go, Conda, Nix, AUR, and other package managers.
How do I configure sesh for my projects?+
Create a sesh.toml file in ~/.config/sesh/ with [[session]] blocks for specific projects or [[wildcard]] patterns for groups of projects. You can define startup commands, preview commands, icons, and window layouts for each configuration.
How do I install sesh?+
Open the source repository on GitHub and follow its README. sesh is a skill — MCP Agents Market links you directly to the official repo.
Is sesh free?+
sesh is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.