emt-brain 0.8.0

EMT Brain — sync skills, workflows, agents into Claude Code

emt-brain

EMT Brain — populate skills, workflows, and agents from the EMT repository into Claude Code (or GitHub Copilot).

Install

# From wheel (recommended)
pip install dist/emt_brain-0.6.0-py3-none-any.whl

# From source
pip install -e tools/emt-brain

# With uv
uv pip install dist/emt_brain-0.6.0-py3-none-any.whl

Quick start

# 1. Install standard MCP servers (Sequential Thinking + Memory)
emt-brain mcp-setup

# 2. Sync default bundle (master + utilities + anthropics + cteng)
#    + all workflows + all agents
emt-brain framework-sync

# 3. See available workflows
emt-brain workflow-list

# 4. Scope to a specific workflow and its dep closure
emt-brain framework-sync --workflow emt-wf-ip-planning

# 5. Preview without writing
emt-brain framework-sync --dry-run

# Show onboarding guide
emt-brain help

Commands

emt-brain mcp-setup

Install and activate standard MCP servers into Claude Code's settings.json. Checks if each server is already configured — skips if present, adds if missing. Restart Claude Code after running to activate.

emt-brain mcp-setup                          # write to ~/.claude/settings.json (global)
emt-brain mcp-setup --scope project          # write to .claude/settings.json (project)
emt-brain mcp-setup --dry-run                # preview without writing

Servers installed:

Server	Package
sequential-thinking	@modelcontextprotocol/server-sequential-thinking
memory	@modelcontextprotocol/server-memory

Requires Node.js — servers run via npx. A warning is shown if npx is not found.

emt-brain framework-sync

Populate skills, workflows, and agents in one shot.

emt-brain framework-sync                                 # default bundle + all
emt-brain framework-sync --workflow emt-wf-ip-planning  # scope to workflow deps
emt-brain framework-sync --dry-run                      # preview only
emt-brain framework-sync --force                        # overwrite local modifications
emt-brain framework-sync --scope project                # project-local (.claude/skills/)
emt-brain framework-sync --scope global                 # global (~/.claude/skills/)

Default bundle (flezi-emt/bundles/default.bundle.yaml) includes:

• Master skills (10) — EMT meta-tooling
• Utility skills (5) — docs, translations, branding
• Community: Anthropics (7 curated)
• Community: cteng (7 — context engineering foundation per IDEA-001)

Workflow sync (--workflow <id>) resolves the dep closure:

• Target workflow + transitively consumed workflows
• All agents referenced by those workflows
• All skills used by those agents
• Plus the default bundle (always included)

emt-brain workflow-list

List all available EMT workflows.

emt-brain workflow-list           # summary table
emt-brain workflow-list --full    # include per-workflow agent list
emt-brain workflow-list --json    # raw JSON

emt-brain help

Show categorised command overview and getting-started guide.

emt-brain status

Show current configuration (repo, branch, provider, scope) and drift count.

emt-brain doctor

Run environment diagnostics: Python version, git, Azure auth, repo reachability, destination writable, state file.

emt-brain reset

Delete CLI config and state. Already-synced files are not removed.

Authentication

emt-brain uses azure-identity. On first run it prompts for device-code login if the Azure CLI credential is not cached. Subsequent runs reuse the cached credential.

Project config

Place a .flezi-emt/config.yaml at your project root to configure emt-brain per project:

profile: default            # bundle to sync
provider: claude            # claude | copilot
scope: project              # global | project

CLI flags override project config; project config overrides global config.

Location	Purpose
Global config	~/.config/emt-brain/config.json — repo URL, branch, provider, scope
Project config	.flezi-emt/config.yaml — profile, filter_tags, provider, scope
State	~/.local/share/emt-brain/state.json — managed files, last sync
Cache	~/.cache/emt-brain/repo-cache/ — cloned remote repo

Run emt-brain doctor to see active paths.

Post-sync: Claude Code setup

After syncing, in your project run /emt-brain-help setup-project in Claude Code to:

1. Initialize CLAUDE.md (if absent)
2. Add horizontal-protocol guidelines (IDEA-001 four-pillar session protocol)
3. Add workflow-usage guidelines for each installed workflow