monorepo

One VPS workspace, many AI agents.

Monorepo is a minimal filesystem scaffold for using several coding agents against the same files. It keeps one canonical instruction layer, one shared skill library, and thin compatibility adapters for agents that expect different filenames or directories.

It is intentionally boring: Markdown, symlinks, shell scripts, and config templates.

What It Does

• Uses AGENTS.md as the canonical project instruction file.
• Generates CLAUDE.md for Claude Code.
• Generates workspace files such as SOUL.md, TOOLS.md, USER.md, IDENTITY.md, and HEARTBEAT.md.
• Stores reusable skills in _shared/skills/*/SKILL.md.
• Exposes shared skills through .agents/skills, .claude/skills, .pi/skills, and skills.
• Provides opt-in global links for ~/.agents, ~/.codex, ~/.claude, ~/.pi, and ~/.hermes.
• Avoids daemons, databases, proprietary services, and custom agent runtimes.

What It Does Not Do

• It does not replace hidden vendor system prompts.
• It does not guarantee identical behavior across agents.
• It does not sync devices by itself. Use Git or your normal file sync process.
• It does not manage secrets or credentials.
• It does not overwrite home-directory files unless you run scripts/bootstrap.sh --apply.

Quick Start

If the dry run looks right:

Daily Workflow

Then run whichever agent you want from the workspace:

Editing Instructions

Edit files in _shared/instructions/, then run: