Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gabrielalmir/witch

Witch is a command-line application that allows you to search for trending repositories on GitHub. It is built using the Bubble Tea framework for creating rich terminal user interfaces.
https://github.com/gabrielalmir/witch

Last synced: about 1 month ago
JSON representation

Witch is a command-line application that allows you to search for trending repositories on GitHub. It is built using the Bubble Tea framework for creating rich terminal user interfaces.

Awesome Lists containing this project

README

        

# Witch

Welcome to **Witch**! This project is a terminal-based application that allows you to search for GitHub repositories using the GitHub API. It is built with Go and uses the Bubble Tea framework for the interactive terminal UI.

## Features

- **Search Repositories**: Search for GitHub repositories by typing your search term.
- **Navigate Results**: Use arrow keys to navigate through the search results.
- **Pagination**: Easily navigate through multiple pages of search results.
- **Copy Repository URL**: Copy the URL of the selected repository to your clipboard.

## Installation

To get started with Witch, follow these steps:

1. **Clone the repository**:
```sh
git clone https://github.com/gabrielalmir/witch.git
cd witch
```

2. **Install dependencies**:
```sh
go mod tidy
```

3. **Run the application**:
```sh
go run main.go
```

## Usage

Once the application is running, you can use the following commands:

- **Type your search term**: Start typing to enter your search term.
- **Press Enter**: Cast the search spell and fetch repositories.
- **Press ESC**: Return to search mode to enter a new search term.
- **Use ↑/↓**: Navigate through the list of repositories.
- **Use →/←**: Change pages to see more results.
- **Press C**: Copy the URL of the selected repository to your clipboard.
- **Press Q**: Quit the application.