Intelligent-Internet / Intelligent-Internet/zenith

Add user-scoped setup for Claude Code and Codex

Open
#22 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
306
Forks
46
Avg merge
2m
Merged PRs (30d)
2

Description

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.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the existing zenith init entry point and trace how project-scoped MCP configuration, prompts, agents, and skills are staged for Claude and Codex. Add an explicit user scope while retaining project scope as the default, honoring the named environment paths and preserving unrelated settings. Done means both hosts can be installed in either order, repeated setup is idempotent, and Hermes remains project-scoped.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.