Kivo

A fast, YAML-based API client for developers.

Kivo lets you define reusable API collections, manage environments, and send HTTP requests directly from your terminal—all from within your project.

Features

• 🚀 Project-based configuration
• 🌍 Multiple environments
• 📁 YAML API collections
• 🌐 HTTP GET, POST, PUT, PATCH, DELETE
• 🛣️ Path parameter interpolation
• 📦 JSON request bodies
• 📊 Response status, duration, and size
• 🎨 Pretty JSON output

Why?

Instead of maintaining curl commands or sharing Postman collections, Kivo keeps your API definitions inside your repository.

my-api/
├── src/
├── Cargo.toml
└── .kivo/
    ├── config.toml
    ├── environments.toml
    └── collections/
        └── objects.yaml

Your API configuration lives with your code, making it easier to collaborate and onboard new developers.

---

Installation

Download the latest release for your operating system from the GitHub Releases page.

1. Download the appropriate binary for your platform.
2. Make it executable (Linux/macOS):

chmod +x kivo

3. Move it to a directory in your PATH (optional):

sudo mv kivo /usr/local/bin/

Verify the installation:

kivo --help

macOS

The macOS binaries are currently unsigned. If macOS blocks the application, run:

xattr -d com.apple.quarantine kivo
chmod +x kivo

or choose Open Anyway in System Settings → Privacy & Security.

---

Getting Started

Initialize a project:

kivo init

Create an environment:

kivo env add local https://api.restful-api.dev

Select it:

kivo env use local

Create a collection:

name: objects

commands:
  get:
    method: GET
    path: /objects/{id}

  create:
    method: POST
    path: /objects
    body:
      name: "Apple MacBook"

Run a request:

kivo objects get --id 7

Create a resource:

kivo objects create

---

Roadmap

• Project initialization
• Environment management
• YAML collections
• HTTP requests
• Path parameter interpolation
• JSON request bodies
• Query parameters
• Body interpolation
• Authentication
• Syntax highlighting
• Interactive TUI

---

License

MIT