Umbrella

Umbrella

~/umbrella

One place to work from.
Nothing to set up twice.

Umbrella is a structure for running Claude Code across everything you work on. Each org gets one home folder with its instructions, rules, skills and memory. Every session starts there, so Claude always knows where to look.

  • Built on Claude Code
  • Plain markdown in git
  • Your files stay where they are

orgs/*/projects.yaml

Your files stay
where they are.

Code stays in its repos. Shared folders stay in OneDrive, Drive or iCloud. Each org lists where its projects already live and what the agent may touch, so nothing gets moved to fit the system.

orgs/*/ingest/

Everything becomes a file.

Mail, calendar, meetings and texts sync in the background as dated markdown that any agent can search. Every change is committed. An hourly check sends an email if a feed goes quiet.

orgs/*/tasks/

Three messages. One task.

/triage reads every source together, the way a person would, and writes one task file with the evidence attached. Anything already closed stays closed.

orgs/*/agents/

One rulebook.
Two ways to follow it.

The interactive agent stops and asks in chat. An autonomous worker takes jobs by email, runs on its own copy of everything, and enforces the same rules in code.

~/.config/umbrella/

One place for every
key and every log.

Credentials live in one store, outside git. Every paid API call saves its response and writes a line to the same log, so nothing is paid for twice and every call can be traced. Caches, Python environments and browser installs are shared the same way.

_shared/skills/

Teach it once.

Skills live in one place. When a session starts, a hook links in the shared ones plus that org’s own, so a new skill is everywhere by the next session.

orgs/*/agents/main/sessions/

It picks up where it left off.

Every session keeps a journal as it works. Before the context runs out, /wrap writes a handoff, and the next session starts from there.

umbrella/README.md

It’s just folders.

Plain markdown in a git repo. No app, no server, no database. Open it in Finder and it’s all there, with every change in the history.

umbrella/
├── _shared/
│   ├── bin/  # the scripts that wire it together
│   ├── lib/  # sync code for mail, calendar, meetings
│   ├── skills/  # skills every org gets
│   └── templates/  # what a new org is stamped from
├── agents/
│   └── maintenance/  # looks after the structure itself
└── orgs/
    ├── acme/  # client work
    │   ├── ORG.md  # who and what
    │   ├── OPERATIONS.md  # where everything lives
    │   ├── GUARDRAILS.md  # what needs a yes
    │   ├── projects.yaml  # where the work already is
    │   ├── ingest/  # mail, calendar, meetings, texts
    │   ├── knowledge/  # reference that lasts
    │   ├── skills/  # this org's own
    │   ├── tasks/  # one file per task
    │   └── agents/
    │       ├── main/  # interactive, the one you talk to
    │       └── worker/  # autonomous, takes jobs by email
    ├── home/
    └── studio/

Adding an org

  1. 1
    cp -R _shared/templates/org orgs/bakeryStamp it from the template.
  2. 2
    ORG.md · GUARDRAILS.mdSay who it’s for and what needs a yes.
  3. 3
    projects.yamlPoint to where the work already lives.
  4. 4
    alias bakery='cd ~/umbrella/orgs/bakery/agents/main && claude'Give it a way in. Shared skills link on the first session.

Built with Claude Code, from inside Claude Code.

Claude CodeMarkdownGitlaunchdPythonBashAppleScriptEventKit

Umbrella is a working system, not a product, so there’s nothing to download.

← All projects