Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gabrielfu/agora
Terminal based API client
https://github.com/gabrielfu/agora
api-client bubbletea go http testing
Last synced: 25 days ago
JSON representation
Terminal based API client
- Host: GitHub
- URL: https://github.com/gabrielfu/agora
- Owner: gabrielfu
- Created: 2024-06-10T12:04:38.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-10-24T08:00:09.000Z (3 months ago)
- Last Synced: 2024-10-24T20:07:29.555Z (3 months ago)
- Topics: api-client, bubbletea, go, http, testing
- Language: Go
- Homepage:
- Size: 2.63 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Agora - Terminal based API client
Agora is a simple and basic app that lets you build API requests on the terminal.
Inspired by [lazygit](https://github.com/jesseduffield/lazygit) and [Postman](https://www.postman.com).
Powered by [Bubble Tea](https://github.com/charmbracelet/bubbletea).
This tool is intended for backend developers who are prototyping API servers and want to
quickly and repeatedly test out their endpoints, without ever leaving their terminal or IDE.
If you need a more robust and full feature API client, you may want to use
something like Postman or Bruno.
All data are saved locally in your machine.
https://github.com/user-attachments/assets/a70e0878-d1b4-4977-8043-249830afb623
### Installation
#### Binary Release
For Windows, MacOS and Linux, you can download from [GitHub release page](https://github.com/gabrielfu/agora/releases)
#### Install from Source
```shell
go install github.com/gabrielfu/agora
```
### Usage
Run `agora` anywhere. Data will be saved in the default directory `$HOME/.agora`.
```shell
agora
```
Alternatively, you can save your data in your project directory to have a separate workspace.
```shell
# this will read and write data to `./.agora`
agora .
# this will read and write data to `/another/project/.agora`
agora /another/project
```
### Features
- [X] Send HTTP requests (only JSON body supported)
- [X] Multiple collections
- [X] All data saved locally
- [X] Support Linux, MacOS and Windows
#### Coming Soon
- [ ] Response history
- [ ] Authentication helper
- [ ] Environments
- [ ] Request timeout
- [ ] File upload
- [ ] Non JSON body