Skip to content
View pedronauck's full-sized avatar

Highlights

  • Pro

Organizations

@doczjs @compozy

Block or report pedronauck

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
pedronauck/README.md

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

Go TypeScript Rust Node.js Bun SQLite Claude Codex CLI MCP


🧭 Start here

If you only have a minute, these are the projects I'd point you to first:

  • 🎼 compozyCompozyOS: 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


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

Pinned Loading

  1. compozy/compozy compozy/compozy Public

    An operating system for AI agents. 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 automat…

    Go 2.5k 140

  2. skills skills Public

    My personal favorite skills

    JavaScript 573 82

  3. compozy/skeeper compozy/skeeper Public

    Version your spec artifacts — PRDs, tech specs, ADRs, AI plans — in a sidecar Git repository, without polluting your main PRs.

    Go 83 9

  4. compozy/kb compozy/kb Public

    Go 96 8

  5. docz docz Public archive

    ✍ It has never been so easy to document your things!

    TypeScript 23.6k 1.4k

  6. react-adopt react-adopt Public

    😎 Compose render props components like a pro

    TypeScript 1.7k 56