~mclehman/sessions

6c9dd57a5d8d6af71e0fc96fc467f5af2874fa0b — 0xFORDCOMMA 4 years ago 3d7d5ff
Improve readme clarity.
1 files changed, 10 insertions(+), 10 deletions(-)

M README.md
M README.md => README.md +10 -10
@@ 9,17 9,17 @@ I expand the idea of a tmux session to categorized sessions: foo/bar and foo/baz

`session` can be invoked in three ways:

* `session`  
  Creates or switches to the default session (currently misc/dev, eventually sourced from an environment variable).  
  Equivalent to `tmux switch-client -t misc/dev || tmux attach -t misc/dev || tmux new -s misc/dev`
* `session <category> <session>`  
  Creates or switches to the tmux session `<category>/<session>`.  
* `session`
  Creates or switches to the default session (currently misc/dev, eventually sourced from an environment variable).
  This is equivalent to explicitly invoking `session misc dev`.
* `session <category> <session>`
  Creates or switches to the tmux session `<category>/<session>`.
  Equivalent to `tmux switch-client -t <category>/<session> || tmux attach -t <category>/<session> || tmux new -d -s <category>/<session> && (tmux switch-client -t <category>/<session> || tmux attach -t <category>/<session>)`.
* `session <session>`  
  Searches for a matching session in all categories.  
  If only one is found, it is switched to.  
  If it is ambiguous, options are presented.  
  If no such session is found, no session is created.  
* `session <session>`
  Searches for a matching session in all categories.
  If only one is found, it is switched to.
  If it is ambiguous, options are presented.
  If no such session is found, no session is created.
  No direct tmux analogue, but presumably you wouldn't need to search categories using regular tmux session management.

`sessions` provides a view of the current categories and sessions. Currently this is done using the unicode box drawing characters but a later version will likely add a user configurable option to control this and default to a more compact layout.