hi, I'm Pedro Nauck 👋

🤖 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.

---

Tech I ship with

---

🧭 Start here

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.

---

🎼 CompozyOS — where agent work lives

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 agh repo is archived; everything it did now ships inside compozy v0.3, and the peer protocol lives on as compozy-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-run

The rest of the stack

Quality 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.

---

🛠️ Personal tools & scaffolds

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.

---

🪦 OSS classics — the React/JS era

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

---

⚡ What I'm doing now

• 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)

---

🤝 Let's connect

• 𝕏 / Twitter — @pedronauck (personal) · @compozyai (product)
• 🌐 Website — compozy.com · 📖 Docs — compozy.com/docs
• 📦 Orgs — @compozy · @doczjs

---

_{📍 San Francisco · 🇧🇷 → 🇺🇸 · Coffee-powered · Always shipping}