Umbrella Context CLI

Use this CLI to connect a laptop or IDE to an Umbrella company context space.

Install

npm install -g umbrella-context

Or install it inside the current project:

npm i umbrella-context

For local testing from a tarball built from this repo:

pnpm pack:umbrella-context:local
npm install -g ./.artifacts/umbrella-context-local/umbrella-context-<version>.tgz

If you want to pack it and launch the packed copy immediately without publishing:

pnpm run:umbrella-context:local

First-time setup

umbrella-context setup

If you installed it locally instead of globally:

npx umbrella-context setup

The setup flow will:

• connect to your Umbrella server
• sign you in when needed
• list your companies
• let you choose a company
• let you choose or create a context space
• save this device config locally

Common commands

umbrella-context query "What do we already know?"
umbrella-context curate "We learned that..."
umbrella-context swarm onboard
umbrella-context swarm status
umbrella-context swarm query "How are auth cookies refreshed?"
umbrella-context swarm curate "JWT refresh notes"
umbrella-context worktree add ../other-checkout
umbrella-context worktree list
umbrella-context source add ../shared-lib --alias shared-lib
umbrella-context source list
umbrella-context adaptive refresh
umbrella-context adaptive status
umbrella-context push
umbrella-context pull
umbrella-context fix "ETIMEDOUT"
umbrella-context mcp
umbrella-context

The old agent-memory command still works as a compatibility alias. The short um command works too.

Swarm

Swarm lets one repo search more than just its own saved Context.

Think of it like this:

• umbrella-context query searches Umbrella Context
• umbrella-context swarm query searches Umbrella Context plus any extra note folders you connected

Typical flow:

umbrella-context swarm onboard
umbrella-context swarm status
umbrella-context swarm query "How do auth cookies refresh?"
umbrella-context swarm curate "New JWT refresh notes"

Right now this version supports:

• Umbrella Context
• read-only Umbrella repo sources linked with source add
• Obsidian vaults
• local markdown folders
• GBrain-style markdown folders
• Memory Wiki folders

Worktrees and Sources

Use worktree when one Umbrella repo has more than one checkout or sub-worktree:

umbrella-context worktree add ../other-checkout
umbrella-context worktree list
umbrella-context worktree remove ../other-checkout

Use source when you want this repo to read another Umbrella repo as a read-only knowledge source:

umbrella-context source add ../shared-lib --alias shared-lib
umbrella-context source list
umbrella-context source remove shared-lib

Those sources automatically show up inside swarm queries.

Adaptive Knowledge

Adaptive knowledge keeps lightweight .abstract.md and .overview.md files inside .um/adaptive/. It also tracks which saved notes get reused the most, so frequently helpful notes can rise over time.

umbrella-context adaptive refresh
umbrella-context adaptive status
umbrella-context query "How is authentication implemented?" --timeout 900

--timeout lets longer provider-backed queries wait longer before failing.

Claude Desktop Connector

Claude Desktop is now available as a first-class connector:

umbrella-context connectors install claude-desktop-mcp
umbrella-context connectors run claude-desktop-mcp

On Windows and macOS, this writes Claude Desktop's MCP config so Claude can talk to umbrella-context mcp. After install, fully quit Claude Desktop from the tray or menu bar, then reopen it.