ASK

ask is a lightweight CLI that sends chat prompts to OpenAI. It runs as a single C++17 binary (libcurl + vendored cJSON) and supports both one-shot replies and interactive chat.

• Default model: gpt-5.5
• Default reasoning effort: none
• Default temperature: 1.0
• Default token limit: 128000

Build

Dependencies: g++ (C++17), libcurl. cJSON is vendored in vendor/cjson/.

macOS:

brew install curl
make

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y g++ libcurl4-openssl-dev
make

This produces the ask binary from ask.cpp.

Configure API key / model

You must provide OPENAI_API_KEY (and optionally ASK_GLOBAL_MODEL):

export OPENAI_API_KEY=sk-...
export ASK_GLOBAL_MODEL=gpt-5.5

Or write a .env:

OPENAI_API_KEY=sk-...
ASK_GLOBAL_MODEL=gpt-5.5

Or persist via flags (writes .env):

./ask --setAPIKey sk-... --setModel gpt-5.5

Usage

One-shot:

./ask "What is the capital of France?"

Interactive:

./ask -c "Let's chat"# then type messages; use `exit` to quit, `status` to view token/model info

Disable streaming (receive full response at once):

./ask --no-stream "Tell me a story"

Set a custom system prompt:

./ask -s "You are a pirate""Hello there"

Raw output mode (no spinner, minimal formatting — useful for piping):

./ask --raw "Give me a JSON example"| jq .

Follow-up on the last question without conversation mode:

./ask "how to list files recursively"
./ask --context last "what about hidden files"

Attach text files inline using @path. The file content is injected directly into the prompt text — no vector storage or file uploads to OpenAI. Files over the size limit (default 10KB) trigger an interactive prompt in a terminal, or are silently skipped when piped:

./ask "Summarize @README.md"
./ask --fileLimit 50000 "Explain @ask.cpp"# raise limit to 50KB

Flags

Flag	Description
-h, --help	Display help message
-v, --version	Display version information
-c, --continue	Interactive conversation mode
--context last	Prepend previous Q&A for lightweight follow-ups
--no-stream	Disable SSE streaming (wait for full response)
--raw	Raw output mode (no spinner, minimal formatting)
-s, --system PROMPT	Set custom system prompt
-t, --token TOKEN	API key for this run
-m, --model MODEL	Model for this run (default: gpt-5.5)
-T, --temperature VAL	Sampling temperature, 0.0–2.0 (default: 1.0)
-l, --tokenLimit NUM	Max tokens budget (default: 128000)
-F, --fileLimit NUM	@file size limit in bytes (default: 10000)
--tokenCount	Print approximate token count for input and exit
--debug / --log LEVEL	Set log verbosity (none, error, warn, info, debug)
--logfile FILE	Log output to a file
--setAPIKey KEY	Persist API key to .env
--setModel MODEL	Persist model to .env

Token counting is approximate. Streaming prints chunks as they arrive and falls back to full JSON if needed. The CLI shows a "thinking..." spinner and retries once on timeout (60s).

Releases

Tags matching v* trigger GitHub Actions to build and upload tarballs:

git tag v1.0
git push origin v1.0

Artifacts are published as ask-<os>-<arch>.tar.gz with SHA256 checksums for Linux and macOS.

Contributing

Issues and PRs welcome. Keep changes portable (Linux/macOS) and stay within the C++17 toolchain used in Makefile.