Skip to content

egregore-labs/egregore

Repository files navigation

Egregore — towards shared minds

A shared intelligence layer for teams using Claude Code.

Website · Community · MIT License


Egregore is a shared cognition layer for AI-native collaboration. It turns Claude Code into an inhabitable production environment where every session, handoff, and decision accumulates into a living memory owned by your organization. With use, the deep context that accumulates enables seamless continuity across multi-agent workflows, visibility into organizational patterns and decision-making, and persistence of collective intelligence across people, sessions, and time.

full-loop.mp4

Install

npx create-egregore@latest --open

This walks you through GitHub auth, names your egregore, creates the repos (instance + shared memory), clones everything locally, and adds a shell command to your profile.

To join an existing egregore:

npx create-egregore join <github-org>

(You will need an invitation from the instance owner. See /invite below.)

If your org blocks third-party GitHub Apps, there's a gh-CLI install path: see INSTALL-GH.md or the docs.

Start

Open a new terminal:

egregore

or, if configured:

<instance-alias>

Memory syncs. Identity resolves. The session picks up the accumulated context from every session before it.

Agent-agnostic use

Claude Code is the integrated runtime, but the shared-memory protocol can be used by other agents too. Any runtime that can run shell commands inside the checkout can call:

bin/agent.sh sync
bin/agent.sh activity --for <person>
bin/agent.sh handoff --from <person> --to <person> --topic "<topic>" --body "<briefing>"
bin/agent.sh ask --from <person> --to <person> --topic "<topic>" --question "<question>"

See AGENTS.md and docs/AGENT-PROTOCOL.md.

The substrate

Three structural pieces. Everything else is built on them.

egregore.md — The identity document. What the group is, what it values, how it works. Every session reads it. It evolves with use.

memory/ — Git-based shared knowledge. Handoffs, decisions, patterns, quests, people. A separate repo, symlinked into the instance. Version-controlled provenance on everything.

Slash commands — Coordination primitives that encode the session protocol. Hand off context, capture decisions, invite people, save work. Nobody needs to learn git workflows or remember conventions.

Commands

Command What it does
/handoff Structured context for the next session — decisions, trade-offs, open threads
/activity What's happening across the team
/invite Bring someone into the egregore
/save Stage, commit, push, PR — one command
/dashboard Your personal status and recent work
/quest Start or contribute to an open-ended exploration
/ask /harvest Route a question to a teammate or the group
/todo Personal task tracking
/reflect Capture a decision, pattern, or finding
/deep-reflect Cross-reference an insight against accumulated knowledge

Invite

/invite <github-username>

Adds them as a collaborator on your repos. They join with:

npx create-egregore join <your-github-org>

New members inherit the full shared context from session one. The egregore onboards them.

What runs

Egregore uses Claude Code hooks — shell scripts that fire on session events. All source is in bin/ and .claude/hooks/. Read them directly.

Hook What it does
SessionStart Syncs memory, resolves identity, renders greeting
PreToolUse Boundary isolation + branch protection
PostToolUse Local activity tracking
WorktreeCreate Isolated git worktrees per topic
PreCompact Saves context before memory compression
Stop Reminds you to save unsaved work

No background processes. No daemons. No network calls you don't see.

Telemetry

Anonymous usage data — command names and timestamps only. Never code, file contents, or conversation. Opt out anytime:

EGREGORE_NO_TELEMETRY=1  # in your .env
DO_NOT_TRACK=1           # or the standard flag

Egregore Native: Managed hosting (coming soon)

The open-source Egregore was built as a self-hosted, sovereign architecture without dependencies. Egregore's true capabilities, functionalities and scale are greatly enhanced with managed services. For teams that want the knowledge graph, live notifications, organizational agents, and persistent GUI: [email protected].

Contributing

Egregore is built by its users. If you already run an egregore:

/contribute

Forks the repo, creates a branch, and opens a PR to egregore-labs/egregore when you're done.

For manual setup, see CONTRIBUTING.md.

From the lab

Built by Egregore Labs.

Find the others.

Releases

No releases published

Packages

 
 
 

Contributors