https://github.com/felangga/chiko
The ultimate beauty gRPC Client on your Terminal!
https://github.com/felangga/chiko
golang grpc-client tui
Last synced: 27 days ago
JSON representation
The ultimate beauty gRPC Client on your Terminal!
- Host: GitHub
- URL: https://github.com/felangga/chiko
- Owner: felangga
- License: mit
- Created: 2022-12-27T06:46:30.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-09-26T15:00:00.000Z (about 2 months ago)
- Last Synced: 2025-10-21T03:57:14.212Z (27 days ago)
- Topics: golang, grpc-client, tui
- Language: Go
- Homepage:
- Size: 12.7 MB
- Stars: 310
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tuis - chiko
- awesome-cli-apps-in-a-csv - chiko - The ultimate beauty gRPC Client on your Terminal: a simple tool to interact with gRPC services using a beautiful terminal interface. (<a name="networking"></a>Networking)
README
# 🐶 Chiko - Beautiful gRPC TUI Client
**The developer-friendly terminal interface for gRPC that makes API testing a joy**
[](https://golang.org)
[](LICENSE)
[](https://github.com/felangga/chiko/releases)
[](https://github.com/felangga/chiko/stargazers)
---
## 🎯 Why Chiko?
Tired of memorizing complex `grpcurl` commands? Fed up with switching between terminal and documentation? **Chiko** transforms your gRPC testing experience into something beautiful and intuitive.
Built with the power of [grpcurl](https://github.com/fullstorydev/grpcurl) and the elegance of [tview](https://github.com/rivo/tview), Chiko brings you a stunning terminal interface that makes gRPC testing feel like magic ✨
## 🚀 What Makes Chiko Special
### 🔍 **Smart Server Reflection**
Discover and browse gRPC endpoints automatically! No more digging through documentation - if your server supports reflection, Chiko shows you everything at a glance.
### 🔐 **Seamless Authorization**
Secure your requests with built-in Bearer token support. Authentication made simple and secure.
### 📋 **Rich Metadata Support**
Add custom headers and metadata to your requests with an intuitive interface. No more command-line gymnastics!
### ⚡ **Instant Payload Generation**
Get perfectly formatted request templates with a single click. Say goodbye to manual JSON crafting!
### 📚 **Smart Bookmarks**
Save your favorite requests as bookmarks and replay them instantly. Perfect for API regression testing and development workflows.
## 📦 Installation
Choose your preferred installation method:
### 🍺 Homebrew (Recommended)
```bash
brew install felangga/chiko/chiko
```
### 🐹 Go Install
```bash
go install github.com/felangga/chiko/cmd/chiko@latest
```
### 🔧 From Source
```bash
git clone https://github.com/felangga/chiko
cd chiko
go run ./...
```
### 📥 Pre-built Binaries
Download the latest release from our [Release Page](https://github.com/felangga/chiko/releases) for your platform and architecture.
## 🎮 Quick Start
1. **Launch Chiko**
```bash
chiko
```
2. **Connect to your gRPC server**
- Enter your server URL
- Set up authentication if needed
- Browse available services via reflection
3. **Make your first request**
- Select a method from the sidebar
- Generate a sample payload
- Hit send and see the magic! ✨
## 🗺️ Roadmap
### ✅ Completed
- ~~Metadata and headers support~~
- ~~Log dumping to file~~
- ~~Import/export grpcurl commands~~
### 🚧 In Progress
- 📄 **Proto file import** - Support for services without reflection
- 🔒 **Enhanced authentication** - OAuth, API keys, and more
- 🛡️ **Bookmark security** - Password protection for sensitive requests
### 💡 Future Ideas
- 🎨 **Themes and customization**
- 📊 **Request analytics and performance metrics**
- 🔄 **Request history and replay**
- 🌐 **Multi-server workspace management**
---
## 🤝 Contributing
We love contributions! Whether it's:
- 🐛 Bug reports
- 💡 Feature requests
- 📖 Documentation improvements
- 🔧 Code contributions
Check out our [contributing guidelines](CONTRIBUTING.md) to get started.
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [grpcurl](https://github.com/fullstorydev/grpcurl) - The powerful gRPC command-line tool
- [tview](https://github.com/rivo/tview) - The amazing TUI library for Go
- All our [contributors](https://github.com/felangga/chiko/contributors) who make this project better
---
**Made with ❤️ by developers, for developers**
[⭐ Star us on GitHub](https://github.com/felangga/chiko) | [🐛 Report Issues](https://github.com/felangga/chiko/issues) | [💬 Discussions](https://github.com/felangga/chiko/discussions)