Awesome AI Agents › AI Agents

bravenewxyz/agent-c

⭐ 442 C repository created 2025-08-25

Agent-C is a minimal terminal agent implemented as one C source file. It connects to the OpenRouter API with an API key taken from an environment variable, sends the conversation together with the definition of a single shell tool, and streams the model reply token by token using server-sent events so output appears as it is generated. When the model answers with a tool call, the agent runs the requested shell command locally, sends the captured output back as a tool result and continues the turn, allowing up to five tool calls before the turn ends. Conversation state is a sliding window of the last twenty messages including tool call history, which bounds memory use and prompt size without any external storage. The distinguishing property is the absence of dependencies: there is no libcurl and no OpenSSL, and transport security is handled by the platform, using SecureTransport on macOS, so the program builds with a plain make invocation and produces a binary of roughly four kilobytes after LZMA self-extraction on macOS or UPX compression on Linux. Both macOS and Linux targets are supported and auto-detected by the makefile. A separate specification document records the architecture and a set of test cases, which makes the repository readable as a worked example of how a tool calling agent loop works at the protocol level, without a framework in between. The code is released under CC0, so it can be copied without attribution requirements. It is aimed at developers who want an agent they can run on constrained systems, who want to inspect the raw request and response flow of an OpenAI-compatible tool calling API, or who want a starting point for embedding an agent loop in a C program.

https://github.com/bravenewxyz/agent-c

agentai-agentopenroutercclishelltool-callingstreamingminimalzero-dependency