chiko

README

🐶 Chiko - Beautiful gRPC TUI Client

The developer-friendly terminal interface for gRPC that makes API testing a joy

---

🎯 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 and the elegance of 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)

brew install felangga/chiko/chiko

🐹 Go Install

go install github.com/felangga/chiko/cmd/chiko@latest

🔧 From Source

git clone https://github.com/felangga/chiko
cd chiko
go run ./...

📥 Pre-built Binaries

Download the latest release from our Release Page for your platform and architecture.

🎮 Quick Start

1. Launch Chiko

   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 to get started.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• grpcurl - The powerful gRPC command-line tool
• tview - The amazing TUI library for Go
• All our contributors who make this project better

---

Made with ❤️ by developers, for developers

⭐ Star us on GitHub | 🐛 Report Issues | 💬 Discussions