# Restish

> Use this skill when the user wants to interact with REST APIs, send HTTP requests, or test API endpoints from the command line with schema-aware completion.

- Skill: `javimosch/restish` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/restish`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/restish/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/restish

---


# restish Plugin

CLI for interacting with REST-ish APIs. A user-friendly HTTP client with built-in API schema discovery, JSON navigation, and convenient resource management.

## Commands

### API Requests
- `restish api get` — Send GET request to API
- `restish api post` — Send POST request to API

### Utility
- `restish _ _` — Passthrough to restish CLI

## Usage Examples
- "Send GET request to API"
- "POST data to endpoint"
- "Test REST API"
- "API client from CLI"

## Installation

```bash
brew install restish
```

Or via Go:
```bash
go install github.com/rest-sh/restish@latest
```

## Examples

```bash
# GET request
restish api get https://api.example.com/users

# GET with query params
restish api get /users --query page=1 --query limit=10

# POST request
restish api post /users --body '{"name":"John"}'

# With custom headers
restish api get /users --header "Authorization: Bearer token"

# Any restish command with passthrough
restish _ _ get https://api.example.com
curl _ _ post /items --body '{"key":"value"}'
```

## Key Features
- **Schema** - OpenAPI discovery
- **Auto-complete** - Shell completion
- **JSON** - JSON navigation
- **Resources** - Resource management
- **Auth** - Authentication helpers
- **Headers** - Custom headers
- **History** - Request history
- **Export** - Export to curl
- **Pretty** - Pretty printing
- **Colors** - Syntax highlighting

## Notes
- Supports OpenAPI schemas
- Great for API exploration
- Shell auto-completion
- Human-friendly output