mono

Link scattered projects into a single workspace so AI coding agents can see them all at once.

The Problem

You have multiple related repos — a backend, a frontend, some shared libs — and you want Claude Code (or any coding agent) to work across all of them. But these agents work best from a single directory.

mono creates a lightweight workspace that symlinks your projects together, with a CLAUDE.md that wikilinks to each project's own CLAUDE.md. No monorepo migration. No copying files. Just symlinks.

~/.mono/my-stack/
  api        -> ~/Projects/api
  web        -> ~/Projects/web
  shared     -> ~/Projects/shared-lib
  CLAUDE.md  (auto-generated with [[wikilinks]])

Install

brew install focus7eleven/tap/mono

Or build from source:

git clone https://github.com/focus7eleven/mono.git
cd mono
go build -o mono ./cmd/mono
mv mono /usr/local/bin/  # or anywhere in your PATH

Usage

Create a workspace

mono create my-stack ~/Projects/api ~/Projects/web ~/Projects/shared-lib

Launch Claude Code in it

mono my-stack

That's it. Claude Code starts in the workspace with full visibility into all linked projects.

Flags

mono my-stack --resume      # Resume the most recent Claude Code session
mono my-stack --skip-all    # Skip all permission prompts

Both flags can be combined.

TUI

Run mono with no arguments to get an interactive terminal UI for managing workspaces:

mono

Key	Action
n	Create workspace
enter	Open workspace
a	Add link
x	Delete
/	Filter
esc	Back
q	Quit

Other commands

mono list                        # List all workspaces
mono list my-stack               # Show links in a workspace
mono add my-stack ~/Projects/x   # Add a link
mono add my-stack ~/x --as lib   # Add with custom name
mono rm my-stack web             # Remove a link
mono rm my-stack                 # Delete entire workspace
mono path my-stack               # Print workspace path

How it works

Workspaces live in ~/.mono/<name>/. Each linked project is a symlink — edits go straight to the original files. No copies, no sync.

When you add or remove links, mono auto-generates a CLAUDE.md with wikilinks to each project's documentation:

# Workspace: my-stack

## Linked Projects

- [[api/CLAUDE.md]]
- [[web/CLAUDE.md]]
- [[shared-lib/CLAUDE.md]]

Claude Code follows these wikilinks to understand each project's context, conventions, and structure — without you having to explain anything twice.

Built with

• Bubble Tea v2 — TUI framework
• Bubbles v2 — TUI components

License

MIT