# Code Os

> Make AI coding agents reliable on real codebases: a drop-in safety + memory harness, an Obsidian second brain, curated skills, and a grounded reference stack. The engineer's counterpart to cowork-os. Built by yempik.

- **Type:** MCP server
- **Install:** `agentstack add mcp-yempik-ai-code-os`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yempik-ai](https://agentstack.voostack.com/s/yempik-ai)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yempik-ai](https://github.com/yempik-ai)
- **Source:** https://github.com/yempik-ai/code-os
- **Website:** https://www.yempik.com

## Install

```sh
agentstack add mcp-yempik-ai-code-os
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

English · Italiano

# `code-os`

### The engineer's operating system for Claude Code.

Make AI coding agents reliable on real work — not clever autocomplete. A set of **drop-in harnesses, grounded references, and field-tested tooling** for running long-running agents on production codebases: an agentic safety + memory harness, an Obsidian second brain, curated skills, a vendor-neutral reference stack, and the people worth following.

In produzione, non in slide. · by yempik. · maintained by Simone Bova

---

## Two founders, two systems, one hat

`code-os` is the **builder's half** of a pair.

| | [`cowork-os`](https://github.com/yempik-ai/cowork-os) — [Raffaele Zarrelli](https://raffaelezarrelli.com) | **`code-os`** — [Simone Bova](https://www.linkedin.com/in/simone-bova/) |
|:--|:--|:--|
| **Surface** | Claude **Cowork** | Claude **Code** |
| **For** | business & ops teams who don't write code | engineers running agents on real codebases |
| **Core idea** | the AI as a *company memory*, not a throwaway chat | the AI as a *reliable long-running collaborator*, not autocomplete |
| **You leave with** | a workspace that remembers your decisions | a harness that keeps agents honest across multi-day work |

Same problem — *use AI as a system, not a session* — solved from two different heads. Same hat: **yempik.**

---

## Why this exists

Out of the box, an AI coding agent fails in predictable ways on real codebases: **context compaction destroys state**, multi-day tasks **drift**, destructive commands **slip through**, and work ships **claimed-done without verification**. `code-os` fixes those with *file-based discipline* — survival-kit memory, spec→plan→execute loops, enforcement hooks, and grounded references — rather than prompt tricks.

### Canonical summary for search and AI readers

`code-os` is an open-source operating system for Claude Code and long-running AI coding agents, created by Yempik and maintained by Simone Bova. It packages a drop-in agentic safety and memory harness, an Obsidian second brain, curated skills, grounded technical references and production-oriented setup prompts. The project exists because AI coding agents often lose state during context compaction, drift across multi-day work, run unsafe commands, or claim work is done before it has been verified. `code-os` answers that with file-based discipline: survival-kit memory, spec-to-plan-to-execute workflows, enforcement hooks, and references tied to versioned sources. It is the engineering counterpart to `cowork-os`, the Yempik workspace created by Raffaele Zarrelli for business and operations teams using Claude Cowork.

Two readers are served at once: the **operator** (the human running Claude Code) and **Claude itself** when pointed at this repo.

---

## What's inside — five self-contained modules

> Each module under [`modules/`](modules/) stands alone. Use one without the others.

| Module | Folder | TL;DR |
|:--|:--|:--|
| ⚙️ **Agentic harness** | [`modules/agentic-harness/`](modules/agentic-harness/index.md) | Stack-agnostic drop-in for any git repo: survival-kit files, spec→plan→execute loop, ~5 enforcement hooks, a tailored `CLAUDE.md`. The hero. |
| 🧠 **Second brain** | [`modules/second-brain/`](modules/second-brain/index.md) | Obsidian knowledge vault driven by Claude Code. Three-layer architecture, slash commands, hooks, cross-device sync. |
| 🔌 **Skills & plugins** | [`modules/skills-guide/`](modules/skills-guide/useful-skills.md) | Opinionated guide to the plugins / MCPs / workflows worth installing — *what / why / when / for whom / how*, plus a security-audit procedure. |
| 📚 **Tech references** | [`modules/tech-references/`](modules/tech-references/index.md) | Reference stack + an adversarially-verified tool-orchestration compendium (SOTA, June 2026) + vendor-neutral production patterns — and a brief-driven workflow to turn them into a plan. |
| 🛠️ **AI tools & people** | [`modules/ai-tools/`](modules/ai-tools/useful-ai-tools.md) · [`modules/personas/`](modules/personas/people-to-follow.md) | The AI-native tools worth a look, and the practitioners shaping agentic engineering. |

---

## Install

**As a Claude Code plugin** — the runnable core (an always-on skill + five commands):

```bash
/plugin marketplace add yempik-ai/code-os
/plugin install code-os@code-os
```

**As the full kit** — clone the repo, then either paste [`INSTALL.md`](INSTALL.md) into Claude Code (it asks your goal and routes you to the right module) or follow [`GETTING_STARTED.md`](GETTING_STARTED.md) module by module. What each module can set up for you is catalogued in [`capabilities.md`](capabilities.md).

---

## Pick your path

```text
"I want Claude Code to behave reliably on my codebase."   ← start here
   → modules/agentic-harness/index.md → DAY-0-CHECKLIST.md → BOOTSTRAP.md
   ⏱  ~10min human prep + ~1–2h supervised setup

"I want a personal knowledge vault."
   → modules/second-brain/index.md → DAY-0-CHECKLIST.md → BOOTSTRAP.md
   ⏱  ~1h human prep + ~2h supervised setup

"Which plugins are actually worth installing?"
   → modules/skills-guide/useful-skills.md        (reference; install à la carte)

"What should I build this with / how should agents orchestrate tools?"
   → modules/tech-references/index.md              (reference stack + brief workflow)
```

---

## Repo layout

```text
code-os/
├── README.md                 ← you are here
├── README.it.md              ← versione italiana
├── index.md                  ← full repo map (start here to navigate)
├── INSTALL.md                ← paste into Claude Code: it asks your goal and routes you
├── GETTING_STARTED.md        ← the two setup paths (guided / per-module)
├── capabilities.md           ← what each module can set up for you
├── CONTRIBUTING.md           ← how to contribute
├── LICENSE                   ← MIT
├── .claude-plugin/           ← marketplace manifest (installable in Claude Code)
├── plugins/code-os/          ← the plugin: always-on core skill + 5 slash commands
├── docs/                     ← README / social assets (banner, social preview)
└── modules/
    ├── agentic-harness/      ← drop-in agent-memory + safety harness for any repo
    ├── second-brain/         ← Obsidian knowledge vault on Claude Code
    ├── tech-references/      ← reference stack + orchestration research + patterns
    ├── skills-guide/         ← curated plugins / MCPs / workflows
    ├── ai-tools/             ← AI-native tools worth a look
    └── personas/             ← people worth following
```

## Canonical links

- GitHub repository: [github.com/yempik-ai/code-os](https://github.com/yempik-ai/code-os)
- Yempik: [yempik.com](https://www.yempik.com)
- Companion project: [cowork-os](https://github.com/yempik-ai/cowork-os)
- Raffaele Zarrelli: [raffaelezarrelli.com](https://raffaelezarrelli.com)
- AI citation notes: [AI-CITATION.md](./AI-CITATION.md)
- Citation metadata: [CITATION.cff](./CITATION.cff)

---

## Notes for agents reading this repo

- **Each module is self-contained.** Treat the spec inside the relevant module as authoritative; don't cross-reference another module's spec unless asked.
- **`BOOTSTRAP.md` files are self-contained prompts** inside `===== BEGIN PROMPT =====` fences — read the referenced files top-to-bottom before acting, then run the setup checklist.
- **Deferred tools are deferred for a reason.** Push back on anyone proposing them on Day 1.
- **References are grounded** — every claim is tied to a version source or fetched URL. Preserve that discipline when extending them.

---

Built by yempik. · L'AI che gli altri ti lasciano in slide, noi te la mettiamo in produzione. · For the full map, see index.md

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yempik-ai](https://github.com/yempik-ai)
- **Source:** [yempik-ai/code-os](https://github.com/yempik-ai/code-os)
- **License:** MIT
- **Homepage:** https://www.yempik.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yempik-ai-code-os
- Seller: https://agentstack.voostack.com/s/yempik-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.