π€ Building the operating system for agent work.
I'm a software engineer based in San Francisco, founder of Compozy β where we build CompozyOS, a local-first operating system for agent work. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated jobs and loops, and share one project memory. You steer everything from the browser.
Before AI ate everything, I spent a decade shipping open-source developer tools β Docz (23.6k+ β), react-adopt (1.7k+ β), reworm (1.5k+ β), and a long tail of React, JS, and tooling libraries. I've also shipped Rust systems work β notably contributing to FuelLabs/data-systems, the official data-streaming libraries for the Fuel Network. Today, most of my work lives at the intersection of agents, local-first runtimes, and developer experience.
If you only have a minute, these are the projects I'd point you to first:
- πΌ compozy β CompozyOS: a local-first OS for agent work. One daemon owns sessions, tasks, loops, memory, permissions, automation and tools. (2.4k+ β)
- 𧩠skills β My curated collection of 132 agent skills for Claude Code and compatible assistants. (570+ β)
- π kb β Build topic-based knowledge bases from code, URLs, files and YouTube. Obsidian-compatible vaults, zero cloud deps.
- π skeeper β Version PRDs, tech specs, ADRs and AI plans in a sidecar Git repo β without polluting your main PRs.
- π codex-loop β Keep Codex tasks running until they actually finish β by time, rounds, or independently confirmed goal.
The core thesis: AI agents are powerful but unreliable on their own. They need a place to live β durable state, permissions, peer discovery, knowledge, and quality gates β to turn one-shot generations into shippable software. That's CompozyOS, built in the open at @compozy.
π Merged in July 2026. Compozy (orchestration) and agh (the local-first agent runtime with durable sessions and agent-to-agent networking, 180+ β) converged into a single product. Orchestration alone wasn't enough β an agent needs the whole machine around it. The
aghrepo is archived; everything it did now ships insidecompozyv0.3, and the peer protocol lives on ascompozy-network/v0.
What's inside
- ποΈ Work survives the terminal β sessions and Loop runs belong to the daemon, not to a client window
- ποΈ One state, several surfaces β web shell, CLI, HTTP/SSE, UDS, MCP and native tools read the same runtime
- π People stay in control β approvals, permissions, run state, artifacts and agent activity stay inspectable
- π» Local-first by default β one Go binary and SQLite-backed stores; remote access is explicit, via the Gateway
- 𧩠Built to extend β agents, skills, capabilities, hooks, bridges and extension kits with a published Go/TS SDK
- πΈοΈ Compozy Network β sessions discover peers, exchange typed messages, delegate work and close it with receipts
curl -fsSL https://compozy.com/install.sh | sh
compozy install && compozy daemon start
compozy session new --agent general --name first-runQuality loops & QA
| Project | What it does |
|---|---|
| π codex-loop | Release-grade QA loop for Codex CLI. Iterates until duration / rounds / goal targets are met β not just on the first plausible answer. (Go) |
| π cc-loop | Same harness, but wired into Claude Code lifecycle hooks. (Go) |
Knowledge & spec tooling
| Project | What it does |
|---|---|
| π kb | Build LLM-ready knowledge bases from code, URLs, files and YouTube. Outputs Obsidian-compatible vaults with codebase metrics, dead-code detection and semantic search. (Go) |
| π skeeper | Sidecar Git repo for spec artifacts. Keeps PRDs, ADRs, and AI plans versioned and diffable β separate from main-branch noise. (Go) |
| πΈοΈ gograph | Go codebase graph analyzer. Powers structural queries for agents working in large Go repos. (Go) |
Distribution & experiments
| Project | What it does |
|---|---|
| πΊ homebrew-compozy | Official Homebrew tap for the Compozy CLI suite. |
| π arky Β· π§ go-orchestrator | Earlier experiments β an LLM provider bridge in Rust and an agentic orchestration framework in Go. Superseded by CompozyOS, kept public for reference. |
| Project | What it does |
|---|---|
| 𧩠skills | 132 curated agent skills β 39 original, 29 hand-picked, 18 marketing & business, plus 46 community. Install with npx skills add pedronauck/skills. (570+ β) |
| πͺ devstack | Full-stack scaffold generator β Bun + Turborepo + React 19 + Hono + Drizzle + Postgres in minutes, not days. (TS) |
| πͺ go-devstack | Same idea, Go edition. |
A selection of projects I'm best known for from my pre-AI life. Several are archived or in maintenance mode, but they shipped to a lot of people.
| Project | What it is | β |
|---|---|---|
| docz | βοΈ "It has never been so easy to document your things." MDX-based docs framework. (archived) | 23.6k |
| react-adopt | π Compose render-props components like a pro. | 1.7k |
| reworm | π« The simplest way to manage state. | 1.5k |
| micro-router | π A tiny, functional router for Zeit's Micro. | 613 |
| react-video | π React component to load video from Vimeo or YouTube across any device. | 273 |
| react-simpletabs | Just a simple tabs component built with React. | 184 |
| algorithms-with-es6 | Classic algorithms implemented in modern JavaScript. | 159 |
| reicons | π Bundle your SVGs into fully customized React components. | 112 |
| gatsby-starter-docz | π Gatsby starter with Docz + a blog for your docs. | 90 |
| frontend-styleguide | Keep your frontend code clean, legible and beautiful. | 70 |
| yarn-workspaces-example | One of the earliest public examples of Yarn monorepos. | 45 |
| oneoften | Tips, tricks and tutorials on "How to build a large-scale JS application." | 44 |
| which-licenses-i-have | π Learn about the licenses around your packages. | 30 |
| storz | Global state machines, made easy. | 21 |
- Shipping the CompozyOS v0.3 beta β daemon, web shell, extensions, Gateway, and the Compozy Network protocol
- Running multiple agent instances concurrently as a daily driver β and learning what breaks
- Teaching 3,000+ devs how to actually work with agents, and writing about agentic engineering
- Sponsoring open-source builders I rely on (@raphamorim)
- π / Twitter β @pedronauck (personal) Β· @compozyai (product)
- π Website β compozy.com Β· π Docs β compozy.com/docs
- π¦ Orgs β @compozy Β· @doczjs
π San Francisco Β· π§π· β πΊπΈ Β· Coffee-powered Β· Always shipping