.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "AKA" "7" "March 2014" "" ""
.
.SH "NAME"
\fBaka\fR \- Manage Shell Keyboard Shortcuts
.
.SH "SYNOPSIS"
\fBaka\fR add \fIshortcut\fR \fIcommand\fR [options]
.
.br
\fBaka\fR show \fIshortcut\fR [options]
.
.br
\fBaka\fR edit \fIshortcut\fR [options]
.
.br
\fBaka\fR remove \fIshortcut\fR
.
.br
\fBaka\fR list [options]
.
.br
\fBaka\fR link [options]
.
.br
\fBaka\fR generate [options]
.
.br
\fBaka\fR sync
.
.SH "DESCRIPTION"
\fBaka\fR is an easy way to manage keyboard shortcuts in UNIX shells\.
.
.P
You can replace commonly used commands with shorter, sexier keyboard shortcuts and, ultimately, improve your productivity!
.
.P
With \fBaka\fR, you can add, show, edit, remove, list keyboard shortcuts\. On top of that you can tag shortcuts based on environment, tool, context, etc\. Then, you can generate an appropriate output file for your environment\.
.
.SH "OPTIONS"
.
.TP
\fB\-\-help\fR:
.
.br
Show help info

.
.TP
\fB\-\-version\fR:
.
.br
Show version info

.
.TP
\fB\-\-log\-level=<debug|info|warn|error|fatal>\fR:
.
.br
Set the logging level (Default: info)

.
.SH "EXAMPLES"
Add a keyboard shortcut and generate the output script:
.
.IP "" 4
.
.nf

$ aka add ls "ls \-F \-\-color=auto"
Created shortcut\.
$ aka generate
alias ls="ls \-F \-\-color=auto"
.
.fi
.
.IP "" 0
.
.P
Add a keyboard shortcut for a bash/zsh function:
.
.IP "" 4
.
.nf

$ aka add psf "ps aux | grep $@" \-\-function
Created shortcut\.
$ aka generate
function psf {
  ps aux | grep $@
}
.
.fi
.
.IP "" 0
.
.P
Generate to a file instead:
.
.IP "" 4
.
.nf

$ aka generate \-o ~/\.aka\.zsh
Generated ~/\.aka\.zsh\.
.
.fi
.
.IP "" 0
.
.P
Tag a shortcut and generate for OS X:
.
.IP "" 4
.
.nf

$ aka add ls "ls \-F \-\-color=auto" \-\-tag os:linux
Created shortcut\.
$ aka add ls "ls \-FG" \-\-tag os:darwin
Created shortcut\.
$ aka generate \-\-tag os:darwin
alias ls="ls \-FG"
.
.fi
.
.IP "" 0
.
.P
Edit a shortcut:
.
.IP "" 4
.
.nf

$ aka edit ls "ls \-F \-\-color=auto" \-\-tag os:linux
1 Shortcut: ls
2 Description:
3
4 Function (y/n): n
5 Tags: os:linux
6 Command:
7 ls \-FG
/var/folders/rj/8bjyj6x92l9bxykxc_ljyqsc0000gp/T/shortcut20140222\-63006\-13csxr0" 7L, 87C
$ :wq
.
.fi
.
.IP "" 0
.
.P
Remove a shortcut:
.
.IP "" 4
.
.nf

$ aka remove ls
Removes shortcut\.
.
.fi
.
.IP "" 0
.
.P
Add a link:
.
.IP "" 4
.
.nf

$ aka link \-\-tag os:linux \-\-output ~/\.aka\.zsh
Saved link\.
.
.fi
.
.IP "" 0
.
.P
Remove a link:
.
.IP "" 4
.
.nf

$ aka link \-\-delete \-\-tag os:linux \-\-output ~/\.aka\.zsh
Removed link\.
.
.fi
.
.IP "" 0
.
.P
Synchronize links:
.
.IP "" 4
.
.nf

$ aka link \-\-tag os:linux \-\-output ~/\.aka\.zsh
Saved link\.
$ aka sync
Generated ~/\.aka\.zsh\.
4 shortcut(s) excluded (#linux)\.
.
.fi
.
.IP "" 0
.
.P
Upgrade links from v0 to v1:
.
.IP "" 4
.
.nf

$ aka upgrade
Upgraded ~/\.aka\.yml\.
Backed up to ~/\.aka\.yml\.backup\."
.
.fi
.
.IP "" 0
.
.SH "ENVIRONMENT"
.
.TP
\fBAKA\fR:
.
.br
The file where \fBaka\fR stores everything\. Default: ~/\.aka\.yml