https://github.com/ryandotsmith/tat

tab completion for tmux sessions
https://github.com/ryandotsmith/tat

Last synced: 2 months ago
JSON representation

tab completion for tmux sessions

• Host: GitHub
• URL: https://github.com/ryandotsmith/tat
• Owner: ryandotsmith
• Created: 2011-11-30T20:37:20.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2017-09-08T00:04:50.000Z (over 7 years ago)
• Last Synced: 2024-10-13T17:47:19.710Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 108 KB
• Stars: 38
• Watchers: 4
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

• awesome-tmux - tat

README

        
TAT(1)

## Name

 tat - tmux attach utility

## Synopsis

**tat [session_name | new_session_name]**

## Description

Tab completion for tmux sessions.

Quickly open new tmux sessions in your project's dir.

## Setup

```bash

git clone git://github.com/ryandotsmith/tat.git ~/path/to/tat

echo "source ~/path/to/tat/tat.sh" >> ~/.bashrc

echo "export CODE_ROOT_DIRS=\"/home/you/code\"" >> ~/.bashrc

echo "export CODE_ROOT_DIRS=\"/home/you/other_code_dir:$CODE_ROOT_DIRS\"" >> ~/.bashrc

```

## Usage

Use the tab key to open an existing session.

```bash

$ tat [TAB]

open_session_1 open_session_2

```

Arguments that are passed to tat will be used to create a new session.

Tat will open a new tmux session and set the default path to the found dir.

```bash

$ tat my_project

$ pwd

/home/you/code/my_project

```

## Motivation

There are popular tmux helpers on github. They require ruby and yaml file. No thanks!

It is my opinion that bash is the right tool for the job here. UNIX doesn't care about yaml.

## Issues

tat(1) assumes you have your code in "root" directories. We use find(1) to scan

(with max-depth=1) the directories to find one that matches your argument to

tat(1).