hub / github.com/Pagghiu/SaneCppLibraries
github.com/Pagghiu/SaneCppLibraries @main
Chat with this repo
5,142 symbols
18,085 edges
391 files
486 documented · 9%
● updated 3d agorelease/2026/06 · 2026-07-01★ 6243 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Sane C++ Libraries
Sane C++ Libraries is a set of C++ platform abstraction libraries for macOS, Windows and Linux, built for Agents.
Principles:
✅ Fast compile times
✅ Bloat free
✅ Simple and readable code
✅ Easy to integrate
⛔️ No C++ Standard Library / Exceptions / RTTI
⛔️ No third party build dependencies (prefer OS API)
Libraries
Libraries are designed to be used as Single File Libraries with minimal dependencies between them and follow a strict No Allocations (*) policy.
| Library | Description | Single File |
|---|---|---|
| Async | 🟨 Async I/O (files, sockets, timers, processes, fs events, tasks) | Download |
| Async Streams | 🟨 Concurrently read, write and transform byte streams | Download |
| Await | 🟨 C++20 coroutine layer over Async | Download |
| Containers | 🟨 Generic containers (SC::Vector, SC::SmallVector, SC::Array) | Download |
| Containers Reflection | 🟨 Containers specializations for Reflection and Serialization | Download |
| Fibers | 🟥 Stackful cooperative task runtime | |
| Fibers Async | 🟥 Stackful fiber I/O bridge over Async | |
| File | 🟩 Synchronous Disk File I/O | Download |
| File System | 🟩 File System operations (like copy / delete) for files / dirs | Download |
| File System Iterator | 🟩 Enumerates files and directories inside a given path | Download |
| File System Watcher | 🟩 Notifications {add,remove,rename,modify} for files / dirs | Download |
| Foundation | 🟩 Primitive types, asserts, macros, Function, Span, Result | Download |
| Hashing | 🟩 Compute MD5, SHA1 or SHA256 hashes for bytes streams |
Download |
| Http | 🟥 HTTP parser, client and server | Download |
| Http Client | 🟥 Streaming-first HTTP client with native OS backends | Download |
| Memory | 🟩 Custom allocators, Virtual Memory, Buffer, Segment | Download |
| Plugin | 🟨 Minimal dependency based plugin system with hot-reload | Download |
| Process | 🟩 Create child processes and redirect their input / output | Download |
| Reflection | 🟩 Describe C++ types at compile time for serialization | Download |
| SerialPort | 🟨 Serial port configuration and handling | Download |
| Serialization Binary | 🟨 Serialize to and from a binary format using Reflection | Download |
| Serialization Text | 🟨 Serialize to / from text formats (JSON) using Reflection | Download |
| Socket | 🟨 Synchronous socket networking and DNS lookup | Download |
| Strings | 🟩 String formatting / conversion / manipulation (UTF8 / UTF16) | Download |
| Testing | 🟨 Simple testing framework used by all of the other libraries | Download |
| Threading | 🟩 Atomic, thread, mutex, semaphore, barrier, rw-lock, condition | Download |
| Time | 🟨 Time handling (relative, absolute, high resolution) | Download |
Each library is color-coded to signal its status:
🟥 Draft (incomplete, WIP, works on basic test cases)
🟨 MVP (a minimum set of features has been implemented)
🟩 Usable (a reasonable set of useful features has been implemented)
How to use Sane C++ Libraries in your project
Point your agent at repository Skills.
Option 1: use single file libraries
- Obtain a specific library:
- Downloading it from the above table or from the Latest Release page
- Assembling it from current
mainbranch using the Single File Library browser app
#include SaneCppLIBRARY.hin your headers#define SANE_CPP_IMPLEMENTATION+#include "SaneCppLIBRARY.h"in one of your.cppfiles
See Building (user) for details on the (system) libraries to link.
Option 2: use all libraries together
- Clone the entire repo and add it as subfolder of your project
- Add SC.cpp to your build system of choice
- Include any public header (
Libraries/[Library]/*.h)
See Building (user) for details on the (system) libraries to link.
Examples
- SCTest Suite showcases most functionalities of all libraries. Check Building (contributor) for details.
- Documentation page of each library embeds some examples and / or code snippets.
- Examples showcases some basic examples like an
AsyncWebServerand a more advancedSCExamplean Async event loop integration with a GUI and usage of Plugin. - Tools is a collection of repository / code automation tools built using libraries themselves
- Includes a fully self-hosted SC::Build build system where builds are imperatively described using C++ code, can generate XCode / Visual Studio / Make projects, and can also build directly through a native backend on macOS, Linux, and Windows.
No Allocations (*)
- All libraries are designed to work inside user-provided memory buffers and can be used without dynamic memory allocation.
- All libraries return error codes when running out of such memory buffers (except in containers assignment operators, where they will assert).
- Memory and Containers are the only ones that will allocate by default, even if they support working inside fixed memory buffers (Opt-out allocation).
- Await uses by default caller-owned fixed buffers, while virtual memory, malloc/free, and polymorphic allocators are explicit opt-in modes (Opt-in allocation).
- Third-party container classes, including
std::ones, are fully supported (see InteropSTL for an example). - Memory and [Containers](https://pagg
Core symbols most depended-on inside this repo
sizeInBytes
called by 814
Libraries/File/File.cpp
join
called by 433
Libraries/Strings/Path.h
append
called by 251
Tests/Libraries/Http/HttpStringAppend.h
isEmpty
called by 250
Libraries/Await/Await.cpp
run
called by 192
Libraries/Await/Await.cpp
size
called by 191
Tests/Libraries/Http/HttpStringAppend.h
write
called by 186
Libraries/File/File.cpp
result
called by 186
Libraries/Await/Await.cpp
Shape
Languages
C++94%
Python3%
C1%
TypeScript1%
Modules by API surface
Libraries/Await/Await.cpp166 symbols
Tests/Libraries/Await/AwaitTest.cpp144 symbols
Libraries/Async/Async.cpp119 symbols
Libraries/HttpClient/HttpClient.cpp105 symbols
Tests/SCBuildTest/SCBuildFixtureTest.cpp78 symbols
Tests/Libraries/HttpClient/HttpClientTest.cpp77 symbols
Libraries/Http/HttpConnection.cpp77 symbols
Tools/SC-build/Build.h76 symbols
Libraries/Async/Async.h74 symbols
Tools/ToolsBootstrap.c72 symbols
Libraries/Http/HttpWebSocket.cpp70 symbols
Libraries/Await/Await.h70 symbols
For agents
$ claude mcp add SaneCppLibraries \
-- python -m otcore.mcp_server <graph>