Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

inspectkit

Agentic-first HTTP inspection and API testing service. Make HTTP requests, inspect responses, save request templates, and browse request history. Plain text API, agent-driven, single Go binary with JSON file storage.

Quick Start

# Build and run
make build && ./inspectkit

# Or with Go directly
CGO_ENABLED=0 go build -trimpath ./cmd/inspectkit && ./inspectkit

The server starts on :7100 by default.

Auth Flow

# 1. Request OTP
curl -d '[email protected]' http://localhost:7100/auth/request

# 2. Verify OTP (check stderr for the code in dev mode)
curl -d '[email protected] code=123456' http://localhost:7100/auth/verify
# → token=abc123...

# 3. Use the token
curl -H 'Authorization: Bearer abc123...' http://localhost:7100/templates

API Reference

POST /inspect

Make an HTTP request and inspect the response.

curl -H 'Authorization: Bearer TOKEN' \
  -d 'method=GET url=https://httpbin.org/get headers=Accept=application/json' \
  http://localhost:7100/inspect
# → handle=log_xxxx method=GET url=https://httpbin.org/get status=200 status_text=200 OK duration=123 body_size=1024

POST /templates

Save a reusable request template.

curl -H 'Authorization: Bearer TOKEN' \
  -d 'name=Health Check method=GET url=https://api.example.com/health tags=prod,health' \
  http://localhost:7100/templates
# → handle=req_xxxx name=Health Check method=GET url=https://api.example.com/health

GET /templates

List all templates.

GET /templates/{handle}

Get a single template.

DELETE /templates/{handle}

Delete a template.

GET /history

List request history (newest first).

GET /history/{handle}

Get full details of a request record.

DELETE /history/{handle}

Delete a request record.

GET /audit

List audit log entries.

GET /help

Self-documenting operating manual (also at /.well-known/agent.md).

POST /mcp

MCP JSON-RPC 2.0 endpoint for chat client integrations.

Configuration

Flag Env Default Description
-addr INSPECTKIT_ADDR :7100 Listen address
-db INSPECTKIT_DB inspectkit.json Data file path
-secret INSPECTKIT_SECRET (auto-generated) Token signing secret

Build

make build    # CGO_ENABLED=0 go build -trimpath
make test     # go test -race
make vet      # go vet

License

MIT

About

Agentic-first HTTP inspection and API testing service. Make HTTP requests, inspect responses, save request templates, and view request history. Plain text API, agent-driven, single Go binary with JSON file storage.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages