Termorq

API connections

Mon, 01 Jan 0001 00:00:00 +0000

A connection and an endpoint are separate. One connection (base URL and auth) is reused by many endpoints.

@create api asks for the name, the base URL, and the auth. When Settings has environments or customers, the form asks for those too. A new connection starts on the header choice. Changing only the environment or the customer does not require another test after the current values have already passed.

Test connection sends GET to the base URL. Any HTTP status, including 401 or 404, enables Save. DNS failure, connection refused, timeout, or a failed token request does not.

Browse and edit

Mon, 01 Jan 0001 00:00:00 +0000

Library on the rail, @library, or Cmd+Shift+L (Ctrl+Shift+L on Windows and Linux) lists everything saved: MCP servers, API connections, endpoints, OpenAI connections, and collections.

Library. Filter by kind, search by name, then Edit, Duplicate, Export, or Delete. Secrets stay in the OS keychain.

Filter by name or by kind. The counts on the chips are what is on this machine.

Action	What it does
Edit	Opens the same editor as `@edit name`
Duplicate	Makes `<name> (copy)`. When the original has a stored secret, the app asks whether the copy should reuse it or start without one
Export	Writes that row’s transfer file. See Share a file
Delete	Removes it, with Undo in a toast

@edit Users API
@edit List users
@library

@edit name opens the editor for a server, an API, an endpoint, an OpenAI connection, or a collection. A blank secret on edit keeps the stored one.

Commands

Mon, 01 Jan 0001 00:00:00 +0000

Some commands depend on the edition compiled into the app or termorq-cli. See the Free and Pro feature breakdown; termorq-cli has no edition switch.

@ opens the commands palette. Type to filter. Entries from commands.yaml follow these built-ins. @history is always available and is not a line in that file.

The shortcuts dialog lists the same triggers. The shot is the macOS wording.

Cmd+/ opens Shortcuts. The @ triggers and the call flags are the same list as this page.

Install and run

Mon, 01 Jan 0001 00:00:00 +0000

Termorq is a desktop app. Version 0.20.0 is the version in src-tauri/tauri.conf.json. The header, termorq-cli --version, and package.json read that same value.

You need Node.js 20 or newer, pnpm 10, and Rust 1.90 or newer (stable). Tauri 2.12 requires that Rust version.

Model connections

Mon, 01 Jan 0001 00:00:00 +0000

@create openai
@openai

@create openai asks for a name, a provider, an endpoint, a model or deployment, an API key, and an optional system prompt.

Provider	What you fill in
Azure OpenAI	The resource endpoint, the deployment name, and the key. This is the default. Existing connections stay Azure
OpenAI or compatible	A base URL (blank means `https://api.openai.com/v1`), a model, and a key sent as a Bearer token. The key is optional for a local server

Ollama, LM Studio, vLLM, and a gateway work as the compatible base URL. Both Azure URL styles are accepted: an endpoint that contains /openai/v1, and a classic deployment host.

On this machine

Mon, 01 Jan 0001 00:00:00 +0000

A secret is a value. A name, a {{placeholder}}, and a vault reference are not. The app stores the value in the OS keychain and keeps the name in the file you might commit.

flowchart LR
 field["A secret field"]:::step
 ref{"akv:// or op://?"}:::gate
 vault[("Vault")]:::secret
 chain[("OS keychain")]:::store
 sent["The call"]:::out

 field --> ref
 ref --> vault --> sent
 ref --> chain --> sent

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef secret fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef gate fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 linkStyle 0 stroke:#5eead4,stroke-width:2.5px
 linkStyle 1,2 stroke:#FFC131,stroke-width:2.5px
 linkStyle 3,4 stroke:#67e8f9,stroke-width:2.5px

The keychain

API keys, bearer tokens, basic passwords, client secrets, the OpenAI key, the MCP Azure client secret, and stdio env values whose names look like secrets use the OS keychain. The service name is com.garrardkitchen.ai-terminal.

Open, save, status, close

Mon, 01 Jan 0001 00:00:00 +0000

Team workspace is a Pro feature. The @workspace commands are available in Pro builds; Free builds keep local definitions and collections.

A team workspace is a folder in a git checkout. The app reads and writes <folder>/.ai-terminal/ and never runs git commit or git push.

@workspace open ~/src/acme-apis
@workspace
@workspace status
@workspace save
@workspace close

@workspace with no verb is status. Settings → Team workspace → Open folder is the same open. workspace in the @ palette opens the same commands.

Preferences

Mon, 01 Jan 0001 00:00:00 +0000

Settings on the rail, or the avatar, opens in the terminal column. The page says Saved on this machine.

Settings in version 0.20.0. Environments and customers are empty until you add a name, so the header hides those dropdowns.

Primary email

An address stored on this machine loads that Gravatar in place of the initials. If the address is empty, or Gravatar has no photo, the initials stay. The shot above shows GK.

Run a collection

Mon, 01 Jan 0001 00:00:00 +0000

Running collections as runbooks is a Pro feature. Free builds can still list collections with termorq-cli list and inspect them with termorq-cli show. The available commands follow the edition compiled into termorq-cli; the CLI has no edition flag or runtime switch.

termorq-cli runs a saved collection without opening Termorq. It uses the same HTTP calls, variables, response checks, and captures as the app. Version 0.20.0 prints termorq-cli 0.20.0.

The screenshots on this page are the real binary, taken against a sample workspace at /tmp/acme-apis. That workspace points Users API at mock://users, the app’s offline demo host, so nothing left the machine. A secret named in the prompt is shown as …. The value never appears in the output.

Servers

Mon, 01 Jan 0001 00:00:00 +0000

@create mcp is one form and three transports.

Transport	You provide
HTTP	The endpoint. No credentials, or an optional OAuth client id for servers that do not register clients
Azure client credentials	Tenant id, client id, client secret, scope
stdio	Command, arguments, working directory, and env

When Settings has environments or customers, the form asks for those too. A new server starts on the header choice. Changing only the environment or the customer does not require another test after the current values have already passed.

The prompt

Mon, 01 Jan 0001 00:00:00 +0000

You type in one place. The first characters decide what runs. The accent caret follows the insertion point as you edit the line.

flowchart LR
 line["The line you type"]:::step
 shell["Shell"]:::out
 endpoint["@endpoint"]:::step
 tool["@tool"]:::store
 skill["/ skill"]:::gate
 model{"@chat # @agent"}:::gate

 line --> shell
 line --> endpoint
 line --> tool
 line --> skill
 line --> model

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef gate fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 linkStyle 0,2 stroke:#5eead4,stroke-width:2.5px
 linkStyle 1 stroke:#67e8f9,stroke-width:2.5px
 linkStyle 3,4 stroke:#FFC131,stroke-width:2.5px

You type	What runs
`git status`	The tab’s shell. Output streams in. `cd` and `export` carry to the next line on bash, zsh, sh, and PowerShell
`@endpoint List users`	A saved HTTP call
`@tool search --query tea`	An MCP tool on a server connected to this tab
`/explain how to make tea`	A skill from `skills.yaml`
`@chat why was that empty?`	The tab’s model, with recent scrollback. It can call this tab’s MCP tools and saved endpoints; you approve each call
Agent on, then `why was that empty?`	The same chat, without typing `@chat`. A line that starts with `@` still runs
`# find files over 100 MB here`	The model writes one command into the prompt. You press Enter
`@history`	The history overlay for this tab

@ opens the commands palette. / opens the skills palette. Both filter as you type. In the commands palette, exact and leading name matches appear before other name matches, and all name matches appear before description matches. Built-in @ actions are listed in Commands. Entries from commands.yaml follow them. @history is always first and is not a YAML entry.

The shelf

Mon, 01 Jan 0001 00:00:00 +0000

Collections are lines you already run: a shell line, an @endpoint call, or an @tool call. Collections on the rail, or Cmd+Shift+B (Ctrl+Shift+B on Windows and Linux), opens the shelf in the terminal column and hides the prompt. Press the shortcut again, or Esc, to return.

Collections in the desktop window. The shelf is empty until you collect a line. This shot is the frontend, so the shell underneath is the browser build.

Ask the model

Mon, 01 Jan 0001 00:00:00 +0000

Each of these uses the OpenAI connection selected on the current tab. Nothing is sent when that pill says none.

flowchart LR
 you["You"]:::step
 approve{"You approve?"}:::gate
 model["The tab's model"]:::out
 tools[("MCP tools\nand endpoints")]:::store
 prompt["A command\nin the prompt"]:::step

 you --> model
 model --> approve
 approve --> tools
 tools --> model
 model --> prompt

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef gate fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 linkStyle 0,2,3 stroke:#5eead4,stroke-width:2.5px
 linkStyle 1,4 stroke:#FFC131,stroke-width:2.5px

@chat

@chat why did that return an empty list?
@chat
@chat clear

@chat <question> sends the question with the newest scrollback, up to about 8,000 characters, secrets masked. The tab remembers the last 20 turns. After each answer you see the tokens in and out and the chat’s running total. They are marked ≈ when the provider does not report usage. @chat on its own shows the total. @chat clear starts again.

Auth

Mon, 01 Jan 0001 00:00:00 +0000

@create api offers seven auth kinds. The secret fields follow the kind. A blank secret on a later edit keeps the stored one.

Kind	What you fill in	Where the secret lives
None	Base URL only	Nowhere
API key	Header name, default `X-Api-Key`, and the key	Keychain, or a vault reference
Bearer	The token	Keychain, or a vault reference
Basic	Username and password	Password in the keychain, or a vault reference
Client credentials	Azure tenant id, client id, client secret, scope	Client secret in the keychain, or a vault reference
OAuth (browser)	Authorization URL, token URL, client id, optional client secret	Tokens in memory. Optional secret in the keychain
OAuth (device code)	Token URL, device URL, client id, optional client secret	Tokens in memory. Optional secret in the keychain

Client credentials are the Azure app-only flow: the app asks Entra for a token with the tenant, the client id, and the secret, then sends that token on the call.

Keyboard

Mon, 01 Jan 0001 00:00:00 +0000

Cmd+/ on macOS, or Ctrl+/ on Windows and Linux, opens the shortcuts dialog. Press it again, or Esc, to close. The header hint (⌘/ help or Ctrl+/ help) opens the same dialog.

The dialog in the macOS app. Windows and Linux show Ctrl where this shot shows Cmd, for the shortcuts that the dialog remaps.

The labels below are the macOS ones from that dialog. Where a row says Cmd, Windows and Linux use Ctrl for that shortcut, except Ctrl+C, Ctrl+Tab, Ctrl+wheel, and Ctrl+0, which stay Ctrl on every platform. Ctrl+Shift+C copies inside the interactive terminal. On macOS the normal copy shortcut is Cmd+C.

OAuth sign-in

Mon, 01 Jan 0001 00:00:00 +0000

An HTTP MCP server that answers 401 is ready for sign-in. You do not fix that in the create form.

@mcp signin Docs
@mcp signout Docs

@mcp signin <server> finds the authorization server from the WWW-Authenticate resource_metadata link (protected resource metadata, RFC 9728), and falls back to the well-known URLs. It then reads /.well-known/oauth-authorization-server (RFC 8414), then OpenID discovery.

If the server offers dynamic client registration (RFC 7591), the app registers itself. Otherwise it uses the optional OAuth client ID from the server editor.

Run as a runbook

Mon, 01 Jan 0001 00:00:00 +0000

Run as runbook on the Collections page runs that collection’s lines in the order shown, in the current tab. Favourites run first, then the rest, which is the same order termorq-cli run uses.

flowchart LR
 shelf[("Collection")]:::store
 fav["Favourites,\nthen the rest"]:::step
 stepn["Shell, endpoint,\nor tool"]:::out
 looked{"Check"}:::gate
 capture["Capture\nname = $.path"]:::step
 halt(["Stop"]):::exit

 shelf --> fav --> stepn --> looked
 looked --> capture --> stepn
 looked --> halt

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef gate fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 classDef exit fill:#9f1239,stroke:#fecdd3,stroke-width:2px,color:#fff1f2
 linkStyle 0,1,2,3,4 stroke:#5eead4,stroke-width:2.5px
 linkStyle 5 stroke:#fb7185,stroke-width:2.5px

The run stops at the first failure:

Secrets and termorq-cli

Mon, 01 Jan 0001 00:00:00 +0000

termorq-cli will not start a run that needs a secret it cannot find, and it scrubs every secret it does find from the text, JSON, YAML, and JUnit it writes. This page is the CLI. The app’s keychain, export files, and workspace guard get their own chapter later.

Where the secret comes from

For each connection a step will call, termorq-cli looks in this order:

The environment variable AIT_SECRET_<CONNECTION_NAME>.
The connection’s vault reference, akv://… or op://….
The app’s secret store, when that store can be reached on this machine.

The variable name is the connection name in upper case, with every other character written as _. Users API becomes AIT_SECRET_USERS_API. gh-prod.v2 becomes AIT_SECRET_GH_PROD_V2.

Share a file

Mon, 01 Jan 0001 00:00:00 +0000

The Library import menu is the front door. Save dialogs start in Downloads. Files are written with owner-only permissions.

Library → Import. Each kind has its own extension. A backup restores. It does not merge by deleting.

File	Holds	Secret
`.aitcol`	Collections, and optionally the endpoints and API connections those lines use, plus chosen MCP servers	A bundle that includes secrets is always encrypted. A plain collections file can be encrypted too. The preview flags lines that look like they contain secrets and can mask them
`.aitmcp`	MCP servers only, including environment and customer ids	Always encrypted. Password at least 12 characters, not stored
`.aitapi`	The ticked endpoints and the API connections they use	Encrypted, and the secret is inside. OpenAI connections stay behind. Password at least 12 characters, not a common password, not one character repeated
`.aitbak`	Settings, environments, customers, theme, collections, MCP servers, API connections, endpoints, and OpenAI connections, including secrets	Always encrypted

Older .aitmcp and .aitapi files still import. An older file may have no environment id or customer id. The names and colours stay in Settings on this computer.

Shells

Mon, 01 Jan 0001 00:00:00 +0000

A line that is not an @ command or a / skill runs in the tab’s shell. One command runs at a time per tab. Output streams in while it runs. Ctrl+C stops that command and everything it started.

Which shells

Settings → Shell picks the shell for every tab that has not chosen its own, from the ones installed here.

Platform	Choices
macOS and Linux	bash, zsh, fish, sh, PowerShell 7
Windows	Windows PowerShell, PowerShell 7, Command Prompt, Git Bash, WSL

Right-click a tab, then Shell, to choose one for that tab, or Default to follow Settings. The header shows the active tab’s shell. @shell opens that shell as an interactive terminal.

The window

Mon, 01 Jan 0001 00:00:00 +0000

The window is one prompt with a rail on the left and a header on top. Everything else, HTTP, MCP, models, and collections, opens in that same column.

flowchart LR
 rail[["Rail"]]:::store
 prompt["Prompt"]:::step
 shell["Shell"]:::out
 http["HTTP"]:::step
 mcp[("MCP")]:::store
 model{"Model"}:::gate

 rail --> prompt
 prompt --> shell
 prompt --> http
 prompt --> mcp
 prompt --> model

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef gate fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 linkStyle 0,1,2 stroke:#5eead4,stroke-width:2.5px
 linkStyle 3 stroke:#67e8f9,stroke-width:2.5px
 linkStyle 4 stroke:#FFC131,stroke-width:2.5px

The rail

The rail is 64 pixels wide. Each button has a label and a tooltip.

Updates

Mon, 01 Jan 0001 00:00:00 +0000

Settings → Application updates is where the check lives. The switch Check automatically is on until you turn it off. Check for updates runs one check now. Download latest release opens GitHub Releases.

Calling an endpoint

Mon, 01 Jan 0001 00:00:00 +0000

@create endpoint asks for the connection, the name, the method, and the path. Methods are GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS. You can add query defaults, path parameters, and extra headers.

A {name} in the path becomes a path parameter with an optional default. Call it with --name value.

@create endpoint

Names may contain spaces. POST, PUT, and PATCH can include a JSON body, sent as application/json. A blank body sends none. The test shows the status as a coloured pill. Save stays disabled until an HTTP response comes back.

Files

Mon, 01 Jan 0001 00:00:00 +0000

Two places hold state. The data folder is this machine. The workspace folder is what you commit.

Data folder

com.garrardkitchen.ai-terminal under the platform data directory.

Platform	Path
macOS	`~/Library/Application Support/com.garrardkitchen.ai-terminal`
Linux	`$XDG_DATA_HOME` or `~/.local/share/com.garrardkitchen.ai-terminal`
Windows	`%APPDATA%\com.garrardkitchen.ai-terminal`

File	What it is
`collections.json`	The shelf. Older `localStorage` data is moved here once
`command_history.json`	The last 500 commands and their times
`api_connections.json`	API connections, without secret values
`api_endpoints.json`	Endpoints
`openai_connections.json`	Model connections, without the key
`mcp_connections.json`	MCP servers, without secret values
`mcp_prefs.json`	Favourites and related MCP preferences
`network_settings.json`	The additional CA certificate setting

The keychain service is com.garrardkitchen.ai-terminal. An AES-256-GCM fallback file lives in this folder when the keychain cannot be used. Do not edit it to plant a token.

Free and Pro editions

Mon, 01 Jan 0001 00:00:00 +0000

Termorq has Free and Pro builds. The edition appears beside the application version in the window header. The Free header includes created by Garrard Kitchen; Pro omits this credit. Open License from the left rail to compare plans; the current build is highlighted.

The root features.yml manifest is the source of this feature list and the app’s feature availability. Every new feature must have an explicit plan assignment there.

Feature	What it includes	Free	Pro
Terminal, tabs and split panes	Run shell commands in persistent terminal tabs and split panes.	✓	✓
Saved APIs and endpoints	Create, import, call and check saved HTTP endpoints.	✓	✓
MCP connections and tools	Connect to MCP servers and inspect or call their tools.	✓	✓
OpenAI-compatible connections and model features	Use model connections, skills, chat, and model-assisted interpretation.	—	✓
AI Agent tool use	Let the model propose API and MCP calls for your approval.	—	✓
Collections	Save, organize, import, and export reusable command lines.	✓	✓
Run collections as runbooks	Run saved collection lines in order and capture response values.	—	✓
Team workspace	Share API, MCP, endpoint, and collection definitions through a git folder.	—	✓
Product support, feature requests and experimental early access	Access product support, submit feature requests, and get early access to experimental features.	—	✓
Web Check monitoring	Schedule saved API and MCP checks and inspect their history.	—	✓
Application updates and appearance	Manage updates, themes, shell preferences, and diagnostics.	✓	✓
Encrypted backup and secret handling	Protect local data and move it between installations.	✓	✓

Source builds default to Free. Set AI_TERMINAL_EDITION=pro before pnpm tauri dev or pnpm tauri build to build Pro. Any value other than free or pro stops the build.

Pipelines

Mon, 01 Jan 0001 00:00:00 +0000

A pipeline builds termorq-cli, points it at the checkout with an absolute path, and passes each connection secret in from the forge’s secret store. The JUnit document is written to standard output. Warnings stay on standard error, so a skipped step does not corrupt the XML.

flowchart LR
 checkout[("Checkout\n.ai-terminal/")]:::store
 secrets[("Forge\nsecret store")]:::secret
 build["cargo build\n--bin termorq-cli"]:::step
 run["termorq-cli run\n--format junit"]:::run
 report(["Publish the XML\neven if the run fails"]):::out

 checkout --> build --> run
 secrets --> run
 run --> report

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef secret fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 classDef run fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#166534,stroke:#86efac,stroke-width:2px,color:#f0fdf4
 linkStyle 0,1 stroke:#5eead4,stroke-width:2.5px
 linkStyle 2 stroke:#FFC131,stroke-width:2.5px
 linkStyle 3 stroke:#86efac,stroke-width:2.5px

The commands below are the same ones in Run a collection. Swap Smoke and AIT_SECRET_USERS_API for your collection and connection. Add --allow-shell only when you have read the shell lines. Add --yes only when the plan calls a destructive tool.

Sample workspace

Mon, 01 Jan 0001 00:00:00 +0000

The download is the workspace the termorq-cli chapter already runs. It contains no token. mock://users answers on this machine, so the HTTP steps need no network.

Unpack it, then point termorq-cli at the folder with an absolute path. A relative . is rejected.

termorq-cli list --workspace ~/src/acme-apis
termorq-cli show Smoke --workspace ~/src/acme-apis
termorq-cli check Smoke --workspace ~/src/acme-apis

termorq-cli check exits 2 until you set AIT_SECRET_USERS_API. The value can be any non-empty string for this demo. The app masks it as ••••••••.

Tabs and splits

Mon, 01 Jan 0001 00:00:00 +0000

Each tab is its own session: scrollback, folder, history, MCP servers, and OpenAI connection. Switching tabs leaves a running command where it is.

Add, rename, close

+ adds a tab in the start folder. Right-click for Rename and Change colour. Middle-click, ×, or Close removes the tab. Closing the last tab resets it.

Ctrl+Tab moves to the next tab. Ctrl+Shift+Tab moves to the previous one. Both wait while a palette or a dialog is open.

Tools, resources, and prompts

Mon, 01 Jan 0001 00:00:00 +0000

@tool

@tool
@tool search
@tool search --query tea
@tool echo --message hi
@tool echo --message=hi

@tool lists the tools on the servers connected to this tab, favourites first within each server, then A→Z. When more than one server is connected, the list names the server after the description. An empty @tool with an active connection shows Disconnect on the chip.

@tool name opens the arguments form when that tool is already connected. If it is not, the scrollback says it was not found and the app looks through the saved servers, stops at the first server that has the tool, connects it, and shows MCP connected with the server name and tool count. It then opens the form, or runs the call when the line already has flags. Servers already connected are checked first.

GraphQL and streams

Mon, 01 Jan 0001 00:00:00 +0000

GraphQL

Tick GraphQL on an endpoint. Its saved body is the query. The call sends POST with {"query", "variables"}.

The call’s body, or --body, is the variables JSON. A blank body sends {}.

A non-empty errors array shows as Check failed, so a check and a runbook treat it as a failure even when the HTTP status is 200.

Server-sent events

@sse ticks
@sse live events

@sse <endpoint> streams server-sent events. The name completes the same way @endpoint does: favourites first, then A–Z, Tab cycles, and → accepts the ghost. A name may contain spaces. Extra words after a finished @sse name are ignored.

Interactive terminal

Mon, 01 Jan 0001 00:00:00 +0000

Most lines are non-interactive: the app starts the shell, streams the output, and returns to the prompt. A program that needs a keyboard opens a pseudo-terminal in the tab instead. On Windows that terminal is ConPTY. The screen is drawn with xterm.js.

These open a terminal on their own:

Editors and pagers
ssh and sudo
top
git commit without -m, and git add -p
docker exec -it
A REPL started without a script, such as python, node, or psql mydb

@shell opens an interactive shell in the tab until you type exit.

The inspector

Mon, 01 Jan 0001 00:00:00 +0000

@mcp inspect Docs

Inspect on a row in @mcp opens the same dialog. The app connects that server on the current tab first if it needs to.

Section	What you see
Overview	Server info, instructions, the capabilities from `initialize`, and the negotiated protocol version
Tools	Description, pretty-printed input schema, and annotations (read-only, destructive, idempotent, open world). Call… opens the usual tool form and approval flow
Resources	Resources and templates (`resources/list`, `resources/templates/list`, following `nextCursor`). Read shows text, or the size and MIME type of binary contents. A template’s placeholders are filled first
Prompts	Arguments, then Get shows the messages
JSON-RPC log	The last 200 messages sent and received for that server. Memory only. Bodies over 16 KB are cut. Secret-looking fields and the server’s stored secrets are masked. Copy copies the log as text
Ping	Sends `ping` and shows the round trip

A section the server has no capability for shows an empty state.

Web Check

Mon, 01 Jan 0001 00:00:00 +0000

Web Check is available in Pro builds. Free termorq-cli binaries do not include the termorq-cli web-check command.

Web Check runs saved API endpoints and MCP tools from a foreground termorq-cli process. Its local browser interface manages checks and displays SQLite-backed history. The header labels the build edition as FREE or PRO. Closing the browser keeps monitoring running. Ctrl+C or computer sleep interrupts it.

On Pro builds, use the Windows notification-area menu, the macOS menu-bar menu, or the macOS Dock menu to start or stop Web Check and show its output. The Show Web Check output option includes the local URL and pairing code. Windows Pro NSIS .exe and Microsoft Store MSIX packages include the matching termorq-cli.exe; macOS and other builds need termorq-cli beside the app or on PATH for Start Web Check to work. If the CLI is missing, the menu still appears and reports that when selected.

History and plain English

Mon, 01 Jan 0001 00:00:00 +0000

Command history

↑ and ↓ cycle the commands on this tab when no palette is open. The app keeps the last 500 in command_history.json in the app data folder. Each entry is the command and at, Unix epoch milliseconds. An older file that was a plain list of strings is migrated on load (at: 0 shows as an unknown time).

