codexmgr 0.1.3__tar.gz → 0.2.0__tar.gz

{codexmgr-0.1.3 → codexmgr-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexmgr
-Version: 0.1.3
+Version: 0.2.0
 Summary: Manage project-local Codex configuration from reusable templates
 Keywords: agents,cli,codex,configuration,skills
 Classifier: Development Status :: 4 - Beta
@@ -34,7 +34,9 @@ The tool is intentionally narrow:
 - compose reusable AGENTS.md instruction fragments
 - enable or disable Codex skills per project
 - enable or disable reusable Codex hook bundles per project
-- enable or disable packaged sets of AGENTS.md, skill, and hook settings
+- enable or disable project custom agents from reusable TOML files
+- enable or disable reusable rule files copied into project-local `.rules/`
+- enable or disable packaged sets of AGENTS.md, agent, skill, hook, and rule settings
 - enable, disable, inspect, and update safe project-local MCP overrides
 - use an interactive terminal UI for common project management tasks
 - write reproducible lock data for the resolved project configuration
@@ -100,14 +102,16 @@ This updates `.codex/codexmgr.toml`, runs `apply`, writes
 
 - `.codex/codexmgr.toml`: source configuration edited by CLI commands or by
   hand
-- `.codex/codexmgr.lock`: resolved template, skill, hook, and MCP state written by
-  `apply`
+- `.codex/codexmgr.lock`: resolved template, agent, skill, hook, and MCP state
+  written by `apply`
 - `.codex/config.toml`: Codex config updated with `[[skills.config]]` entries
   and `[mcp_servers.<id>]` overrides
 - `.codex/hooks.json`: Codex hook config updated with enabled reusable hook
   bundles while preserving unmanaged local hooks
 - `.codex/hooks/<name>`: project-local copies of enabled hook bundle support
   files
+- `.codex/agents/<name>.toml`: project-local copies of enabled custom agents
+- `.rules/<path>`: project-local copies of enabled reusable rule files
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -122,8 +126,8 @@ Manual content outside this block is preserved. If the block is missing,
 
 ## Project Configuration
 
-`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, hook state, and MCP
-overrides:
+`.codex/codexmgr.toml` supports AGENTS.md templates, custom-agent state, skill
+state, hook state, and MCP overrides:
 
 ```toml
 [agents_md]
@@ -133,10 +137,18 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[agents]
+enabled = ["rule-retriever"]
+disabled = ["experimental-agent"]
+
 [hooks]
 enabled = ["repo-rules"]
 disabled = ["experimental-hook"]
 
+[rules]
+enabled = ["react/", "python/testing.md"]
+disabled = ["react/materials/"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -155,33 +167,49 @@ Path-like skill values resolve to either a `SKILL.md` file or a directory
 containing `SKILL.md`. Missing skills are written as name-based entries so Codex
 can resolve them later.
 
+Named custom agents resolve from `$CODEXMGR_HOME/agents/<name>.toml`. Enabled
+agents are copied into `.codex/agents/<name>.toml` on every apply. Disabled
+agents remove their managed copy only when the lock records the file as
+codexmgr-managed.
+
 Named hooks resolve from `$CODEXMGR_HOME/hooks/<name>/hooks.json`. Enabled hook
 bundles are merged into `.codex/hooks.json` on every apply with
 `codexmanager_meta` added to each managed handler. Existing unmanaged hooks are
 preserved. Bundle files other than the root `hooks.json` are copied into
 `.codex/hooks/<name>`.
 
+Rule refs resolve under `$CODEXMGR_HOME/rules/` and are POSIX-style relative
+paths. Folder refs are stored with a trailing slash and copy all regular files
+recursively into `.rules/` while preserving relative paths. File refs copy one
+file. Extensionless refs prefer an existing `<ref>.md`. Enabled refs expand
+first, then disabled file or folder refs remove entries from that candidate set.
+First-time applies refuse to overwrite unmanaged `.rules/...` files.
+
 Packaged configurations resolve from
 `$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
-document that can contain root `agentsmd`, `hooks`, and `skills` string lists
-plus optional profile tables:
+document that can contain root `agentsmd`, `agents`, `hooks`, `skills`, and `rules`
+string lists plus optional profile tables:
 
 ```toml
 agentsmd = []
+agents = ["rule-retriever"]
 hooks = ["repo-rules"]
 skills = ["repo-rule-manager"]
+rules = ["react/"]
 
 [profiles.strict]
 agentsmd = ["strict-coding"]
+agents = ["strict-agent"]
 hooks = ["strict-rules"]
 skills = ["strict-review"]
+rules = ["python/testing.md"]
 ```
 
 `codexmgr package enable <name>` validates package AGENTS.md and hook
 references, then updates `.codex/codexmgr.toml` as if the corresponding
 `agentsmd add`, `hooks enable`, and `skill enable` commands had been run.
 `codexmgr package disable <name>` removes package AGENTS.md entries when
-present and disables the package skills and hooks.
+present and disables the package skills, hooks, agents, and rules.
 
 Package profiles are merged with the root package entries:
 
@@ -205,10 +233,13 @@ unless `--no-sync` was explicitly requested.
 ## Interactive TUI
 
 `codexmgr tui` opens a Textual-based terminal UI for managing project-local
-configuration. It shows AGENTS.md templates, skills, hooks, packages, and MCP
-server enable overrides in selectable lists. Changes are staged in memory while
-you navigate and toggle entries. Press `s` to save; the save writes
-`.codex/codexmgr.toml` once and runs `apply` once unless `--no-sync` was used.
+configuration. It shows AGENTS.md templates, skills, hooks, custom agents,
+rules, packages, and MCP server enable overrides in selectable lists. Changes are
+staged in memory while you navigate and toggle entries. Press `s` to save; the
+save writes `.codex/codexmgr.toml` once and runs `apply` once unless
+`--no-sync` was used.
+For resources with explicit enable and disable lists, `space` cycles the
+highlighted row through available, enabled, and disabled states.
 Package profiles appear as separate selectable rows under their package.
 
 ```bash
@@ -270,9 +301,15 @@ codexmgr init-template agentsmd <name>
 codexmgr skill list
 codexmgr skill enable [--no-sync] <name-or-skill-path> [...]
 codexmgr skill disable [--no-sync] <name-or-skill-path> [...]
+codexmgr agents list
+codexmgr agents enable [--no-sync] <agent-name> [...]
+codexmgr agents disable [--no-sync] <agent-name> [...]
 codexmgr hooks list
 codexmgr hooks enable [--no-sync] <hook-name> [...]
 codexmgr hooks disable [--no-sync] <hook-name> [...]
+codexmgr rules list
+codexmgr rules enable [--no-sync] <rule-ref> [...]
+codexmgr rules disable [--no-sync] <rule-ref> [...]
 codexmgr package list
 codexmgr package enable [--no-sync] <package-name> [...] [--profile <name> [...]]
 codexmgr package disable [--no-sync] <package-name> [...] [--profile <name> [...]]
@@ -294,8 +331,10 @@ codexmgr codex <args...>
 
 `apply` reads `.codex/codexmgr.toml`, resolves configured sources, writes
 `.codex/codexmgr.lock`, updates `.codex/config.toml` skill entries when a
-`[skills]` table is configured, writes `.codex/hooks.json` when `[hooks]` is
-configured, writes local `[mcp_servers.<id>]` overrides when `[mcp]` is
+`[skills]` table is configured, copies `.codex/agents/<name>.toml` files when
+`[agents]` is configured, writes `.codex/hooks.json` when `[hooks]` is
+configured, copies `.rules/<path>` files when `[rules]` is configured, writes
+local `[mcp_servers.<id>]` overrides when `[mcp]` is
 configured, and refreshes the generated `AGENTS.md` block when `[agents_md]` is
 configured.
 
@@ -309,11 +348,11 @@ the directory in a file explorer, and `codexmgr cd --terminal` to open a new
 terminal there.
 
 `doctor` checks project setup, home environment variables, project TOML syntax,
-referenced snippets, enabled skills, enabled hook bundles, and stale generated
-files.
+referenced snippets, enabled skills, enabled custom agents, enabled hook
+bundles, enabled rules, and stale generated files.
 
-`status` prints the resolved homes, configured snippets, skills, hooks, and
-whether generated files are in sync.
+`status` prints the resolved homes, configured snippets, skills, custom agents,
+hooks, rules, and whether generated files are in sync.
 
 `codexmgr codex` can run with a just-in-time package/profile overlay without
 changing `.codex/codexmgr.toml`. Put Codex arguments after `--` when using this
@@ -413,13 +452,21 @@ marks configured hook bundles as enabled, disabled, or missing.
 config. `hooks enable` and `hooks disable` keep enabled and disabled lists
 mutually exclusive. Repeated commands keep one entry.
 
+`rules list` prints available `$CODEXMGR_HOME/rules/**` files and folders and
+marks configured rule refs as enabled, disabled, or missing.
+
+`rules enable` validates and canonicalizes refs before writing config.
+`rules disable` canonicalizes existing refs and permits missing exclusions.
+Enabled and disabled lists are exact-ref mutually exclusive, so parent enables
+and child disables can intentionally coexist.
+
 `package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
 entries in sorted order.
 
-`package enable` and `package disable` proxy to existing AGENTS.md, skill, and
-hook project-config mutations. Package state is not tracked separately; the
-resulting `[agents_md]`, `[skills]`, and `[hooks]` tables remain the source of
-truth.
+`package enable` and `package disable` proxy to existing AGENTS.md, custom-agent,
+skill, hook, and rule project-config mutations. Package state is not tracked
+separately; the resulting `[agents_md]`, `[agents]`, `[skills]`, `[hooks]`, and `[rules]`
+tables remain the source of truth.
 
 `codex` forwards arguments to the real `codex` command. Values from
 `.codex/config.toml` are flattened into `-c key=value` overrides. User-provided

{codexmgr-0.1.3 → codexmgr-0.2.0}/README.md

@@ -11,7 +11,9 @@ The tool is intentionally narrow:
 - compose reusable AGENTS.md instruction fragments
 - enable or disable Codex skills per project
 - enable or disable reusable Codex hook bundles per project
-- enable or disable packaged sets of AGENTS.md, skill, and hook settings
+- enable or disable project custom agents from reusable TOML files
+- enable or disable reusable rule files copied into project-local `.rules/`
+- enable or disable packaged sets of AGENTS.md, agent, skill, hook, and rule settings
 - enable, disable, inspect, and update safe project-local MCP overrides
 - use an interactive terminal UI for common project management tasks
 - write reproducible lock data for the resolved project configuration
@@ -77,14 +79,16 @@ This updates `.codex/codexmgr.toml`, runs `apply`, writes
 
 - `.codex/codexmgr.toml`: source configuration edited by CLI commands or by
   hand
-- `.codex/codexmgr.lock`: resolved template, skill, hook, and MCP state written by
-  `apply`
+- `.codex/codexmgr.lock`: resolved template, agent, skill, hook, and MCP state
+  written by `apply`
 - `.codex/config.toml`: Codex config updated with `[[skills.config]]` entries
   and `[mcp_servers.<id>]` overrides
 - `.codex/hooks.json`: Codex hook config updated with enabled reusable hook
   bundles while preserving unmanaged local hooks
 - `.codex/hooks/<name>`: project-local copies of enabled hook bundle support
   files
+- `.codex/agents/<name>.toml`: project-local copies of enabled custom agents
+- `.rules/<path>`: project-local copies of enabled reusable rule files
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -99,8 +103,8 @@ Manual content outside this block is preserved. If the block is missing,
 
 ## Project Configuration
 
-`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, hook state, and MCP
-overrides:
+`.codex/codexmgr.toml` supports AGENTS.md templates, custom-agent state, skill
+state, hook state, and MCP overrides:
 
 ```toml
 [agents_md]
@@ -110,10 +114,18 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[agents]
+enabled = ["rule-retriever"]
+disabled = ["experimental-agent"]
+
 [hooks]
 enabled = ["repo-rules"]
 disabled = ["experimental-hook"]
 
+[rules]
+enabled = ["react/", "python/testing.md"]
+disabled = ["react/materials/"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -132,33 +144,49 @@ Path-like skill values resolve to either a `SKILL.md` file or a directory
 containing `SKILL.md`. Missing skills are written as name-based entries so Codex
 can resolve them later.
 
+Named custom agents resolve from `$CODEXMGR_HOME/agents/<name>.toml`. Enabled
+agents are copied into `.codex/agents/<name>.toml` on every apply. Disabled
+agents remove their managed copy only when the lock records the file as
+codexmgr-managed.
+
 Named hooks resolve from `$CODEXMGR_HOME/hooks/<name>/hooks.json`. Enabled hook
 bundles are merged into `.codex/hooks.json` on every apply with
 `codexmanager_meta` added to each managed handler. Existing unmanaged hooks are
 preserved. Bundle files other than the root `hooks.json` are copied into
 `.codex/hooks/<name>`.
 
+Rule refs resolve under `$CODEXMGR_HOME/rules/` and are POSIX-style relative
+paths. Folder refs are stored with a trailing slash and copy all regular files
+recursively into `.rules/` while preserving relative paths. File refs copy one
+file. Extensionless refs prefer an existing `<ref>.md`. Enabled refs expand
+first, then disabled file or folder refs remove entries from that candidate set.
+First-time applies refuse to overwrite unmanaged `.rules/...` files.
+
 Packaged configurations resolve from
 `$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
-document that can contain root `agentsmd`, `hooks`, and `skills` string lists
-plus optional profile tables:
+document that can contain root `agentsmd`, `agents`, `hooks`, `skills`, and `rules`
+string lists plus optional profile tables:
 
 ```toml
 agentsmd = []
+agents = ["rule-retriever"]
 hooks = ["repo-rules"]
 skills = ["repo-rule-manager"]
+rules = ["react/"]
 
 [profiles.strict]
 agentsmd = ["strict-coding"]
+agents = ["strict-agent"]
 hooks = ["strict-rules"]
 skills = ["strict-review"]
+rules = ["python/testing.md"]
 ```
 
 `codexmgr package enable <name>` validates package AGENTS.md and hook
 references, then updates `.codex/codexmgr.toml` as if the corresponding
 `agentsmd add`, `hooks enable`, and `skill enable` commands had been run.
 `codexmgr package disable <name>` removes package AGENTS.md entries when
-present and disables the package skills and hooks.
+present and disables the package skills, hooks, agents, and rules.
 
 Package profiles are merged with the root package entries:
 
@@ -182,10 +210,13 @@ unless `--no-sync` was explicitly requested.
 ## Interactive TUI
 
 `codexmgr tui` opens a Textual-based terminal UI for managing project-local
-configuration. It shows AGENTS.md templates, skills, hooks, packages, and MCP
-server enable overrides in selectable lists. Changes are staged in memory while
-you navigate and toggle entries. Press `s` to save; the save writes
-`.codex/codexmgr.toml` once and runs `apply` once unless `--no-sync` was used.
+configuration. It shows AGENTS.md templates, skills, hooks, custom agents,
+rules, packages, and MCP server enable overrides in selectable lists. Changes are
+staged in memory while you navigate and toggle entries. Press `s` to save; the
+save writes `.codex/codexmgr.toml` once and runs `apply` once unless
+`--no-sync` was used.
+For resources with explicit enable and disable lists, `space` cycles the
+highlighted row through available, enabled, and disabled states.
 Package profiles appear as separate selectable rows under their package.
 
 ```bash
@@ -247,9 +278,15 @@ codexmgr init-template agentsmd <name>
 codexmgr skill list
 codexmgr skill enable [--no-sync] <name-or-skill-path> [...]
 codexmgr skill disable [--no-sync] <name-or-skill-path> [...]
+codexmgr agents list
+codexmgr agents enable [--no-sync] <agent-name> [...]
+codexmgr agents disable [--no-sync] <agent-name> [...]
 codexmgr hooks list
 codexmgr hooks enable [--no-sync] <hook-name> [...]
 codexmgr hooks disable [--no-sync] <hook-name> [...]
+codexmgr rules list
+codexmgr rules enable [--no-sync] <rule-ref> [...]
+codexmgr rules disable [--no-sync] <rule-ref> [...]
 codexmgr package list
 codexmgr package enable [--no-sync] <package-name> [...] [--profile <name> [...]]
 codexmgr package disable [--no-sync] <package-name> [...] [--profile <name> [...]]
@@ -271,8 +308,10 @@ codexmgr codex <args...>
 
 `apply` reads `.codex/codexmgr.toml`, resolves configured sources, writes
 `.codex/codexmgr.lock`, updates `.codex/config.toml` skill entries when a
-`[skills]` table is configured, writes `.codex/hooks.json` when `[hooks]` is
-configured, writes local `[mcp_servers.<id>]` overrides when `[mcp]` is
+`[skills]` table is configured, copies `.codex/agents/<name>.toml` files when
+`[agents]` is configured, writes `.codex/hooks.json` when `[hooks]` is
+configured, copies `.rules/<path>` files when `[rules]` is configured, writes
+local `[mcp_servers.<id>]` overrides when `[mcp]` is
 configured, and refreshes the generated `AGENTS.md` block when `[agents_md]` is
 configured.
 
@@ -286,11 +325,11 @@ the directory in a file explorer, and `codexmgr cd --terminal` to open a new
 terminal there.
 
 `doctor` checks project setup, home environment variables, project TOML syntax,
-referenced snippets, enabled skills, enabled hook bundles, and stale generated
-files.
+referenced snippets, enabled skills, enabled custom agents, enabled hook
+bundles, enabled rules, and stale generated files.
 
-`status` prints the resolved homes, configured snippets, skills, hooks, and
-whether generated files are in sync.
+`status` prints the resolved homes, configured snippets, skills, custom agents,
+hooks, rules, and whether generated files are in sync.
 
 `codexmgr codex` can run with a just-in-time package/profile overlay without
 changing `.codex/codexmgr.toml`. Put Codex arguments after `--` when using this
@@ -390,13 +429,21 @@ marks configured hook bundles as enabled, disabled, or missing.
 config. `hooks enable` and `hooks disable` keep enabled and disabled lists
 mutually exclusive. Repeated commands keep one entry.
 
+`rules list` prints available `$CODEXMGR_HOME/rules/**` files and folders and
+marks configured rule refs as enabled, disabled, or missing.
+
+`rules enable` validates and canonicalizes refs before writing config.
+`rules disable` canonicalizes existing refs and permits missing exclusions.
+Enabled and disabled lists are exact-ref mutually exclusive, so parent enables
+and child disables can intentionally coexist.
+
 `package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
 entries in sorted order.
 
-`package enable` and `package disable` proxy to existing AGENTS.md, skill, and
-hook project-config mutations. Package state is not tracked separately; the
-resulting `[agents_md]`, `[skills]`, and `[hooks]` tables remain the source of
-truth.
+`package enable` and `package disable` proxy to existing AGENTS.md, custom-agent,
+skill, hook, and rule project-config mutations. Package state is not tracked
+separately; the resulting `[agents_md]`, `[agents]`, `[skills]`, `[hooks]`, and `[rules]`
+tables remain the source of truth.
 
 `codex` forwards arguments to the real `codex` command. Values from
 `.codex/config.toml` are flattened into `-c key=value` overrides. User-provided

{codexmgr-0.1.3 → codexmgr-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codexmgr"
-version = "0.1.3"
+version = "0.2.0"
 description = "Manage project-local Codex configuration from reusable templates"
 readme = "README.md"
 requires-python = ">=3.11"

{codexmgr-0.1.3 → codexmgr-0.2.0}/src/codexmgr/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.3"
+__version__ = "0.2.0"

{codexmgr-0.1.3 → codexmgr-0.2.0}/src/codexmgr/commands/codex_jit.py

@@ -82,7 +82,7 @@ def build_jit_project_state(
             codexmgr_home,
             request.profiles,
         )
-        apply_package_entries_to_config(overlay, entries, enabled=True)
+        apply_package_entries_to_config(overlay, entries, codexmgr_home, enabled=True)
     return build_project_state_from_config(overlay, cwd, codex_home, codexmgr_home)
 
 
@@ -205,7 +205,26 @@ def _state_paths(state: ProjectBuild) -> list[Path]:
         *(generated_file.path for generated_file in state.files),
         *(skill_copy.target for skill_copy in state.skill_copies),
         *(hook_copy.target for hook_copy in state.hook_copies),
+        *(agent_copy.target for agent_copy in state.agent_copies),
+        *(_rule_root(rule_copy.target) for rule_copy in state.rule_copies),
         *state.obsolete_file_targets,
         *state.obsolete_skill_copy_targets,
         *state.obsolete_hook_copy_targets,
+        *state.obsolete_agent_copy_targets,
+        *(_rule_root(target) for target in state.obsolete_rule_copy_targets),
     ]
+
+
+def _rule_root(path: Path) -> Path:
+    """Return the `.rules` ancestor for a rule file path.
+
+    Args:
+        path: Rule copy path or obsolete rule target.
+
+    Returns:
+        The nearest `.rules` ancestor, or the original path when absent.
+    """
+    for parent in [path, *path.parents]:
+        if parent.name == ".rules":
+            return parent
+    return path

{codexmgr-0.1.3 → codexmgr-0.2.0}/src/codexmgr/commands/health.py

@@ -7,9 +7,11 @@ from typing import TextIO
 from ..agents.manager import resolve_locked_agents_md
 from ..core.errors import CommandError
 from ..core.paths import project_codex_dir
+from ..custom_agents.listing import configured_agent_lists, missing_enabled_agents
 from ..project.config import agents_md_sources, load_required_project_config
 from ..project.sync import generated_file_diffs
 from ..hooks.listing import configured_hook_lists, missing_enabled_hooks
+from ..rules.listing import configured_rule_lists, missing_enabled_rules
 from ..skills.listing import configured_skill_lists, missing_enabled_skills
 
 
@@ -33,6 +35,8 @@ def run_status(
     config = load_required_project_config(cwd)
     enabled, disabled = configured_skill_lists(cwd)
     enabled_hooks, disabled_hooks = configured_hook_lists(cwd)
+    enabled_agents, disabled_agents = configured_agent_lists(cwd)
+    enabled_rules, disabled_rules = configured_rule_lists(cwd)
     diffs = generated_file_diffs(cwd, codex_home, codexmgr_home)
     lines = [
         f"Project: {cwd}",
@@ -43,6 +47,10 @@ def run_status(
         f"Disabled skills: {_format_values(disabled)}",
         f"Enabled hooks: {_format_values(enabled_hooks)}",
         f"Disabled hooks: {_format_values(disabled_hooks)}",
+        f"Enabled agents: {_format_values(enabled_agents)}",
+        f"Disabled agents: {_format_values(disabled_agents)}",
+        f"Enabled rules: {_format_values(enabled_rules)}",
+        f"Disabled rules: {_format_values(disabled_rules)}",
         f"Generated files: {_sync_state(diffs)}",
     ]
     lines.extend(f"  {diff.relative_path}" for diff in diffs)
@@ -81,6 +89,8 @@ def run_doctor(
     _check_agents_sources(config, cwd, codexmgr_home, report)
     _check_missing_enabled_skills(cwd, codex_home, codexmgr_home, report)
     _check_missing_enabled_hooks(cwd, codexmgr_home, report)
+    _check_missing_enabled_agents(cwd, codexmgr_home, report)
+    _check_missing_enabled_rules(cwd, codexmgr_home, report)
     _check_generated_files(cwd, codex_home, codexmgr_home, report)
 
     has_errors = any(line.startswith("ERROR ") for line in report)
@@ -188,6 +198,44 @@ def _check_missing_enabled_hooks(
         report.append(f"ERROR Missing enabled hook: {hook}")
 
 
+def _check_missing_enabled_agents(
+    cwd: Path,
+    codexmgr_home: Path,
+    report: list[str],
+) -> None:
+    """Check that enabled custom-agent references resolve.
+
+    Args:
+        cwd: Project directory whose configured custom agents should be checked.
+        codexmgr_home: codexmgr home used to resolve custom-agent sources.
+        report: Mutable diagnostic report receiving any error.
+
+    Returns:
+        None.
+    """
+    for agent in missing_enabled_agents(cwd, codexmgr_home):
+        report.append(f"ERROR Missing enabled agent: {agent}")
+
+
+def _check_missing_enabled_rules(
+    cwd: Path,
+    codexmgr_home: Path,
+    report: list[str],
+) -> None:
+    """Check that enabled reusable rule references resolve.
+
+    Args:
+        cwd: Project directory whose configured rules should be checked.
+        codexmgr_home: codexmgr home used to resolve reusable rules.
+        report: Mutable diagnostic report receiving any error.
+
+    Returns:
+        None.
+    """
+    for rule in missing_enabled_rules(cwd, codexmgr_home):
+        report.append(f"ERROR Missing enabled rule: {rule}")
+
+
 def _check_generated_files(
     cwd: Path,
     codex_home: Path,

codexmgr-0.2.0/src/codexmgr/commands/rules.py

@@ -0,0 +1,115 @@
+"""CLI helpers for reusable rule management commands."""
+
+import argparse
+from pathlib import Path
+from typing import TextIO
+
+from ..core.paths import config_path
+from ..core.toml_io import load_optional_toml_file, write_toml_file
+from ..project.apply import apply_project_config
+from ..project.config import require_codex_dir
+from ..rules.config import set_rule_state_in_config
+from ..rules.listing import rule_list_lines
+
+
+def run_rules_command(
+    args: argparse.Namespace,
+    cwd: Path,
+    codex_home: Path,
+    codexmgr_home: Path,
+    stdout: TextIO,
+) -> int:
+    """Run a parsed rules command.
+
+    Args:
+        args: Parsed rules command namespace.
+        cwd: Project directory for project-local operations.
+        codex_home: Codex home used by apply.
+        codexmgr_home: Codexmgr home containing source rules.
+        stdout: Stream for command output.
+
+    Returns:
+        A process-style exit code.
+    """
+    if args.rules_command == "list":
+        _write_optional_lines(stdout, rule_list_lines(cwd, codexmgr_home))
+        return 0
+    enabled = args.rules_command == "enable"
+    rules = _set_rule_many(args.rules, cwd, codexmgr_home, enabled=enabled)
+    verb = "Enabled" if enabled else "Disabled"
+    return _finish_config_change(
+        [f"{verb} {rule}" for rule in rules],
+        args.no_sync,
+        cwd,
+        codex_home,
+        codexmgr_home,
+        stdout,
+    )
+
+
+def _set_rule_many(
+    rules: list[str],
+    cwd: Path,
+    codexmgr_home: Path,
+    *,
+    enabled: bool,
+) -> list[str]:
+    """Set multiple rule states with one config write.
+
+    Args:
+        rules: Rule refs to update.
+        cwd: Project directory whose codexmgr.toml should be updated.
+        codexmgr_home: Codexmgr home containing source rules.
+        enabled: Desired rule state.
+
+    Returns:
+        Canonical rule refs that were updated.
+    """
+    require_codex_dir(cwd)
+    config = load_optional_toml_file(config_path(cwd))
+    updated = [
+        set_rule_state_in_config(config, rule, codexmgr_home, enabled=enabled)
+        for rule in rules
+    ]
+    write_toml_file(config_path(cwd), config)
+    return updated
+
+
+def _finish_config_change(
+    messages: list[str],
+    no_sync: bool,
+    cwd: Path,
+    codex_home: Path,
+    codexmgr_home: Path,
+    stdout: TextIO,
+) -> int:
+    """Apply generated files after a rules mutation unless opted out.
+
+    Args:
+        messages: Command-specific success messages.
+        no_sync: Whether to skip automatic apply.
+        cwd: Project directory whose configuration changed.
+        codex_home: Codex home for apply.
+        codexmgr_home: Codexmgr home for apply.
+        stdout: Stream for command output.
+
+    Returns:
+        Zero when mutation and optional apply succeed.
+    """
+    output = list(messages)
+    if not no_sync:
+        apply_project_config(cwd, codex_home, codexmgr_home)
+        output.append("Applied project Codex configuration")
+    stdout.write("\n".join(output) + "\n")
+    return 0
+
+
+def _write_optional_lines(stdout: TextIO, lines: list[str]) -> None:
+    """Write lines only when present.
+
+    Args:
+        stdout: Stream for command output.
+        lines: Lines to write.
+    """
+    if lines:
+        stdout.write("\n".join(lines) + "\n")

codexmgr-0.2.0/src/codexmgr/custom_agents/__init__.py

@@ -0,0 +1 @@
+"""Manage project-local Codex custom-agent files."""