# cielago

![cover](https://files.stevedylan.dev/cielago-demo.jpg)

Like Postman but it actually works. Terminal native HTTP request builder with OpenAPI support.

<details>

<summary>Video Overview</summary>

<iframe width="560" height="315" src="https://www.youtube.com/embed/Jv6O-_WH3N8?si=Os5WNOyLasV69oEC" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

</details>

## Features

- **OpenAPI 3.x import** — turn a spec (file or URL) into a collection with requests, params, example bodies, servers, and docs prefilled.

- **Ad-hoc collections** — no spec needed; paste a full URL and it's split into server, path, and query params for you.

- **Vim-style TUI** — three panes (requests / editor / response), `j`/`k` navigation, `:` command line, `/` incremental search.

- **Variables** — `{{name}}` from the collection, plus dynamic ones like `{{uuid}}`, `{{timestamp}}`, `{{randomInt(1,100)}}`.

- **Auth per collection** — a fixed bearer token, an API key in a header of your choice, or the OAuth2 client-credentials flow (tokens cached in memory only). Press `A` to configure.

- **Secrets from your shell** — any secret field (bearer token, API key, OAuth client secret) can be a `$(…)` command, resolved at send time, e.g. `$(op read "op://vault/item/field")`.

- **Server switcher** — swap base URLs so requests stay portable across envs.

- **Syntax highlighting** — JSON and XML in both request bodies and responses.

- **Plain JSON storage** — collections live in `~/.config/cielago/collections/`.

## Installation

### Homebrew

```sh

brew install stevedylandev/tap/cielago

```

### Cargo 

```bash

cargo install cielago

```

### Prebuilt binaries

Grab a binary for your platform from the [releases page](https://github.com/stevedylandev/cielago/releases), or run the install script:

```sh

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/stevedylandev/cielago/releases/latest/download/cielago-installer.sh | sh

```

### From source

```sh

cargo install --path .

```

Or build without installing:

```sh

cargo build --release

./target/release/cielago --help

```

## Usage

```sh

cielago                          # open the last-used collection in the TUI

cielago open [name]              # open a specific collection

cielago import <spec|url>        # import an OpenAPI 3.x spec

cielago new <name> [--server u]  # create an empty collection and open it

cielago list [-l]                # list collections (-l adds counts + paths)

cielago info <name>              # servers, counts, auth, groups

cielago edit <name>              # edit the collection JSON in $EDITOR

cielago rename <name> <new>      # rename a collection and its file

cielago delete <name> [-f]       # delete a collection

cielago path <name>              # print the collection's JSON path

```

`<name>` matches loosely — `Some API`, `some api`, and `some-api` all resolve to the same collection.

### Keys

| Key | Action |

|---|---|

| `1`/`2`/`3`, `Tab` | Focus sidebar / editor / response |

| `z` | Maximize focused pane |

| `[` / `]` | Previous / next editor tab |

| `Enter` | Send request |

| `/` | Search requests |

| `E` / `A` | Servers / OAuth config |

| `:` | Command line (`:w`, `:q`, `:new`, `:open`, …) |

| `?` | Help |

| Context | Keys |

|---|---|

| Sidebar | `n`/`r`/`d`/`y` new/rename/delete/duplicate, `t` cycle label source |

| Tables | `space` toggle row, `i` edit, `a` add, `d` delete, `m` cycle method, `p` edit URL |

| Body/response | `e` open in `$EDITOR`, `j`/`k`/`d`/`u`/`g`/`G` scroll |

Press `?` in the TUI for the full list.

## Development

```sh

cargo build

cargo test

cargo clippy --all-targets

cargo fmt

```

## License

[MIT](LICENSE)