Skip to main content
hitspec studio is a keyboard-first interactive terminal app for working with hitspec files. It uses the same parser, runner, history store, stress engine, mock server, recorder, and import/export code as the CLI.
studio edits normal .http / .hitspec files on disk. There is no separate project format, and saved files stay version-control friendly.

​
Start the app

hitspec studio
hitspec studio ./tests/api/
hitspec studio ./tests/api/users.http
It runs directly in the terminal — no browser, no port. When you need the REST/WebSocket API for integrations, use the server instead: 
hitspec serve --api-only --port 4000 --cors

​
Keyboard Workflow

KeyAction
Ctrl+POpen the command palette
1 - 9Navigate between screens
Tab / Shift+TabMove focus between panes
EnterOpen the selected file or command
eEdit the active file inline
Ctrl+SSave source changes
rRun the selected request
RRun every request in the file
Ctrl+RRefresh workspace data
?Toggle expanded help
qQuit

​
Workspace

The workspace screen is compact and responsive:
  • File list with search/filter from the Bubbles list component
  • Parsed request table with method and URL
  • Inline source editor powered by Bubbles textarea
  • Response viewport with body, errors, timings, and assertion status
  • Headers and assertions tables
  • Bottom status bar with environment, progress, and help
Wide terminals show file, source, and response panes together. Medium terminals keep the file list plus one main pane. Narrow terminals switch to a single-pane tabbed workflow through focus changes.

​
Secondary Screens

studio maps the former manager routes to terminal screens:
  • Stress: quick-start load tests, live RPS/error/latency metrics, and profile persistence
  • Mock: start/stop the mock server and inspect registered routes
  • Contract: verify selected contract files against a provider URL
  • Record: start/stop the recording proxy, inspect captured traffic, and export recordings
  • History: browse persistent SQLite-backed runs and request results
  • Import: convert cURL, Insomnia, OpenAPI, and Postman input into hitspec content
  • Cookies: inspect the local cookie store captured from responses; cookies are not injected automatically
  • Settings: edit config and environment values that persist to hitspec.yaml

​
API-Only Mode

hitspec serve --api-only keeps the REST API and WebSocket endpoints for scripts and integrations. The web SPA is no longer served; non-API browser routes are not part of serve. 
hitspec serve --api-only --host localhost --port 4000
The API remains under /api/v1/*, with realtime events at /api/v1/ws.