carapace-sh/carapace-bin / skills/httpie
httpie
UnverifiedUse when working with HTTPie (http/https CLI) — the command-line HTTP client for the API era. Covers request items syntax (headers, params, data fields, file uploads), authentication (basic, digest, bearer, plugins), session management, output formatting and printing, SSL/TLS configuration, download mode, configuration files, environment variables, plugin system, exit codes, scripting, and URL syntax. Triggers on: "httpie", "http command", "https command", "http --json", "http --form", "http --download", "http --session", "http --auth", "http --auth-type", "http --print", "http --verbose", "http --follow", "http --offline", "http --check-status", "http --proxy", "http --ssl", "http --cert", "http --verify", "http --format-options", "http --pretty", "http --style", "http --stream", "http --boundary", "http --multipart", "http --raw", "httpie config", "HTTPIE_CONFIG_DIR", "httpie cli plugins", "request items", "data fields", "URL parameters", "HTTP headers", "raw JSON fields", "file upload fields", "named session", "anonymous session", "read-only session", "Content-Disposition", "httpie-unixsocket", "httpie plugins", "AuthPlugin", "TransportPlugin", "ConverterPlugin", "FormatterPlugin".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| references/auth.md | markdown | 3.3 KB |
| references/cli.md | markdown | 6.6 KB |
| references/config.md | markdown | 4.0 KB |
| references/downloads.md | markdown | 3.7 KB |
| references/output.md | markdown | 6.1 KB |
| references/plugins.md | markdown | 5.6 KB |
| references/request-items.md | markdown | 4.9 KB |
| references/scripting.md | markdown | 3.7 KB |
| references/sessions.md | markdown | 5.0 KB |
| references/ssl.md | markdown | 2.8 KB |
| references/url-syntax.md | markdown | 3.5 KB |
references/ssl.md
View on GitHub# SSL/TLS Configuration
HTTPie's SSL/TLS options for certificate verification, protocol versions, ciphers, and client certificates.
## Certificate Verification (`--verify`)
| Value | Description |
|-------|-------------|
| `yes` (default) | Verify the host's SSL certificate against the system CA store |
| `no` (or `false`) | Skip certificate verification |
| `/path/to/ca_bundle` | Use a custom CA bundle file for verification |
```bash
# Skip verification
$ http --verify=no https://self-signed.example.org
# Use custom CA bundle
$ http --verify=/path/to/ca_bundle https://internal.example.org
# Default (verify)
$ https example.org
```
The carapace completer completes `--verify` with `yes` and `no`, styled with `style.ForKeyword` (green/red).
## Protocol Version (`--ssl`)
| Value | Protocol |
|-------|---------|
| `ssl2.3` | SSL 2.3 (default — negotiates highest supported) |
| `ssl3` | SSL v3 (insecure, for legacy servers) |
| `tls1` | TLS 1.0 |
| `tls1.1` | TLS 1.1 |
| `tls1.2` | TLS 1.2 |
| `tls1.3` | TLS 1.3 |
```bash
$ http --ssl=tls1.2 https://example.org
```
The carapace completer completes `--ssl` with `ssl2.3`, `tls1`, `tls1.1`, `tls1.2`. Note: `tls1.3` and `ssl3` are missing from the completer's values.
## Cipher Suites (`--ciphers`)
A string in the OpenSSL cipher list format:
```bash
$ http --ciphers=ECDHE-RSA-AES128-GCM-SHA256 https://example.org
```
Multiple ciphers are colon-separated. The carapace completer has a TODO for cipher completion.
## Client Certificates
| Flag | Description |
|------|-------------|
| `--cert` | Client-side SSL certificate file |
| `--cert-key` | Private key file (if not included in the cert file) |
| `--cert-key-pass` | Passphrase for the private key (auto-prompts if omitted) |
```bash
$ http --cert=client.pem --cert-key=client.key https://mtls.example.org
$ http --cert=client.pem --cert-key=client.key --cert-key-pass=secret https://mtls.example.org
```
If `--cert-key` is omitted, the private key is read from the certificate file (if combined).
The carapace completer completes `--cert` and `--cert-key` with `carapace.ActionFiles()`.
## Environment Variables
| Variable | Description |
|----------|-------------|
| `REQUESTS_CA_BUNDLE` | Path to CA bundle for certificate verification (overrides system default) |
## Edge Cases and Known Issues
- The carapace completer's `--ciphers` completion is a TODO (returns empty `ActionMultiParts`)
- The carapace completer is missing `ssl3` and `tls1.3` from the `--ssl` values
- `--cert-key-pass` is not present in the carapace completer's flag definitions
## References
- Source of truth: <https://httpie.io/docs/cli> (SSL options section)
- Carapace completer: `completers/common/http_completer/cmd/root.go`
## Related Skills
- [cli.md](cli.md) — full flag reference
- [config.md](config.md) — environment variable configuration
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |