agentos ● live
a cognitive kernel that grew into a self-hosted agent platform
agentos is the plumbing the rest of my work stands on. It's a small, terminal-native runtime that gives an agent the essentials: a bus of tools it can discover and call, pluggable LLM providers, persistent memory, and a tight event-driven loop.
It has since grown into a full agent platform I run from my phone. One OpenAI-compatible provider puts an entire model catalog — 120+ models — behind a searchable picker, and a ReAct loop lets the agent actually do things: search the web, read and write files, run Python or a shell, analyze images, and roughly twenty other tools. Two modes: a plain streaming chat with the human firmly in the loop, and an agent mode that streams its tool-by-tool reasoning live, with a stop button and a configurable step budget.
Because an agent with real machine access is dangerous, the safety model is the point rather than an afterthought. A permission layer runs every risky action past me — approve or deny, right on the phone — and a filesystem scope fences the agent into a chosen directory. Secrets never touch the source; a hashed, timing-safe PIN guards the door; it runs privately on my own network, not the open internet.
The part I'm fondest of: the agent can extend itself. When no tool fits, it writes a new one as a small JavaScript function that runs in a hardened sandbox and joins its toolset for the session. It also carries a library of ~88 capability guides it can search and follow, and its system prompt is regenerated every turn with live context — the model it's running as, the time of day, its scope, how many tools and skills it holds — so it is genuinely aware of its own environment. This is engineering, not a research claim: the runtime tool-forging sandbox and the skill catalog are adapted from the open-source @framers/agentos project (Apache-2.0); the kernel, the platform, and the safety layer are my own.
// highlights
- ReAct agent loop over 120+ models, switchable mid-conversation
- ~26 real tools: web search/fetch, filesystem, Python/Node/shell runners, vision, memory
- Human-in-the-loop permissions: approve/deny each risky action + a filesystem scope
- Runtime tool-forging — the agent writes new tools into a hardened node:vm sandbox
- Bundled ~88-skill capability library the agent can search and follow
- Environment-aware system prompt, regenerated every turn with live state
- Hashed-PIN auth, self-hosted, mobile-first — private by default
// stack
- TypeScript
- Node
- NVIDIA NIM
- Cloudflare AI
- node:vm
- SSE