Skip to content

Add user-scoped setup for Claude Code and Codex #22

Description

@apodgaiko

Problem

zenith init currently stages MCP configuration, prompts, agents, and skills inside one target workspace. Users who want Zenith across many workspaces must repeat initialization and restart each host for every workspace.

Proposal

Add an explicit user-scoped setup mode:

uv run zenith init --scope user --agent claude
uv run zenith init --scope user --agent codex

The existing project-scoped behavior remains the default for compatibility.

User scope registers the host's user-level MCP server and managed Zenith assets, honors CLAUDE_CONFIG_DIR and CODEX_HOME, preserves unrelated user configuration, and never selects or overwrites model/reasoning/sandbox/feature preferences or persists ambient API/model environment variables. It is idempotent and supports installing both hosts in either order.

Hermes retains project scope until its authoritative user-scope paths are established.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions