git404hub

what is q fr?

alaa-alawi/q — explained in plain English

Analysis updated 2026-05-18

1CAudience · ops devopsComplexity · 3/5Setup · moderate

tl;dr

A terminal tool written in C that lets you ask an AI language model questions alongside normal shell commands.

vibe map

mindmap
  root((q))
    What it does
      Ask LLM in terminal
      Run suggested commands
      REPL mode
    Tech stack
      C
      libcurl
      OpenAI-compatible API
    Use cases
      Sysadmin help
      Command lookup
      Session recording
    Audience
      Developers
      Ops devops

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask a local language model for a shell command without leaving the terminal.

VIBE 2

Run numbered example commands suggested by the model with a single keystroke.

VIBE 3

Record and resume terminal sessions with the model's help included.

VIBE 4

Connect external MCP tool servers to extend what the assistant can do.

what's the stack?

ClibcurlMCP

how it stacks up fr

alaa-alawi/qabrown/aomadroxz1122/injected-host-enumeration
Stars111
LanguageCCC
Last pushed2020-03-11
MaintenanceDormant
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a local or remote OpenAI-compatible LLM server plus libcurl development headers to build.

The README does not state a license.

in plain english

q is a small command line tool, written in C, that blends normal shell commands with questions to an AI language model in the same terminal prompt. The idea is that instead of switching to a browser whenever you get stuck on a command, you can ask your question right there and get an answer, similar to having an experienced colleague sitting next to you. Running q in its interactive REPL mode gives you a numbered prompt where you can type ordinary shell requests in plain English, such as showing the last 100 nginx log lines, restarting a service, or finding large files modified recently. The tool sends that text to a local, OpenAI-compatible language model server and streams the response back to the terminal as it arrives. If the model's answer includes example shell commands in code blocks, those get numbered automatically so you can run one just by typing its number and a period, without retyping it. By default q talks to a language model server running on your own machine at 127.0.0.1, though the server address and port can be changed with environment variables, and an API key can be set if the server requires one. It also supports connecting to external MCP servers over HTTP, which extend the set of tools the model can call beyond the built in ones for reading time, reading files, and writing files. Other features include saving and resuming past sessions, keeping conversation context across multiple questions if you choose to, logging API requests and responses to a file, and a set of REPL slash commands for adjusting settings like timeouts and turn limits while the tool is running. The author describes q as a rough proof of concept built with around seven thousand lines of AI generated code, used daily as a personal tool, and released so others can experiment with it rather than waiting for a polished version. It requires libcurl development headers to build and installs with a standard make and make install workflow.

prompts (copy fr)

prompt 1
Help me build a local OpenAI-compatible server so I can run q against it.
prompt 2
Explain how q's REPL numbers and re-executes shell commands from LLM output.
prompt 3
Show me how to add a custom MCP server to q using --add-mcp-server.
prompt 4
Walk me through building q from source with make on Linux.

Frequently asked questions

what is q fr?

A terminal tool written in C that lets you ask an AI language model questions alongside normal shell commands.

What language is q written in?

Mainly C. The stack also includes C, libcurl, MCP.

What license does q use?

The README does not state a license.

How hard is q to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is q for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.