https://github.com/pindexis/marker

The terminal command palette
https://github.com/pindexis/marker

Last synced: 21 days ago
JSON representation

The terminal command palette

• Host: GitHub
• URL: https://github.com/pindexis/marker
• Owner: pindexis
• License: mit
• Created: 2015-05-17T18:31:17.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-06T14:43:45.000Z (7 months ago)
• Last Synced: 2024-10-01T13:06:31.859Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 173 KB
• Stars: 2,043
• Watchers: 26
• Forks: 106
• Open Issues: 48
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• my-awesome-starred - marker - The terminal command palette (Python)
• awesome-shell - marker - Bookmark your shell commands (Command-Line Productivity)
• awesome-github-repos - pindexis/marker - The terminal command palette (Python)
• jimsghstars - pindexis/marker - The terminal command palette (Python)

README

        
# Marker

![marker](https://cloud.githubusercontent.com/assets/2557967/14209204/d99db934-f81a-11e5-910c-9d34ac155d18.gif)

Marker is a command palette for the terminal. It lets you bookmark commands (or commands templates) and easily retreive them with the help of a real-time fuzzy matcher.

It's also shipped with many commands common usage(Thanks to [tldr](https://github.com/tldr-pages/tldr)).

  

## Features:

- A UI selector that lets you easily select the desired command if more than one command is matched.

- Fuzzy matching (through commands and their descriptions).

- Command template: You can bookmark commands with place-holders and place the cursor at those place-holders using a keyboard shortcut.

- Portability across supported shells: you can use bookmarked commands in both Bash and Zshell.

## Usage

- `Ctrl-space`: search for commands that match the current written string in the command-line.

- `Ctrl-k` (or `marker mark`): Bookmark a command.

- `Ctrl-t`: place the cursor at the next placeholder, identified by '{{anything}}'

- `marker remove`: remove a bookmark

You can customize key binding using environment variables, respectively with ```MARKER_KEY_GET```, ```MARKER_KEY_MARK``` and ```MARKER_KEY_NEXT_PLACEHOLDER```.

## Requirements

- python (2.7+ or 3.0+)

- Bash-4.3+ or Zshell.

- Linux Or OSX

##### Note:

In OSX, it seems like Bash 3.x is the default shell which is not supported. you have to [update your Bash to 4.3+](http://apple.stackexchange.com/a/24635) or [change your shell to zshell](http://stackoverflow.com/a/1822126/1117720) in order to use Marker.

## Installation

`git clone --depth=1 https://github.com/pindexis/marker ~/.marker && ~/.marker/install.py`

## License

[MIT](LICENSE)