whatisgithub

What is syscall-agent?

douglascorrea/syscall-agent — explained in plain English

Analysis updated 2026-05-18

2CAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A coding agent written in pure C, compiled to a single binary, that uses OpenRouter models and raw system calls to read files, run commands, and browse the web.

Mindmap

mindmap
  root((syscall-agent))
    What it does
      AI coding agent in C
      Single compiled binary
    Tech stack
      C11
      libcurl
      OpenRouter
    Use cases
      CLI coding tasks
      Interactive TUI
      Persistent memory notes
    Audience
      Developers
      Terminal users
    Platforms
      macOS
      Linux
      Android via Termux

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 build with it?

USE CASE 1

Run a lightweight AI coding agent from a single compiled binary with no runtime dependency.

USE CASE 2

Use the interactive terminal UI to watch model responses and tool calls stream in live.

USE CASE 3

Give the agent persistent memory across sessions using a plain Markdown notes file.

USE CASE 4

Run the agent on Android through Termux with access to battery, Wi-Fi, and clipboard tools.

What is it built with?

ClibcurlOpenRouterTermux

How does it compare?

douglascorrea/syscall-agentmonks103/tellonoadroxz1122/injected-host-enumeration
Stars221
LanguageCCC
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a C11 compiler, make, and libcurl, plus an OpenRouter account for model access.

License is not stated in the explanation.

So what is it?

syscall-agent is a coding agent written in pure C that runs from a single compiled binary. It connects to OpenRouter, a service that routes requests to various AI language models, and uses a tool-calling loop to carry out tasks, reading and writing files, searching the web, running commands, doing DNS lookups, checking network connectivity, and watching for file changes. Rather than relying on a runtime or framework, it implements its capabilities using OS-level system calls directly: things like fork, execvp, mmap, rename, getaddrinfo, and non-blocking sockets. The agent keeps persistent notes in a plain Markdown file called MEMORY.md, with locking to prevent corruption when appending. File writes are done atomically using a temporary file that gets renamed into place. For reading large files, it uses mmap-backed range reads instead of loading entire files into memory. You can run it as a plain command-line tool by passing a question or task as an argument, or open an interactive terminal interface with the --tui flag. The TUI shows model responses as they stream in, supports real-time tool call display, and includes a live model picker that fetches the current list of models from OpenRouter. Subprocess tools that execute local commands are disabled by default and must be opted into explicitly via a flag. It runs on macOS, Linux, and Android through Termux, the terminal environment for Android. Android users get additional tools for reading battery status, Wi-Fi details, and clipboard content through Termux's device API. Dependencies are a C11 compiler, make, and libcurl. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
How do I compile and run syscall-agent on Linux with a C11 compiler and libcurl?
Prompt 2
Show me how to use the --tui flag to get an interactive terminal interface for syscall-agent.
Prompt 3
Help me understand how syscall-agent's MEMORY.md persistent notes file works.
Prompt 4
Explain how to enable subprocess tools safely in syscall-agent since they are disabled by default.

Frequently asked questions

What is syscall-agent?

A coding agent written in pure C, compiled to a single binary, that uses OpenRouter models and raw system calls to read files, run commands, and browse the web.

What language is syscall-agent written in?

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

What license does syscall-agent use?

License is not stated in the explanation.

How hard is syscall-agent to set up?

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

Who is syscall-agent for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.