[
 { "command": "git status", "at": 1727900000000 }
]

The active tab’s history is the one ↑ and ↓ and @history use. It is mirrored to that file when commands run.

Import and export

Mon, 01 Jan 0001 00:00:00 +0000

Two exports exist. One is a file another API client can open, with secrets replaced by placeholders. The other is an encrypted file for this app, and it can carry the secret.

OpenAPI and Postman, with no secrets

In @endpoint, tick endpoints of one API connection and choose Export OpenAPI or Export Postman. Or type:

@export openapi Users API
@export postman Users API

That exports every endpoint on the connection.

Find and export

Mon, 01 Jan 0001 00:00:00 +0000

Find in the scrollback

Cmd+F on macOS, or Ctrl+F on Windows and Linux, opens a search box over the active tab. Every match is highlighted. The current one is filled in the accent colour, with a count such as 3 of 12.

Enter and Shift+Enter, or the arrows, step through matches and wrap at either end. Aa matches case. Esc closes the box. New output is searched as it arrives.

One Azure path

Mon, 01 Jan 0001 00:00:00 +0000

These four Azure pieces are already in the app. This page is the order to wire them, using the sample collection as the thing the pipeline runs.

flowchart LR
 entra["Entra\nclient credentials"]:::step
 kv[("Key Vault\nakv://")]:::secret
 api["Users API\nor an MCP server"]:::out
 aoai["Azure OpenAI\non the tab"]:::store
 ado(["Azure DevOps\ntermorq-cli run"]):::exit

 entra --> api
 kv --> api
 api --> aoai
 api --> ado

 classDef store fill:#134e4a,stroke:#5eead4,stroke-width:2px,color:#f4fbfa
 classDef secret fill:#FFC131,stroke:#b45309,stroke-width:2px,color:#1a1404
 classDef step fill:#0f766e,stroke:#99f6e4,stroke-width:2px,color:#f4fbfa
 classDef out fill:#155e75,stroke:#67e8f9,stroke-width:2px,color:#f4fbfa
 classDef exit fill:#166534,stroke:#86efac,stroke-width:2px,color:#f0fdf4
 linkStyle 0,2 stroke:#5eead4,stroke-width:2.5px
 linkStyle 1 stroke:#FFC131,stroke-width:2.5px
 linkStyle 3 stroke:#86efac,stroke-width:2.5px

1. A secret in Key Vault

Create the secret in Key Vault. In the app, put the reference in the connection’s secret field:

Guide map

Mon, 01 Jan 0001 00:00:00 +0000

The sidebar is this list. Each group below is a chapter.

Get started

Install and run, the window, and the sample workspace you can run offline.

The terminal

The prompt and command search, shells, tabs and splits, the interactive terminal, history, and find and export.

Collections and runbooks

The shelf and run as a runbook, including captures, checks, and @diff.

HTTP APIs

Connections, auth, calling, GraphQL and streams, and import and export.

MCP

Servers, OAuth, tools, resources, and prompts, and the inspector.

Termorq

API connections

Browse and edit

Commands

Install and run

Model connections

On this machine

The keychain link

Open, save, status, close

Preferences

Primary email link

Run a collection

Servers

The prompt

The shelf

Ask the model

@chat link

Auth

Keyboard

OAuth sign-in

Run as a runbook

Secrets and termorq-cli

Where the secret comes from link

Share a file

Shells

Which shells link

The window

The rail link

Updates

Calling an endpoint

Files

Data folder link

Free and Pro editions

Pipelines

Sample workspace

Tabs and splits

Add, rename, close link

Tools, resources, and prompts

@tool link

GraphQL and streams

GraphQL link

Server-sent events link

Interactive terminal

The inspector

Web Check

History and plain English

Command history link

Import and export

OpenAPI and Postman, with no secrets link

Find and export

Find in the scrollback link

One Azure path

1. A secret in Key Vault link

Guide map

Get started link

The terminal link

Collections and runbooks link

HTTP APIs link

MCP link

The keychain

Primary email

@chat

Where the secret comes from

Which shells

The rail

Data folder

Add, rename, close

@tool

GraphQL

Server-sent events

Command history

OpenAPI and Postman, with no secrets

Find in the scrollback

1. A secret in Key Vault

Get started

The terminal

Collections and runbooks

HTTP APIs

MCP